Upgrading to IBM Z Resource Discovery Data Service 1.6.0

This section includes the steps required to upgrade to IBM Z® Resource Discovery Data Service version 1.6.0.

About this task

To use the enhanced features available in IBM Z Resource Discovery Data Service version 1.6.0, you must upgrade from any earlier version to version 1.6.0.

CAUTION:

In version 1.6.0, the PostgreSQL database is upgraded to version 16. Migrating existing data to PostgreSQL 16 is mandatory for using IBM Z Resource Discovery Data Service version 1.6.0. You must back up your data from the earlier database, complete the upgrade to IBM Z Resource Discovery Data Service version 1.6.0, and restore the backup into PostgreSQL 16.

Procedure

  1. Go to the folder where you extracted the IBM Z Resource Discovery Data Service version 1.6.0 installation package.
  2. Extract the pg12_to_pg16_migration.tar.gz package.
  3. Copy the extracted pg12_to_pg16_migration folder in the <ZOA_HOME> of 1.4.2 or below.
  4. Navigate to the pg12_to_pg16_migration folder. To back up the existing data, run the ./pg12_backup.sh script from the <ZOA_HOME> of 1.4.2.
    Select the location where you want to store the backup. Verify that the selected location has sufficient storage space and that you have the required permissions to back up the data.
    The script generates a folder which contains both zrdds_data_backup.dump and postgres_volume_backup.
    Important: Ensure that the backup process is completed successfully before upgrading to IBM Z Resource Discovery Data Service version 1.6.0.
    Note: If the zrdds_data_backup.dump file is corrupted or if the backup or restore process fails, contact the IBM Support team to obtain the rollback_to_pg12 script.
  5. In the IBM Z Resource Discovery Data Service version 1.6.0 installation folder, run one of the following commands to upgrade to version 1.6.0. 
    • ./zoacommon/dockerDeployZoa.sh -i
    • ./zoacommon/podmanDeployZoa.sh -i
    CAUTION:
    After the upgrade is complete, ensure that you restore your data before using any IBM Z Resource Discovery Data Service features.
  6. After completing the upgrade to IBM Z Resource Discovery Data Service version 1.6.0, copy the extracted pg12_to_pg16_migration folder to the <ZOA_HOME> of 1.6.0, and run the ./pg16_restore.sh script from the pg12_to_pg16_migration folder to restore the backup data to PostgreSQL 16.

    An option is provided to specify the location where the PostgreSQL 12 backup is stored.

    This script restores the backed‑up data from the zrdds_data_backup.dump file into PostgreSQL 16.

    After the restore is completed, make the containers up by using the following commands:
    1.6.0_ZOA_HOME/bin/podmanManageZoa.sh up
    1.6.0_ZOA_HOME/bin/dockerManageZoa.sh up
    Then verify the restored data to ensure that the migration was successful. After the restore is successful, you can start using the IBM Z Resource Discovery Data Service features.
    CAUTION:
    After confirming that the required data has been restored successfully and is no longer needed, you may delete the backup directory. Deleting the backup directory permanently removes the ability to restore the previous data.

    If you encounter issues and need to restore to the previous IBM Z Resource Discovery Data Service version, contact IBM Support for assistance.