Upgrading MATRIXX Gateways and Web Apps

To upgrade MATRIXX Digital Commerce you first need to upgrade and configure each of the MATRIXX Gateways and Web Apps. During the upgrade process, the upgraded services that communicate with the MATRIXX Engines are pinned to the schema version you are upgrading from. After all of the services and their sub-domains have been upgraded, you reconfigure the MATRIXX Gateways and Web Apps to use the new schema version by unpinning them from the previous version.

1. Verify that the required version of Java is installed. For required version information, see the discussion about third-party software requirements in Installation and Configuration.
2. Obtain the following:
   • The MATRIXX schema version number you are currently using.
   • The service provider schema version you are using in your current running environment.
   • If you are updating the service provider custom schema, an upgraded mdc_config_custom.xml file. If you are upgrading the MATRIXX MDC schema, this can be taken from your staging environment. If you are only updating your service provider custom schema, this is obtained by running the create_config.py script before you configure the engines and restart.
3. Stop and uninstall MATRIXX Gateways and Web Apps.
4. Install new versions of the MATRIXX Gateways and Web Apps.
5. Pin the services to the schema version(s) you are upgrading from.
6. Start the gateways and Web apps.
7. After successfully upgrading MATRIXX Engines in all sub domains, un-pin the MATRIXX Gateways and Web Apps and restart them so that they use the same schema versions as the upgraded engines.