Merging 3.0.2HF-4 Configurations to 4.0 Configurations

The application's configuration and log4j configuration properties used by TIBCO Fulfillment Order Management 3.0.2 HF-4 must be migrated into the corresponding files in the TIBCO Fulfillment Order Management 4.0 installation.

This can be done by running a Java based command line utility which can be launched using $AF_HOME/migration/bin/migrateConfigProperties.sh. This utility requires all .jar files present in the $AF_HOME/migration/lib directory. The utility refers to the following two files from the $AF_HOME/migration/config directory:
  • migrationIgnore.properties - This file contains the property name of the configuration properties which are ignored during the migration. By default, there are only two configuration properties which are ignored.
  • MigrationLog4j.xml - This file contains the log4j configurations for the utility with the default log level set at INFO level. It can be changed to DEBUG for more granular logging.
    This utility migrates the application's configuration properties for the following components in the mentioned files:
    • OmsServer and Orchestrator - $AF_HOME/roles/configurator/standalone/config/ConfigValues_OMS.xml
    • AOPD - $AF_HOME/roles/configurator/standalone/config/ConfigValues_AOPD.xml
    • JEOMS - $AF_HOME/roles/configurator/standalone/config/ConfigValues_JEOMS.xml
    • OPE - $AF_HOME/roles/configurator/standalone/config/ConfigValues_OPE.xml
    It also migrates the log4j configuration properties for the following components in the mentioned files:
    • OmsServer, Orchestrator and JEOMS - $AF_HOME/roles/configurator/standalone/config/OMSServerLog4j.xml
    • AOPD - $AF_HOME/roles/configurator/standalone/config/AOPDLog4j.xml
    • OMSUI - $AF_HOME/roles/configurator/standalone/config/OMSUILog4j.xml
    • OPE - $AF_HOME/roles/configurator/standalone/config/OPELog4j.xml

    The utility writes the logs in the $AF_HOME/migration/logs/fom-property-migration.log file.

Procedure

  1. Set the following three environment variables before running the utility. The utility fails with an error message if any of the following environment variables are not set:
    1. JAVA_HOME- Path of Java installation, for example, /opt/Java/jdk1.8.0
    2. AF_HOME- Path of FOM 4.0.0 installation directory, for example, /opt/tibco/af/4.0
    3. OLD_AF_HOME- Path of FOM 3.0.2 installation directory, for example, /opt/tibco/af/3.0
  2. Run the $AF_HOME/migration/bin/migrateConfigProperties.sh script.
  3. If you were not using any custom values for the following properties, you must change the value for these properties:
    1. Change the value for
      name="GetOrderRequest receiver dead queue" propname="com.tibco.fom.oms.tds.getorderrequest.receiver.deadqueue"
      to
      value="tibco.aff.oms.tds.order.read.request.dead"
    2. Change the value for
      name="GetPlan/GetPlanItem Request receiver dead queue" propname="com.tibco.fom.oms.tds.getplanrequest.receiver.deadqueue"
      to
      value="tibco.aff.oms.tds.plan.read.request.dead"
    3. Change the value for
      name="SetPlan/SetPlanItem Request receiver dead queue" propname="com.tibco.fom.oms.tds.setplanrequest.receiver.deadqueue"
      to
      value="tibco.aff.oms.tds.plan.request.dead"
    4. Change the value for
      name="Cron Expression" propname="com.tibco.af.oms.summaryDataCollection.scheduled.cronExpress"
      to
      value="0 0/10 * * * ?"
  4. If you will be using containerized TIBCO Fulfillment Order Management services (using Docker containers to run the TIBCO Fulfillment Order Management services), then you must change the value for the following properties:
    Note: You need to make these changes even if you have custom values for the properties.
    1. Change the value for
      name="Discount catalog poller and WS directory" propname="com.tibco.fom.oms.afi.offline.discount.directory"
      to
      value="/home/tibuser/tibco/af/discount"
    2. Change the value for
      name="Discount catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.discount.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/discount-success"
    3. Change the value for
      name="Discount catalog import failure poller and WS directory" propname="com.tibco.fom.oms.afi.offline.discount.importfailure.directory"
      to
      value="/home/tibuser/tibco/af/discount-failure"
    4. Change the value for
      name="Price catalog poller and WS directory" propname="com.tibco.fom.oms.afi.offline.price.directory"
      to
      value="/home/tibuser/tibco/af/price"
    5. Change the value for
      name="Price catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.price.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/price-success"
    6. Change the value for
      name="Price catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.price.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/price-failure"
    7. Change the value for
      name="Action catalog poller and WS directory" propname="com.tibco.fom.oms.afi.offline.action.directory"
      to
      value="/home/tibuser/tibco/af/action"
    8. Change the value for
      name="Action catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.action.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/action-success"
    9. Change the value for
      name="Action catalog import failure poller and WS directory" propname="com.tibco.fom.oms.afi.offline.action.importfailure.directory"
      to
      value="/home/tibuser/tibco/af/action-failure"
    10. Change the value for
      name="Planfragment catalog poller and WS directory" propname="com.tibco.fom.oms.afi.offline.planfragment.directory"
      to
      value="/home/tibuser/tibco/af/planfragment"
    11. Change the value for
      name="Planfragment catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.planfragment.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/planfragment-success"
    12. Change the value for
      name="Planfragment catalog import failure poller and WS directory" propname="com.tibco.fom.oms.afi.offline.planfragment.importfailure.directory"
      to
      value="/home/tibuser/tibco/af/planfragment-failure"
    13. Change the value for
      name="Product catalog poller and WS directory" propname="com.tibco.fom.oms.afi.offline.product.directory"
      to
      value="/home/tibuser/tibco/af/product"
    14. Change the value for
      name="Product catalog import success poller and WS directory" propname="com.tibco.fom.oms.afi.offline.product.importsuccess.directory"
      to
      value="/home/tibuser/tibco/af/product-success"
    15. Change the value for
      name="Product catalog import failure poller and WS directory" propname="com.tibco.fom.oms.afi.offline.product.importfailure.directory"
      to
      value="/home/tibuser/tibco/af/product-failure"