Migrating

Follow this tutorial for a full-fledged migration from IBM MobileFirst Platform Version 8.0 to the Persistent Mobile Foundation Version 9.0.x.

Migrating existing applications to PMF SDKs

You can add support to your existing applications Persistent Mobile Foundation Version 9.0.x features existing applications by adding the PMF SDK plug-ins to your app, for more information refer the following links.

Migrating existing MFP 8.0 to PMF 9.0.3

Prerequisites

  • Java™ setup - Add Java and java_home path to the environment variables.
  • Database setup - You should have all the mandatory details like host, port, username, password, dbname, schema name,and driver jar.
  • IBM® WebSphere setup should be up and running.
  • You have PMF-PKG-<version>.zipfile provided by Persistent team.

Preinstallation checks

  • Check Java and java_home path by using the following command.

      Java -version
  echo $JAVA_HOME

  • Check if PMF Operations Console is accessible.

    <protocol>://<host>:<port>/mfpconsole

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

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

Migration plan strategy

  • Database backup
  • Service interruption (Downtime starts)
  • Stop <MF>server and backup (WebSphere directory)
  • Migrate<MF>server to PMF 9.0.3.
  • Servers is ready for sanity test and end-to-end test with sample app or live apps. (Customer test time)
  • Service resume with PMF 9.0.3 on <MF>.

Backup server strategy

  1. Stop <MF> server.

  2. Backup WebSphere Application Server installation directory by using the following command.

    tar -cvzf Websphere.tar.gz Websphere

Rollback plan strategy

You can revert to MFP 8.0 from PMF 9.0.3 using the WebSphere Application Server directory backup that was done in the Backup server section.

Procedure

  1. Stop <MF> server.

  2. Rename Websphere directory to Websphere_PMF by using the following command.

    mv Websphere Websphere_PMF

  3. Revert WebSphere directory to previous MFP stage by using the following command.

    tar -xvzf Websphere.tar.gz

  4. Start <MF> server.
  5. Services resume with MFP 8.0.

Migration prerequisites

Upload PMF product to server as follows.

  1. Create PSL directory inside /opt.

  2. Upload PMF-PKG-<version>.zip to /opt/PSL/ and extract by using the following command.

    unzip PMF-PKG-<version>.zip

  3. Provide permissions by using the following command.

    chmod 775 -R /opt/PSL

Updating PMF Analytics Receiver component

  1. Go to /opt/PSL/Persistent_Mobile_Foundation/AnalyticsReceiver/configuration-samples and edit configure-liberty-analytics-receiver.xml file to set the values of the jndi properties.

    Note: You can refer previous IBM Mobile First Platform configure-liberty-analytics-receiver.xml file.

  2. Save the file after the properties are defined.

  3. Run the following command to show a list of possible targets for the Ant file.

     cd /opt/PSL/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin
 ./ant -f /opt/PSL/Persistent_Mobile_Foundation/AnalyticsReceiver/configuration-samples/configure-liberty-analytics-receiver.xml

  4. Run the following command to migrate analytics receiver component.

     ./ant -f /opt/PSL/Persistent_Mobile_Foundation/AnalyticsReceiver/configuration-samples/configure-liberty-analytics-receiver.xml update

Updating PMF Analytics component

  1. Go to /opt/PSL/Persistent_Mobile_Foundation/Analytics/configuration-samples and edit configure-liberty-analytics.xml to set the values of the jndi properties.

    Note: You can refer previous IBM Mobile First Platform configure-liberty-analytics.xml file.

  2. Save the file after the properties are defined.

  3. Run the following command to show a list of possible targets for the Ant file.

     cd /opt/PSL/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin
 ./ant -f /opt/PSL/Persistent_Mobile_Foundation/Analytics/configuration-samples/configure-liberty-analytics.xml

  4. Run the following command to analytics component.

     ./ant -f /opt/PSL/Persistent_Mobile_Foundation/Analytics/configuration-samples/configure-liberty-analytics.xml update
  5. Start the <MF> server.

  6. Go to browser and verify Analytics Console.

    http://<host>:<port>/analytics/console

Updating PMF Application Center component

  1. Go to /opt/PSL/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples and edit configure-appcenter-liberty-db2.xml to set the values of the jndi properties.

    Note: You can refer previous IBM Mobile First Platform configure-appcenter-liberty-db2.xml file.

  2. Save the file after the properties are defined.

  3. Run the following command to show a list of possible targets for the Ant file.

     cd /opt/PSL/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin
 ./ant -f /opt/PSL/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples/configure-appcenter-liberty-db2.xml

  4. Run the following command to migrate appcenter component.

     ./ant -f /opt/PSL/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples/configure-appcenter-liberty-db2.xml update
  5. Start the <MF> server.

  6. Go to browser and verify Application Center Console.

    http://<host>:<port>/appcenterconsole

Updating PMF Admin, runtime, LiveUpdate, push components

  1. Go to /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples and edit configure-liberty-db2.xml to set the values of the jndi properties.

    Note: You can refer previous IBM Mobile First Platform configure-liberty-db2.xml file.

  2. Save the file after the properties are defined.

  3. Run the following command to show a list of possible targets for the Ant file.

     cd /opt/PSL/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin
 ./ant -f /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml

  4. Run the following command to migrate admin component.

    ./ant -f /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml admupdate

  5. Run the following command to migrate runtime component.

    ./ant -f /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml rtmupdate

  6. Run the following command to liveupdate component.

    ./ant -f /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml liveupdateupdate

  7. Run the following command to push component.

    ./ant -f /opt/PSL/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml pushupdate

  8. Edit config.properties file and whitelist your servers. /opt/PSL/Websphere/Liberty/usr/servers/<servername>/config.properties
  9. Start the <MF> server.
  10. Go to browser and verify Admin Console. http://<host>:<port>/mfpconsole
▲
Last modified on