Migrating from the IBM Mobile First Platform

Overview

Follow this tutorial for a full-fledged migration to the Persistent Mobile Foundation Version 9.0.x for different Application server and Database combinations. Below scenarios explain the detailed steps for migration of your setups.

Migration scenarios

Jump to

• You want to migrate a setup with WebSphere® Application Server (WAS) and Oracle database
• You want to migrate a setup with WebSphere Application Server Network Deployment (WAS-ND) and Oracle database

Note: The above procedure may vary depending on the infrastructure/topology of the installation environment and might need some changes after analysis of customer setup.

Migrating IBM MFP 8.0 with WAS + Oracle to PMF 9.0.x

Prerequisites

Before you begin, ensure the following.

• IBM MFP is deployed on WAS.

• Oracle database setup is present.

• You have backed up all the required configuration files.

• You have checked the JAVA_HOME path by using the following command.

  echo $JAVA_HOME

• You have Administrator user permission.

• Check WAS to the database connectivity by using the following commands.

  nc -w5 -z -v <ip_address> <port_number>

  netstat -an | grep <port_number> | grep -i listen

• If you are using Push component, refer to the push configuration document.

Procedure

• Choose an appropriate XML file. This XML file contains the Ant tasks and configurable properties.

  For example, for WAS + Oracle, use the following Ant file.

  pmf_install_dir/MobileFoundationServer/configuration-samples/configure-was-oracle.xml

• Create a copy of the configure-was-oracle.xml file to a working directory.

• Edit the configure-was-oracle.xml file copy and set the values of the following properties.

• Ensure that the value of the mfp.server.install.dir property in the Ant file points to the directory that contains the product with the fix pack applied. By default, the updated PMF WAR files take this value.

• See a list of possible targets for the Ant file by using the following command.

  pmf_install_dir/tools/apache-ant-1.9.4/bin ant -f file-path/configure-was-oracle.xml

• Run the Ant file update by using the following command.

  pmf_install_dir/tools/apache-ant-1.9.4/bin/ant -f {your_ant_file} update

Migrating IBM MFP 8.0 with WAS-ND + Oracle to PMF 9.0.x

Prerequisites

Before you begin, ensure the following.

• IBM MFP is deployed on WAS-ND.

• Oracle database setup is present.

• You have backed up all the required configuration files.

• You have checked the JAVA_HOME path by using the following command.

  echo $JAVA_HOME

• You have Administrator user permission.

• Check WAS to the database connectivity by using the following commands.

  nc -w5 -z -v <ip_address> <port_number>

  netstat -an | grep <port_number> | grep -i listen

• If you are using Push component, refer to the push configuration document.

Procedure

• Choose an appropriate XML file. This XML file contains the Ant tasks and configurable properties.

  For example, for WAS-ND + Oracle, use the following Ant file.

  pmf_install_dir/MobileFoundationServer/configuration-samples/configure-wasnd-cluster-oracle.xml

• Create a copy of the configure-wasnd-cluster-oracle.xml file to a working directory.

• Edit the configure-was-oracle.xmlfile copy and set the values of the following properties.

  Property	Value
  anmfp.push.urld	existing IBM MobileFirst push url
  appserver.was.admin.name	WAS-ND Server administrator
  appserver.was.admin.password	WAS-ND Server was admin password
  appserver.was.nd.cluster.admin	WAS-ND Server cluster name
  appserver.was.nd.cluster.push	WAS-ND Server push cluster name
  appserver.was.nd.cluster.runtime	WAS-ND Server runtime cluster name
  appserver.was.profile	WAS-ND Server Dmgr profile
  database.oracle.driver	existing IBM MobileFirst Oracle jdbc driver
  database.oracle.host	existing IBM MobileFirst Oracle database hostname
  database.oracle.mfp.dbname	existing IBM MobileFirst Oracle database name
  database.oracle.mfp.password	aexisting IBM MobileFirst Oracle database passwordnd
  database.oracle.mfp.schema	existing IBM MobileFirst Oracle database schema name
  database.oracle.mfp.username	existing IBM MobileFirst Oracle user
  database.oracle.port	existing IBM MobileFirst Oracle database port
  mfp.admin.client.id	existing IBM MobileFirst admin client id
  mfp.admin.client.secret	existing IBM MobileFirst admin client secret
  mfp.admin.console.install	true
  mfp.admin.contextroot	existing IBM MobileFirst admin contextroot
  mfp.admin.default.user.initialpassword	existing IBM MobileFirst admin default user
  mfp.analytics.client.id	existing IBM MobileFirst client id
  mfp.analytics.client.secret	existing IBM MobileFirst client secret
  mfp.analytics.configure	true if using analytics
  mfp.analytics.console.url	existing IBM MobileFirst console url
  mfp.analytics.receiver.client.id	existing IBM MobileFirst analytics receiver client id
  mfp.analytics.receiver.client.secret	existing IBM MobileFirst analytics receiver client secret
  mfp.analytics.receiver.configure	true if using analytics receiver
  mfp.analytics.receiver.url	existing IBM MobileFirst analytics receiver url
  mfp.analytics.receiver.user	existing IBM MobileFirst analytics receiver user
  mfp.analytics.receiver.user.password	existing IBM MobileFirst Analytics receiver password
  mfp.analytics.url	existing IBM MobileFirst analytics url
  mfp.analytics.user	existing IBM MobileFirst analytics user
  mfp.analytics.user.password	existing IBM MobileFirst Analytics user password
  mfp.authorization.url	existing IBM MobileFirst authorization url
  mfp.authorization.url.auto	false
  mfp.liveupdate.client.id	existing IBM MobileFirst liveupdate client id
  mfp.liveupdate.client.secret	existing IBM MobileFirst liveupdate client secret
  mfp.liveupdate.url	andexisting IBM MobileFirst liveupdate url
  mfp.process.liveupdate	true if using Liveupdate
  mfp.process.push	true if using Push
  mfp.push.client.id	existing IBM MobileFirst push client id
  mfp.push.client.secret	existing IBM MobileFirst push client secretd
  mfp.runtime.contextroot	existing IBM MobileFirst runtime contextroot
  mfp.server.install.dir	extracted zip file path of the Persistent Mobile Foundation Example pmf_install_dir/pmf_install_dir/Persistent_Mobile_Foundation

• Save the above changes and then run the following Ant commands.

Verifying the update

Use the following steps to verify that your update was successful.

• Start the profile by using the following command.

  ./startServer.sh server1 -profileName <server-name>

• Go to the following URL to access the PMF Operations Console login page.

  <http://host:port/mfpconsole>