Zero Downtime Migration Installation

This article shows how to install the Zero Downtime Migration (ZDM) 21.5 software.

Prerequisites

Overview of all the different prerequisites for ZDM.

ZDM Host:
- The ZDM software can either be installed on a compute instance running on OCI or a server/vm running on-premises or another cloud (Azure, AWS, Google). The ZDM host must be able to connect to the source and the target database servers.
Supported Operating Systems:
- Oracle Linux 7
- Oracle Linux 8
- Red Hat Enterprise Linux 8
Storage:
- At least 100GB of free storage space available.
Required Packages:
Make sure the following packages are installed on the system:
- Oracle Linux 7:
  - expect
  - glibc-devel
- Oracle Linux 8:
  - unzip
  - expect
  - glibc-devel
  - libnsl
  - ncurses-compat-libs
  - libaio
  - oraclelinux-developer-release-el8
- Red Hat Enterprise Linux 8:
  - unzip
  - expect
  - glibc-devel
  - libnsl
  - ncurses-compat-libs
  - libaio
Operating System User:
- Create a new group:
```
sudo groupadd zdm
```
- Create a new user with the previously created group:
```
sudo useradd -g zdm zdmuser
```

Directories:

Create ZDM base and home directories:
Example:

sudo mkdir -p /u01/zdm/zdmhome
sudo mkdir -p /u01/zdm/zdmbase
sudo chown -R zdmuser:zdm /u01/zdm

User Environment:
- Add the following lines to the O/S user environment file (.bashrc for example) to set ZDM_HOME, ZDM_BASE and the PATH after login:
```
ZDM_BASE=/u01/zdm/zdmbase
ZDM_HOME=/u01/zdm/zdmhome
export PATH=$PATH:$ZDM_HOME/bin
```
Perl:
- Perl is required on the ZDM host to run the install script.
- For 11.2.0.4 sources also the latest Perl patch 5.28.2 must be installed.

Installation

Here are the steps to install the Zero Downtime Migration software:

1. Download Software

Download the software from the Zero Downtime Migration page.

2. Copy and Extract

Copy the downloaded zip file to your ZDM server to a directory owned by the ZDM O/S user.
For example: /u01/zdm/zdminstall/zdm21.5.2
Unzip the software zip file and cd into that new extracted directory.

3. Install Script

Log out and in as the ZDM O/S user again and make sure the environment variable are set:

set | grep -i ZDM_; echo $PATH

Output
ZDM_BASE=/u01/zdm/zdmbase
ZDM_HOME=/u01/zdm/zdmhome
/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/u01/zdm/zdmhome/bin:/home/zdmuser/.local/bin:/home/zdmuser/bin

Execute the Zero Downtime Migration installation script.
(Ignore any messages about executing root scripts at the end of the installation)
```
./zdminstall.sh setup oraclehome=$ZDM_HOME oraclebase=$ZDM_BASE ziploc=$PWD/zdm_home.zip
```
ziploc is the location of the compressed ZDM zip file (zdm_home.zip) included in the downloaded software file. For example: /u01/zdm/zdminstall/zdm_home.zip

4. Start Service

Start the ZDM service with the following command:
```
$ZDM_HOME/bin/zdmservice start
```

Verify Installation

Check the status of the ZDM service:

$ZDM_HOME/bin/zdmservice status

Example output of zdmserivce status
---------------------------------------
	Service Status
---------------------------------------

 Running: 	true
 Tranferport:
 Conn String: 	jdbc:mysql://localhost:8900/
 RMI port: 	8897
 HTTP port: 	8898
 Wallet path: 	/u01/zdm/zdmbase/crsdata/mdcioggzdm/security

Check the ZDM version:

$ZDM_HOME/bin/zdmcli -build

Example output of zdmcli -build
version: 21.0.0.0.0
full version: "21.5.0"
patch version: "21.5.2"
label date: 240219.27
ZDM kit build date: Jul 24 2025 23:59:08 UTC
CPAT build version: 25.6.0

Prerequisites​

Installation​

1. Download Software​

2. Copy and Extract​

3. Install Script​

4. Start Service​

Verify Installation​