For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.
MobileFirst Server push service configuration details
The push service is packaged as a WAR application for us to deploy to a Liberty collective cluster member or to a Liberty server.
If you install the push service in a Liberty server, see MobileFirst Server push service configuration details under Manual installation on WebSphere Application Server Liberty.
When the MobileFirst Server push service is installed in a Liberty collective, it can be installed in the same cluster than the runtime or in another cluster.
We need to make some specific configurations for this application in the server.xml file of every Liberty collective cluster member.
Before proceeding, review Manual installation on WebSphere Application Server Liberty collective for the configuration details that are common to all services.
The push service WAR file is in mfp_install_dir/PushService/mfp-push-service.war.
You must define the context root as /imfpush. Otherwise, the client devices cannot connect to it as the context root is hardcoded in the SDK.
Mandatory JNDI properties
When we define the JNDI properties, the JNDI names must be prefixed with the context root of the push service. The following example illustrates the case to declare mfp.push.analytics.user whereby the push service is installed with /imfpush as the context root:
<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>
We need to define the following properties:
- mfp.push.authorization.server.url
- mfp.push.authorization.client.id
- mfp.push.authorization.client.secret
- mfp.push.services.ext.security - the value must be com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin.
- mfp.push.db.type - for a relational database, the value must be DB.
If MobileFirst Analytics is configured, define the following JNDI properties:
- mfp.push.analytics.endpoint
- mfp.analytics.username
- mfp.analytics.password
- mfp.push.services.ext.analytics - the value must be com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin.
For more information about the JNDI properties, see List of JNDI properties for MobileFirst Server push service.
Data source
The JNDI name of the data source for the push service must be defined as jndiName=imfpush/jdbc/imfPushDS.
Parent topic: Manual installation on WebSphere Application Server Liberty collective