Skip to main content
How-To
Reviewed:Oct 8, 2026

Zero Downtime Migration Installation

This article shows how to install the Zero Downtime Migration (ZDM) 26.1 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
    • Oracle Linux 9
    • Red Hat Enterprise Linux 8
    • Red Hat Enterprise Linux 9

  • Storage:

    • At least 100 GB of free storage space available.

  • Required Packages: Make sure the following packages are installed on the system:

    • unzip
    • expect
    • glibc-devel
    • libnsl
    • ncurses-compat-libs
    • libaio
    • oraclelinux-developer-release-el9

    ncurses-compat-libs is not part of the default OL9 repositories. Enable the ol9_developer_EPEL repository first, then install the packages:

    Enable the developer EPEL repo
    sudo yum install -y oraclelinux-developer-release-el9
    sudo yum config-manager --set-enabled ol9_developer_EPEL
    Install all packages
    sudo yum install -y 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

Installation​

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

1. Download Software​

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

  • 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 variables 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/zdm26.1/zdm_home.zip

    Output
    ZDM kit home: /u01/zdm/zdminstall/zdm26.1
    /u01/zdm/zdminstall/zdm26.1
    ---------------------------------------
    Validating zip file...
    ---------------------------------------
        25  04-11-2026 17:13   rhp/zdm.build
    ---------------------------------------
    Unzipping shiphome to home...
    ---------------------------------------
    Unzipping shiphome...
    Shiphome unzipped successfully..
    ---------------------------------------
    ##### Performing GridHome Software Only Installation #####
    ---------------------------------------
    Installation log location: /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/rhp/logs/runInstaller_1791482565.out
    making dir /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/rhp/conf
    ---------------------------------------
    Setting preferences file
    ---------------------------------------
    /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/rhp/conf/rhp.pref
    ---------------------------------------
    Generating Root Certificate
    ---------------------------------------
    Cluster root certificate generated successfully.
    ---------------------------------------
    Generating CA CERTS file
    ---------------------------------------
    spawn /u01/zdm/zdmhome/bin/crskeytoolctl -copycacerts -filestore /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/security
    Enter JRE cacerts truststore password:
    JRE cacerts copied to file [/u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/security/cacerts].
    spawn /u01/zdm/zdmhome/bin/crskeytoolctl -rekey -filestore /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/security -validity 396
    Node rekey action ran successfully.
    ---------------------------------------
    Generating nogi.enabled file
    ---------------------------------------
    nogi.enabled file generated sucessfully
    ---------------------------------------
    Setting properties file
    ---------------------------------------
    /u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/rhp/conf/fpp.properties
    Set oracle.jmx.login.credstore=WALLET in fpp.properties
    Set java.util.logging.FileHandler.pattern=\/u01\/zdm\/zdmbase\/crsdata\/mdo-fra-vm-zdm-01\/rhp\/logs\/logger.out in logging.properties
    ---------------------------------------
    Setting base folder permissions
    ---------------------------------------
    Copying service script to bin folder in Oracle Home
    label_date is: 260410.1
    Generating public/private rsa key pair.
    Your identification has been saved in /u01/zdm/zdmbase/zdm/admin/id_rsa
    Your public key has been saved in /u01/zdm/zdmbase/zdm/admin/id_rsa.pub
    The key fingerprint is:
    SHA256:Pxzz/GwZOEJW§23ftsLq2KMCWivlmNfimcQ zdmuser@mdo-fra-vm-zdm-01
    The key's randomart image is:
    +---[RSA 3072]----+
    |             .*B+|
    |             o+**|
    |              .**|
    |            . o.o|
    |        S oo + o |
    |    .+   o =. =  |
    |    BE+   +.o  + |
    |   =.=oo  +o oo  |
    |    ++. .o....o  |
    +----[SHA256]-----+
    ---------------------------------------
    Adding Certs to ZDM
    ---------------------------------------
    ---------------------------------------
    Adding java jre to ZDM
    ---------------------------------------
    ZDM service setup finished successfully...

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 zdmservice status
    ---------------------------------------
      	Service Status
    ---------------------------------------

     Running: 	true
     Tranferport:
     Conn String: 	jdbc:derby:/u01/zdm/zdmbase/derbyRepo;create=true
     Repo Path:   	/u01/zdm/zdmbase/derbyRepo
     RMI port:    	8897
     HTTP port:   	8898
     SSH port:    	22
     Wallet path: 	/u01/zdm/zdmbase/crsdata/mdo-fra-vm-zdm-01/security

  • Check the ZDM version:

    $ZDM_HOME/bin/zdmcli -build
    Example output of zdmcli -build
    full version: "26.1.0"
    patch version: ""
    label date: 260410.1
    ZDM kit build date: Apr 11 2026 17:13:53 UTC
    CPAT build version: 26.3.0

Next steps​