Migrating IBM MQ Internet Pass-Thru

Follow this procedure to upgrade to a new version of IBM MQ Internet Pass-Thru (MQIPT), or to apply fix pack maintenance to your MQIPT installation. We can also use this procedure to upgrade from MQIPT support pack Version 2.1 to MQIPT Version 9.1.


Procedure

  1. Make backups of our data. See Making backups for details.
  2. Install the new version of MQIPT. We can install the new version of MQIPT before uninstalling any versions of MQIPT that are currently installed. See Installing MQIPT for details.
  3. Restore the backed-up data files to the MQIPT home directory to be used by the new installation. If the MQIPT installation directory is used as the home directory, then overwrite any newly installed copies of data files with the backed-up files.
  4. Ensure that any properties that contain file names in the new mqipt.conf configuration file, refer to files to be used by the new installation of MQIPT.
  5. Review the list of changes and new features in the new version or fix pack of MQIPT. For to make any changes to the MQIPT configuration for the new version, make the necessary changes to the new copies of the data files.
  6. Stop the current version of MQIPT by issuing the following command: 
    mqiptAdmin -stop
  7. Start MQIPT at the latest version by issuing the following command:

    • On Windows systems: 
      MQIPT_INSTALLATION_PATH\bin\mqipt MQIPT_HOME_DIR
    • On UNIX and Linux systems: 
      MQIPT_INSTALLATION_PATH/bin/mqipt MQIPT_HOME_DIR

    where

    • MQIPT_INSTALLATION_PATH is the directory where that latest version of MQIPT is installed.
    • MQIPT_HOME_DIR is the MQIPT home directory containing the data files to be used by the latest installation of MQIPT.

  8. Test that MQIPT works correctly at the latest version. After you confirm that the latest version of MQIPT is configured correctly, we can uninstall the previous version. See Uninstalling MQIPT for details.
  9. If there are any passwords in your MQIPT configuration that have not been encrypted, or passwords that were encrypted prior to MQIPT Version 9.1.5, encrypt these passwords using the latest protection method by following the procedure in Encrypting stored passwords.

Parent topic: Maintain and migrate IBM MQ