Skip to main content

Zero Downtime Migration Installation

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

info

ZDM 21.5 was released recently and should be used for new migration projects. This article will soon be updated with all the changes.

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 but the ZDM host must be able to connect to both, the source and the target database servers.

Supported O/S​

  • Oracle Linux 7
  • Oracle Linux 8
  • Red Hat Enterprise Linux 8

Storage​

Make sure the host has at least 100GB of free storage space available.

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

O/S user​

Create a new group and user on the ZDM host:

groupadd zdm
useradd -g zdm zdmuser

Directories​

Create ZDM base and home directories:

Example:

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

User Environment​

Add the following lines to the o/s user environment file 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 needs to be installed.

Installation​

These are the steps to install Zero Downtime Migration:

  1. Download the Zero Downtime Migration software.

  2. Copy the downloaded zip file to your zdm server to a directory owned by the zdm o/s user for example /u01/zdm/zdminstall

  3. Unzip the software zip file and cd into that new extracted directory

  4. 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/zdm21.4/zdm_home.zip

  5. Start the ZDM service

$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:8899/
 RMI port: 	    8897
 HTTP port: 	8898
 Wallet path: 	/u01/zdm/zdmbase/crsdata/zdmhost/security
  • Check the ZDM version:
$ZDM_HOME/bin/zdmcli -build
Example output of zdmcli -build
version: 21.0.0.0.0
full version: 21.4.0.0.0
patch version: 21.4.1.0.0
label date: 221207.25
ZDM kit build date: Jul 31 2023 14:24:25 UTC
CPAT build version: 23.7.0