Migrating from the IBM Mobile First Platform

Overview

Follow this tutorial for a full-fledged migration to the Persistent Mobile Foundation Version 9.x for different Application server and Database combinations.

Below scenario explains the detailed steps for migration of your setups.

Note: The following 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 Liberty + Db2 to PMF 9.x

Prerequisites

Before you begin, ensure the following.

  • IBM MFP is deployed on WAS.

  • Database setup is present.

  • You have downloaded or copied PMF 9.x package to your computer.

  • You have WebSphere® Application Server Liberty 24.0.

  • You have Java™ 8 and Java 17 on your computer. Verify by using the following command.

    java -version

  • Added JAVA_HOME path by using the following command.

    cd /vi~/.bashrc

    Add following to the bashrc file.

    export JAVA_HOME=<path to jdk 17 folder>

    Example

    export PATH="$JAVA_HOME/bin:$PATH"

  • You have backed up all the required configuration files.

  • You have Administrator user permission.

Procedure

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

    For example, for Liberty + Db2, use the following Ant file.

    pmf_install_dir/MobileFoundationServer/configuration-samples/configure-liberty-db2.xml

  • Create a copy of the configure-liberty-db2.xml file to a working directory.

  • Edit the configure-liberty-db2.xml file copy and set the values of the following properties.

    Property Value
    appcenter.admin.user1 Appcenter username
    appcenter.admin.user1.password Appcenter password
    appserver.was.admin.name WAS administrator
    appserver.was.installdir WAS installation directory
    appserver.was.installdir WebSphere Application Server Liberty path
    appserver.was.profile WAS profile
    appserver.was.profile Liberty
    appserver.was.serverInstance WAS name
    appserver.was85liberty.serverInstance WebSphere Application Server Liberty instance name
    database.db2.appcenter.dbname db2 database dbname
    database.db2.appcenter.schema db2 schema
    database.db2.appcenter.username db2 database username
    database.db2.driver oracle jdbc driver
    database.db2.driver.dir db2 JDBC driver directory
    database.db2.host The hostname of the computer that runs your Oracle database.
    database.db2.host Db2 database hostname
    database.db2.instance db2 instance
    database.db2.mfp.dbname PMF database name
    database.db2.mfp.schema PMF database schema name
    database.db2.mfp.username PMF oracle user
    database.db2.port Port number for Oracle database.
    By default, the port number is 1521.
    database.db2.port Db2 database port
    mfp.admin.client.id PMF admin client id
    mfp.admin.client.secret PMF admin secret
    mfp.admin.console.install true
    mfp.admin.contextroot /mfpadmin
    mfp.admin.default.user PMF Operations console user
    mfp.admin.default.user.initialpassword PMF Operations console password
    mfp.analytics.client.id client id
    mfp.analytics.client.secret client secret value
    mfp.analytics.configure true if PMF uses analytics
    mfp.analytics.configure true
    mfp.analytics.console.url Analytics console URL
    mfp.analytics.receiver.client.id Analytics receiver client id
    mfp.analytics.receiver.client.secret Analytics  receiver client secret
    mfp.analytics.receiver.configure true if PMF uses analytics receiver
    mfp.analytics.receiver.configure true
    mfp.analytics.receiver.url Analytics receiver URL
    mfp.analytics.receiver.user Analytics receiver user
    mfp.analytics.url Analytics URL
    mfp.analytics.user Analytics user
    mfp.config.admin.password PMF config admin password
    mfp.config.admin.user PMF config admin user
    mfp.farm.configure false if PMF is in stand-alone mode
    mfp.push.client.id PMF push client id
    mfp.push.client.secret PMF push secret
    mfp.runtime.contextroot /mfp
    mfp.server.install.dir Extracted zip file path of the Persistent Mobile Foundation 9.x package. By default, the updated PMF WAR files take this value.
    Example
    pmf_install_dir/pmf_install_dir/Persistent_Mobile_Foundation

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

    • Display a list of possible targets for the Ant file.

      pmf_install_dir/tools/apache-ant-1.9.4/bin ant -f file-path /configure-liberty-db2.xml

    • pmf_install_dir/tools/apache-ant-1.9.4/bin ant -f file-path /configure-liberty-db2.xml databases
    • pmf_install_dir/tools/apache-ant-1.9.4/bin ant -f file-path /configure-liberty-db2.xml update

Verifying the update

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

  • Start both servers and verify the data loaded in the MFP package should be present on all the consoles of the PMF package 9.x with WebSphere Application Server Liberty 24.0. This ensures that our migration was successful.

  • Start the profile by using the command:

    ./server start pmf_server
./server start analytics_server

  • Verify the product version.

  • It is recommended (not compulsory) that you uninstall the existing SDK and install new SDK version.

  • Go to the following URL to access the PMF consoles login page.

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

▲
Last modified on