Skip to main content

Zero Downtime Migration Patching

This article shows how to patch the Zero Downtime Migration software from 21.5.2 to 21.5.5.

Prerequisites​

Make sure the following prerequisites are met:

  • Make sure you have enough free storage space available as there will be a backup of the previous ZDM home created (at least 15GB).
  • The zdm o/s user needs to have read/write access to the path specified in the ziploc parameter.

Check Current Version​

  • Check the current version and build date with the following command:

    $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

    The current version in this output is 21.5.2.

Patching​

  1. Download the latest Zero Downtime Migration software patch from My Oracle Support: Patch 33509650: ZDM PATCH USING MOS - CURRENT PATCH VERSION: 21.5.1
tip

Make sure the Release in the Patch Note shows Zero Downtime Migration 21.5.2.0.0 when you are patching ZDM 21.5

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

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

  3. Update the ZDM service
    To update the current ZDM service, execute the zdminstall.sh from the unzipped software directory

Execute the Zero Downtime Migration installation script. (Ignore any messages about executing root scripts at the end of the installation)

caution

The zdm update needs to be run from outside of the current $ZDM_HOME

./zdminstall.sh update oraclehome=$ZDM_HOME 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/zdmuser/zdmpatch/ZDMKIT

note

The backup for the ZDM_BASE and ZDM_HOME will also be created in the unzipped software directory from which the zdminstall.sh was executed:

  • oldbase.zip
  • oldhome.zip
  1. Start the ZDM service
$ZDM_HOME/bin/zdmservice start

Verify Patching​

  • 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/zdm2155/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.5"
    label date: 240219.31
    ZDM kit build date: Jan 23 2026 05:48:21 UTC
    CPAT build version: 25.11.0

    ZDM was updated to 21.5.5 as shown in the third line in this example output.