Configuring the IBM MobileFirst Platform Server location

You can configure the MobileFirst Server location by specifying configuration properties.

In production, you must configure your server location in the following circumstances:

  • You are using relative path for the onLoginUrl parameter in the authenticationConfig.xml file.
  • You are generating the URL for mobile web and desktop browser apps from the console.

In most cases, production servers sit behind a reverse proxy; therefore, their machine IP address (which is the default value of publicWorkLightHostname) is not used for accessing them from the outside world.

To configure the MobileFirst Server location, set the values of the following properties:

Table 1. MobileFirst Server location properties
Property name Description
publicWorkLightHostname The IP address or host name of the computer running IBM MobileFirst™ Platform Foundation.

If the MobileFirst Server is behind a reverse proxy, the value is the IP address or host name of the reverse proxy.

This property must be identical for nodes within the same cluster.

Default: IP address of current server.

publicWorkLightPort The port for accessing the MobileFirst Server.

If the MobileFirst Server is behind a reverse proxy, the value is the port for accessing the reverse proxy.

This property must be identical for nodes within the same cluster.

Default: 10080.

The <configureApplicationServer> Ant task sets a default value that depends on the application server.

publicWorkLightProtocol The protocol for accessing the MobileFirst Server.

The valid values are HTTP and HTTPS. If the MobileFirst Server is behind a reverse proxy, the value is the protocol for accessing the reverse proxy.

This property must be identical for nodes within the same cluster.

Default: HTTP.

The <configureApplicationServer> Ant task sets a default value that depends on the application server.

For descriptions of other configuration properties, see JNDI environment entries for MobileFirst projects in production.

For information about how to specify configuration properties, see Configuration of MobileFirst applications on the server.