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.x on-prem deployment.

Migration scenario

IBM® MobileFirst Foundation 8.0 → Persistent Mobile Foundation 10.x

Prerequisites

  1. JAVA™ 17.

    Note:

    • Java and java_home path must be added to environment variables.
    • PMF 10.x supports only Java™ 17.
  2. WebSphere® Application Server Liberty 24.0.
  3. PMF-PKG-<version>.zip file (Provided by Persistent Systems) for PMF 10.x.

  4. Your mobile client applications (Android, iOS) and IBM MobileFirst Foundation 8.0 adapters are Java™ 17 compatible.

  5. OpenSearch should be up and running.

    The Elasticsearch component has being replaced by OpenSearch in PMF 10.x. For more information, see Installing and configuring OpenSearch.

Pre-installation tasks

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

     Java -version
 echo $JAVA_HOME

  2. Upload PMF product to server.

    a. Create a 10.x folder inside /opt/PSL directory.

    b. Upload PMF-PKG-<version>.zip file to the /opt/PSL/10.x 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.x

  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

  1. Update PMF Analytics Receiver component configuration file.

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

    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.x/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin 
 ./ant -f /opt/PSL/10.x//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.x/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.x/Persistent_Mobile_Foundation/Analytics/configuration-samples and edit the configure-liberty-analytics.xml file to set the values of the JNDI properties.

    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.x/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin 
 ./ant -f /opt/PSL/10.x/Persistent_Mobile_Foundation/Analytics/configuration-samples/configure-liberty-analytics.xml

    d. Migrate Analytics component by using the following command.

     ./ant -f /opt/PSL/10.x/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.x/Persistent_Mobile_Foundation/ApplicationCenter/configuration-samples and edit the configure-appcenter-liberty-db2.xml file to set the values of the JNDI properties.

    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.x/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin 
 ./ant -f /opt/PSL/10.x/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.x/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.x/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples and edit the configure-liberty-db2.xml file to set the values of the JNDI properties.

    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.x/Persistent_Mobile_Foundation/tools/apache-ant-1.9.4/bin 
 ./ant -f /opt/PSL/10.x/Persistent_Mobile_Foundation/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml

    d. Migrate Admin component by using the following command.

     ./ant -f /opt/PSL/10.x/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.x/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.x/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.x/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 Java 17 adapters/apps and perform testing.

Rolling back

You can roll back from PMF 10.x 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.x by using the following command.

    mv wlp wlp_10.x

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

    tar -xvzf wlp.tar.gz

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