Migrating an offline cluster to a new major version

If you are migrating from HCL Informix 14.10 or later version, you stop all servers in the cluster during a period when downtime is acceptable. While the cluster if offline, you upgrade all the servers. You then start the primary followed by the secondary servers. You need not rebuild the cluster or clone the servers.

Before you begin

• Complete the steps in Preparing for migration.
• Complete the steps in Preparing to migrate, upgrade, or revert clusters.
• Perform all migration operations as user informix.

About this task

Be sure to stop and start the servers in the cluster in the order shown in the following procedure.

Procedure

To migrate to a new version with high-availability clusters:

1. Stop the Connection Manager by issuing the oncmsm -k connection_manager_name command.
2. If you are using a High-availability Data Replication (HDR) secondary server as a backup server in case of contingencies:
   1. Quiesce the primary server by issuing an onmode -sy command to prevent user connections to the server.
   2. Force a checkpoint by issuing an onmode c command on the primary server.
3. Stop the secondary servers in the cluster in the following order:
   1. If you have remote standalone (RS) secondary servers, stop them by issuing the onmode -ky command.
   2. If you have shared disk (SD) servers, stop them by issuing the onmode -ky command.
   3. If you have an HDR secondary server, stop it by issuing the onmode -ky command.
4. Stop the primary server by issuing the onmode -ky command.
5. On each server, set the INFORMIXDIR environment variable to the full path name for the target installation.
6. Ensure that all of the necessary configuration files are available in the target installation.
7. Optional: Enable quick reversion to a consistent restore point if the migration fails. Do this by setting the CONVERSION_GUARD and RESTORE_POINT_DIR configuration parameters. (For more information, see Configuring for recovery of restore point data in case an upgrade fails.)
8. Start the primary server by issuing an oninit command.
9. Ensure that the conversion to the target server was successful and that the server is in multi-user mode.
10. If you are migrating from HCL Informix 14.10 or later version, for HDR and RSS servers,
    1. Enable quick reversion to a consistent restore point if the migration fails. Do this by setting the CONVERSION_GUARD and RESTORE_POINT_DIR configuration parameters. (For more information, see Configuring for recovery of restore point data in case an upgrade fails.)
    2. Start secondary server by issuing an oninit command.
    3. Check ‘onstat -g cluster’ output at primary server, and once HDR/RSS secondary server connected to primary server, force a checkpoint at primary server using ‘onmode -c’ command and make sure checkpoint is replayed at HDR/RSS secondary server.
11. Start the Connection Manager by issuing an oncmsm command.
12. Start SD secondary servers by issuing oninit commands.
13. Start the servers in the cluster and perform additional tasks in the following order:
14. Perform any additional standard migration tasks described in Migrating to the new version of HCL OneDB and in Completing required post-migration tasks.

Results

The migration of all servers in the cluster is now complete.