Upgrading the Service Provider Schema

Upgrading the service provider schema involves a subset of the steps to perform a full MATRIXX Digital Commerce upgrade.

About this task

Repeat these steps for each sub-domain. You must configure and restart the entire MATRIXX Engine chain of a sub-domain before upgrading the schema of the next sub-domain.
Note: During this process, the activate_engine.py script does not allow engine switching until all engines are updated with the new schema.

Procedure

  1. Copy the upgraded mdc_config_custom.xml to the /opt/mtx/conf directory of each server running MATRIXX gateways or Web apps.
    Note: Obtain the mdc_config_custom.xml file from your staging server, or create the file by running create_config.py with an updated create_config.info file before restarting the engine.
  2. Pin the MATRIXX Gateways and Web Apps to the pre-upgrade schema version and restart. See the discussion about pinning and unpinning schema versions for specific instructions for each gateway or Web app.
  3. In each sub-domain:
    1. Stop the MATRIXX Engine in the sub-domain by running the stop_engine.py script.
    2. Copy the upgraded create_config.info (with your custom MDCs) to the /opt/mtx/custom directory on the target engine.
    3. Run the create_config.py script.
    4. Configure the target engine by running the config_engine.py script.
    5. Start the target engine by running the start_engine.py script.
    6. Repeeat steps a through e for each engine in the sub-domain.
  4. Unpin and restart the MATRIXX gateways and Web apps.