Migrating from MFP 8.0 (On-prem)

This topic is meant for existing IBM® MobileFirst Foundation 8.0 users that want to migrate to the PMF 10.0 on-prem deployment.

Prerequisites

  1. See Java Development Kit (JDK) for the recommended JAVA version.

    icon Note:  Java  and  java_home  path must be added to environment variables.

  2. See WebSphere® Application Server Liberty for the recommended WebSphere® Application Server Liberty version.
  3. PMF-PKG-<version>.zip file (Provided by Persistent Systems) for PMF 10.0.

  4. Your mobile client applications (Android, iOS) and IBM MobileFirst Foundation 8.0 adapters are compatible with the recommended JAVA version.

  5. OpenSearch should be up and running. The Elasticsearch component has being replaced by OpenSearch in PMF 10.0. For more information, see Installing and configuring OpenSearch.

Jump to

Pre-installation tasks

Involves following steps.

  1. Check installed Java version.

    1. Check java and java_home path by using the following command.

        java -v
  echo $JAVA_HOME

  2. Upload PMF product to server.

    a. Create a 10.0 folder inside /opt/PSL directory.

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

    unzip PMF-PKG-<version>.zip

    c. Provide permissions by using the following command.

    chmod 775 -R /opt/PSL/10.0

  3. Backup WebSphere® Application Server.

    a. Stop the server.

    b. Backup the database.

    c. Take WAS backup by using the following command.

     tar -cvzf wlp.tar.gz wlp

  4. Migrate the Elasticsearch data to OpenSearch.

    For more information, see Migrating Elasticsearch data to OpenSearch.

    a. Go to tools/elasticsearch-opensearch-migration directory of the extracted package and install application prerequisites by running the following command.

     export PATH=/< extracted path>/tools/elasticsearch-opensearch-migration/node-linux-x64/bin:$PATH
 cd /<extracted path>/tools/elasticsearch-opensearch-migration/analytics-data-migration-tool
 npm install
 node -v

    b. Update the config.json parameters as required.

    c. Export Elasticsearch data by using the following command.

        cd /<extracted path>/tools/elasticsearch-opensearch-migration/analytics-data-migration-tool
    npm run export -- -b 100

    d. Migrate data to OpenSearch by using the following command.

        npm run migrate -- -b 100

    e. Validate migration by using the following command.

        npm run migrate -- -v

Procedure

Involves following steps.

  1. Update PMF Analytics Receiver component configuration file.

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

    icon Note:  You can use the IBM MobileFirst  configure-liberty-analytics-receiver.xml  file as a reference.

    b. Save the file after the properties are defined.

    c. Run the following commands to show a list of possible targets for the Ant file.

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

    d. Migrate Analytics Receiver component by using the following command.

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

  2. Update PMF Analytics component configuration file.

    a. Go to /opt/PSL/10.0/Persistent_Mobile_Foundation/Analytics/configuration-samples and edit the configure-liberty-analytics.xml file to set the values of the JNDI properties.

    icon Note:  You can use the IBM MobileFirst  configure-liberty-analytics.xml   file as a reference.

    b. Save the file after the properties are defined.

    c. Run the following commands to show a list of possible targets for the Ant file.

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

    d. Migrate Analytics component by using the following command.

     ./ant -f /opt/PSL/10.0/Persistent_Mobile_Foundation/Analytics/configuration-samples/configure-liberty-analytics.xml update

    e.Add the following properties to the server.xml file.

     <jndiEntry jndiName="analytics/datastore_url" value="<OpenSearchURL>"/>
 <jndiEntry jndiName="analytics/datastore_username" value="OpenSearchUser"/>
 <jndiEntry jndiName="analytics/datastore_password" value="OpenSearchPassword"/>
 <jndiEntry jndiName="analytics/tenant" value="OpenSearchTenant"/>

    f. Edit config.properties file and whitelist your servers.

    /…/wlp/usr/servers/<servername>/config.properties

    g. Start the server.

    h. Go to browser and verify you can access the Analytics console.

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

  3. Update PMF Application Center component configuration file.

    a. Go to /opt/PSL/10.0/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples and edit the configure-appcenter-liberty-db2.xml file to set the values of the JNDI properties.

    icon Note:  You can use the IBM MobileFirst  configure-appcenter-liberty-db2.xml   file as a reference.

    b. Save the file after the properties are defined.

    c. Run the following commands to show a list of possible targets for the Ant file.

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

    d. Migrate AppCenter component by using the following command.

     ./ant -f /opt/PSL/10.0/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples/configure-appcenter-liberty-db2.xml update

    e. Edit config.properties file and whitelist your servers.

    /…/wlp/usr/servers/<servername>/config.properties

    f. Start the server.

    g. Go to browser and verify you can access the ApplicationCenter console.

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

  4. Update PMF Admin, Runtime, LiveUpdate, Push components configuration files.

    a. Go to /opt/PSL/10.0/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples and edit the configure-liberty-db2.xml file to set the values of the JNDI properties.

    icon Note:  You can use the IBM MobileFirst  configure-liberty-db2.xml  file as a reference.

    b. Save the file after the properties are defined.

    c. Run the following commands to show a list of possible targets for the Ant file.

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

    d. Migrate Admin component by using the following command.

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

    e. Migrate Runtime component by using the following command.

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

    f. Migrate LiveUpdate component by using the following command.

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

    g. Migrate Push component by using the following command.

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

    h. Edit config.properties file and whitelist your servers.

    /…/wlp/usr/servers/<servername>/config.properties

    i. Start the server.

    j. Go to browser and verify you can access the Admin console.

    http://<host>:<port>/mfpconsole

  5. Deploy the compiled OpenJDK Adapters/apps and perform testing.

    See Java Development Kit (JDK) for the recommended JAVA version.

Rolling back

You can roll back from PMF 10.0 to MFP 8.0 by using the backup you took in the Step#3 of Pre-installation tasks section.

Roll back the migration as follows.

  1. Stop server.
  2. Rollback the database.
  3. Rollback java and java_home path to point to java 8.

  4. Rename the wlp directory to wlp_10.0 by using the following command.

    mv wlp wlp_10.0

  5. Revert wlp directory to previous MFP stage by using the following command.

    tar -xvzf wlp.tar.gz

  6. Ensure that Start server, services resume with MFP-8.0.
▲
Last modified on