MobileFirst Server push service configuration details

The push service is packaged as a WAR application for you 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.

You need to make some specific configurations for this application in the server.xml file of every Liberty collective cluster member.

Before you proceed, 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 you 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"/>

You 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.