Setting Up Application Properties

The Application instance contains the information and authentication credentials needed to register and connect to the Unwired Server.

The following code illustrates how to set up the minimum required fields:

// Initialize Application settings
Application app = Application.GetInstance();

// The identifier has to match the application ID deployed to the Unwired Server
app.ApplicationIdentifier = "SMP101";

// ConnectionProperties has the information needed to register
// and connect to Unwired Server
ConnectionProperties connProps = app.ConnectionProperties;
connProps.ServerName = "server.mycompany.com";
// if you are using relay server, then use the correct port number for the relay server
// if connecting using http without a relay server, use the messaging administration port, by default 5001.
// if connecting using https without a relay server, then use a new port for https, for example 9001.
connProps.PortNumber = 5001;
// if connecting using https, set the network protocol
connProps.NetworkProtocol = "https"; 

// Set FarmId and UrlSuffix when connecting through the Relay Server. 

// Provide user credentials
LoginCredentials loginCred = new LoginCredentials("supAdmin", "supPwd");
connProps.LoginCredentials = loginCred;

// Initialize generated package database class with this Application instance
SMP101DB.SetApplication(app);

If you are using a Relay Server, specify the connection as follows:

// specify Relay Server Host
connProps.ServerName = "relayserver.mycompany.com";
// specify Relay Server Port (port 80 by default)
connProps.PortNumber = 80;
// specify the Relay Server MBS Farm, for example MBS_Farm
connProps.FarmId = "MBS_FARM";

Optionally, you can specify the Relay Server URL suffix.

Using a Reverse Proxy for Object API applications

The Object API application communicates with Unwired Server through two ports:

Application registration (default 5001)
Application synchronization (default 2480)

The Unwired Server Administrator configures two ports with each port serving one Unwired Server port, so that:

The root context of http://reverseProxy:5001 maps to http://server-name:5001
The root context of http://reverseProxy:2480 maps to http://server-name:2480

Set Object API application connection properties just as you would to directly connect to Unwired Server.

The Unwired Server Administrator configures two contexts for one Unwired Server port, so that:

The "/smp/message" context of http://reverseProxy:8080 maps to http://server-name:5001
The "/smp/mobilink" context of http://reverseProxy:8080 maps to http://server-name:2480

Set the URL suffix for the Object API application to "/smp/message" for registering applications and "/smp/mobilink" for synchronization, just as you would if connecting to Unwired Server through a Relay Server which is not installed at the default location. The difference is that you do not include a FarmId for the reverse proxy.

Note: When using an Apache server as a reverse proxy without Sybase Hosted Relay Server to proxy Object API Applications against Unwired Server, if a custom URL suffix is used, clients should specify a custom URL suffix including a trailing forward slash "/". For example, "/myApp/" instead of "/myApp". If not, the client may report connection failures.