For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.


Manual installation on WebSphere Application Server and WebSphere Application Server Network Deployment

Find out more details on how to install the MobileFirst Server components on WebSphere® Application Server and WebSphere Application Server Network Deployment.

Make sure that you have fulfilled the requirements as documented in WebSphere Application Server and WebSphere Application Server Network Deployment prerequisites.


Topology constraints

On a stand-alone WebSphere Application Server
The MobileFirst Server administration service, the MobileFirst Server live update service, and the MobileFirst runtime must be installed on the same application server. The context root of the live update service must be defined as <adminContextRoot>config. The context root of the push service must be imfpush. For more information about the constraints, see Constraints on the MobileFirst Server components and MobileFirst Analytics.
On WebSphere Application Server Network Deployment
The deployment manager must be running while MobileFirst Server is running. The deployment manager is used for the JMX communication between the runtime and the administration service. The administration service and the live update service must be installed on the same application server. The runtime can be installed on different servers than the administration service, but it must be on the same cell.


Application server settings

The administrative security and the application security must be enabled. We can enable the application security in the WebSphere Application Server administration console:

  1. Log in to the WebSphere Application Server administration console.
  2. Click Security > Global Security. Ensure that Enable administrative security is selected.
  3. Also, ensure that Enable application security is selected. The application security can be enabled only if administrative security is enabled.
  4. Click OK.
  5. Save the changes.
For more information, see Enabling security in WebSphere Application Server documentation.

The server class loader policy must support parent last delegation. The MobileFirst Server WAR files must be installed with parent last class loader mode. Review the class-loader policy:

  1. Log in to the WebSphere Application Server administration console.
  2. Click Servers > Server Types > WebSphere application servers, and click on the server that is used for IBM MobileFirst Platform Foundation.
  3. If the class-loader policy is set to Multiple, do nothing.
  4. If the class-loader policy is set to Single and the class loading mode is set to Classes loaded with local class loader first (parent last), do nothing.
  5. If the class-loader policy is set to Single and the class loading mode is set to Classes loaded with parent class loader first (parent first), change the class-loader policy to Multiple. Also, set the class loader order of all applications other than MobileFirst Server applications to Classes loaded with parent class loader first (parent first).


Class loader

For all MobileFirst Server applications, the class loader must have the parent last delegation.

To set the class loader delegation to parent last after an application is installed, follow these steps:

  1. Click the Manage Applications link, or click Applications > Application Types > WebSphere entreprise applications.
  2. Click the MobileFirst Server application. By default the name of the application is the name of the WAR file.
  3. In the Detail Properties section, click the Class loading and update detection link.
  4. In the Class loader order pane, select the Classes loaded with local class loader first (parent last) option.
  5. Click OK.
  6. In the Modules section, click the Manage Modules link.
  7. Click the module.
  8. For the Class loader order field, select the Classes loaded with local class loader first (parent last) option.
  9. Click OK twice to confirm the selection and back to the Configuration panel of the application.
  10. Click Save to persist the changes.

Parent topic: Installing the MobileFirst Server components manually