Upgrading to IBM Z Resource Discovery Data Service 1.6.2

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

About this task

To use the enhanced features available in IBM Z Resource Discovery Data Service version 1.6.2, you must upgrade your existing installation to version 1.6.2.

The following upgrade paths are supported:

Version 1.3.1.2 to version 1.6.2
Version 1.4.2 to version 1.6.2
Version 1.6.0 to version 1.6.2

Upgrading from version 1.3.1.2/1.4.2 to 1.6.2

About this task

CAUTION:

In version 1.6.2, 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.2. You must back up your data from the earlier database, complete the upgrade to IBM Z Resource Discovery Data Service version 1.6.2, and restore the backup into PostgreSQL 16.

Procedure

Go to the folder where you extracted the IBM Z Resource Discovery Data Service version 1.6.2 installation package.
Extract the pg12_to_pg16_migration.tar.gz package.
Copy the extracted pg12_to_pg16_migration folder into the <ZOA_HOME> directory of the version 1.4.2 (or earlier) installation.
Navigate to the pg12_to_pg16_migration folder. To back up the existing data, run the ./pg12_backup.sh script from the <ZOA_HOME> directory of the version 1.4.2 (or earlier) installation.
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.2.

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.
From the IBM Z Resource Discovery Data Service version 1.6.2 installation folder, run one of the following commands to upgrade to version 1.6.2.
- ```
./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.
After upgrading to IBM Z Resource Discovery Data Service version 1.6.2, copy the extracted pg12_to_pg16_migration folder to the <ZOA_HOME> directory of version 1.6.2 installation.
Navigate to the pg12_to_pg16_migration folder and run the ./pg16_restore.sh script to restore the backup data to PostgreSQL 16.

This script restores the backed‑up data from the zrdds_data_backup.dump file into PostgreSQL 16. When you run the script, you can specify the location of the PostgreSQL 12 backup.
After the restore completes, start the containers by running one of the following commands:
- ```
1.6.2_ZOA_HOME/bin/dockerManageZoa.sh up
```
- ```
1.6.2_ZOA_HOME/bin/podmanManageZoa.sh up
```
Verify the restored data to confirm that the migration was successful. After you verify the data, you can begin using the IBM Z Resource Discovery Data Service features.

CAUTION:
After confirming that the 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.
During the PostgreSQL upgrade, the Write-Ahead Log (WAL) is reset. As a result, all data can be republished to Kafka, which might lead to duplicate messages. To prevent this issue, clear the existing IBM Z Resource Discovery Data Service Kafka topics by running one of the following commands:
- ```
./dockerManageZoa.sh clear-zrdds-topics
```
- ```
./podmanManageZoa.sh clear-zrdds-topics
```

Upgrading from version 1.6.0 to 1.6.2

Procedure

Log in with the zoauser user ID.
In the installation directory, go to the zoacommon subdirectory, as shown in the following example:
```
cd install_dir/zoacommon
```
Start the installation process by using one of the following commands, depending on the container management tool that is used:
Docker
```
./dockerDeployZoa.sh --i
```
Podman
```
./podmanDeployZoa.sh --i
```
From the feature menu, select IBM Z Resource Discovery Data Service version 1.6.2.
Follow the installation prompts to complete the installation. After the installation completes, follow the instructions displayed by the installer to start IBM Z Resource Discovery Data Service.