Setting Up Zero Downtime Migration Software

2 Setting Up Zero Downtime Migration Software

Whether you are performing a new Zero Downtime Migration software installation, updating existing software to the latest release, or removing the software, read the appropriate topics carefully as there may have been changes since the last time you performed the task.

Always see the Zero Downtime Migration Release Notes for the latest information about known issues. Also, see the README file included with the downloaded Zero Downtime Migration software for any additional information about software installation and updates.

Performing a New Zero Downtime Migration Software Installation
If a host has not had Zero Downtime Migration software installed on it previously, verify that it complies with the requirements and perform any pre-installation tasks, then download and install the software. Once the software is installed, the host is referred to as the Zero Downtime Migration service host.
Updating Zero Downtime Migration Software
If you already have Zero Downtime Migration software installed on a host, you can update it to the lastest release. Zero Downtime Migration software updates give you the latest fixes while retaining existing job information, metadata, and log files.
Uninstalling Zero Downtime Migration Software
Remove Zero Downtime Migration software from the Zero Downtime Migration service host.

Performing a New Zero Downtime Migration Software Installation

If a host has not had Zero Downtime Migration software installed on it previously, verify that it complies with the requirements and perform any pre-installation tasks, then download and install the software. Once the software is installed, the host is referred to as the Zero Downtime Migration service host.

Prepare a Host for Zero Downtime Migration Software Installation
Provision a host with the following prerequisites and complete the following preinstallation tasks before installing Zero Downtime Migration software on it.
Install Zero Downtime Migration Software
Download the Zero Downtime Migration software and install it on the Zero Downtime Migration service host.

Parent topic: Setting Up Zero Downtime Migration Software

Prepare a Host for Zero Downtime Migration Software Installation

Provision a host with the following prerequisites and complete the following preinstallation tasks before installing Zero Downtime Migration software on it.

The Zero Downtime Migration service host should be a dedicated system, but it can be shared for other purposes; however, the Zero Downtime Migration service host should not have Oracle Grid Infrastructure running on it.
Zero Downtime Migration software requires a standalone Linux host running Oracle Linux 7 or later.
The Zero Downtime Migration service host must be able to connect to the source and the target database servers.
Ensure that the Linux host has 100 GB of free storage space.
You may use an existing user, or, on the Zero Downtime Migration service host, as root user, create a zdm group and add zdmuser user to the group.

For example,
```
root> groupadd zdm
root> useradd –g zdm zdmuser
```
Verify that the glibc-devel and expect packages are installed.

For Oracle Linux 7 installations with Base Environment "Minimal Install" you also need to install the packages unzip libaio oraclelinux-developer-release-el7.
Verify that the /etc/hosts entry for the host name and IP address are configured as expected, so that the host selected for Zero Downtime Migration software installation resolves to the correct IP address and the IP address is reachable with ping.
During the installation, the script might report any missing packages and instructions for setting appropriate values for kernel parameters. Be sure to install the missing packages and set the kernel parameters before the Zero Downtime Migration software installation.

Parent topic: Performing a New Zero Downtime Migration Software Installation

Install Zero Downtime Migration Software

Download the Zero Downtime Migration software and install it on the Zero Downtime Migration service host.

All commands are run as zdmuser.

Download the Zero Downtime Migration software kit from https://www.oracle.com/database/technologies/rac/zdm-downloads.html to the Zero Downtime Migration service host.
Install the Zero Downtime Migration software as a non-root user.
In this example the installation user is zdmuser.
1. Change to the directory to where Zero Downtime Migration software is downloaded and unzip the software.
```
zdmuser> cd zdm_download_directory
zdmuser> unzip zdmversion.zip 
```
2. Run the Zero Downtime Migration installation script.
```
zdmuser>./zdminstall.sh setup oraclehome=zdm_oracle_home oraclebase=zdm_base_directory
        ziploc=zdm_software_location –zdm
```
  - zmdinstall.sh is the installation script
  - oraclehome is the Oracle Home where the Zero Downtime Migration software will be installed
  - oraclebase is the base directory where all of the Zero Downtime Migration configuration files, logs, and other artifacts are stored
  - ziploc is the location of the compressed software file (zip) included in the Zero Downtime Migration kit
  For example,
```
zdmuser>./zdminstall.sh setup oraclehome=/u01/app/zdmhome
        oraclebase=/u01/app/zdmbase ziploc=/u01/app/oracle/zdm/shiphome/zdm_home.zip
        –zdm
```
Hereafter, the oraclehome value is referred to as ZDM_HOME, and the oraclebase value is referred to as ZDM_BASE.

Ignore the following messages which are displayed on the terminal at the end of installation. There is no need to run these scripts.
```
As a root user, execute the following script(s):
        1. $ZDM_HOME/inventory/orainstRoot.sh
        2. $ZDM_HOME/root.sh
```
Start the Zero Downtime Migration service as user zdmuser.
```
zdmuser> $ZDM_HOME/bin/zdmservice start
```
You must start zdmservice before you can migrate your databases using Zero Downtime Migration.

If you must stop the Zero Downtime Migration service, run the following command.
```
zdmuser> $ZDM_HOME/bin/zdmservice stop
```

Verify that the Zero Downtime Migration service installation is successful.

When you run the following command, the output should be similar to that shown here.

zdmuser> $ZDM_HOME/bin/zdmservice status
---------------------------------------
        Service Status
---------------------------------------
 
Running: true
Tranferport: 5000-7000
Conn String: jdbc:derby:/u01/app/zdmbase/derbyRepo;create=true
Repo Path: /u01/app/zdmbase/derbyRepo
RMI port: 8895
HTTP port: 8896
Wallet path: /u01/app/zdmbase/crsdata/fopds/security

Parent topic: Performing a New Zero Downtime Migration Software Installation

Updating Zero Downtime Migration Software

If you already have Zero Downtime Migration software installed on a host, you can update it to the lastest release. Zero Downtime Migration software updates give you the latest fixes while retaining existing job information, metadata, and log files.

Before you begin the software update, review the following requirements.

Verify that your existing Zero Downtime Migration software install location has at least 15GB free space.
Important: Run the update script from outside of the currently installed Zero Downtime Migration home.

Running the script from within a Zero Downtime Migration home results in home install and uninstall failures and leaves the service in an inconsistent state.
The path specified in ziploc should have read/write access for zdmuser.
All of the commands in the following procedure should be run as the existing Zero Downtime Migration software owner. For example, run as zdmuser in the examples that follow.

Download the Zero Downtime Migration software kit from https://www.oracle.com/database/technologies/rac/zdm-downloads.html to the Zero Downtime Migration service host.
Change to the directory to where Zero Downtime Migration software is downloaded and unzip the software.
```
zdmuser> cd zdm_download_directory
zdmuser> unzip zdmversion.zip 
```
Run the zdminstall.sh script as the exiting Zero Downtime Migration home owner to update the software from the software download location.
```
zdmuser>./zdminstall.sh update oraclehome=existing_zdm_oracle_home
   ziploc=zdm_software_location –zdm
```
- zmdinstall.sh is the installation and update script
- oraclehome is the Oracle Home value where the existing Zero Downtime Migration software is installed
- ziploc is the location of the compressed software file (zip) included in the Zero Downtime Migration kit
For example,
```
zdmuser>/u01/app/oracle/zdm/shiphome/update/zdminstall.sh update
     oraclehome=/u01/app/zdmhome
     ziploc=/u01/app/oracle/zdm/shiphome/update/zdm_home.zip -zdm
```
The update script does the following operations.
1. Backs up the existing Zero Downtime Migration home (ZDM_HOME) and ZDM_BASE into software download location
2. Stops the currently running Zero Downtime Migration service
3. Removes the currently installed Zero Downtime Migration home
4. Installs the new binaries in the Zero Downtime Migration home
5. Restores the configuration data.
Start the Zero Downtime Migration service as user zdmuser.
```
zdmuser> $ZDM_HOME/bin/zdmservice start
```
You must start zdmservice before you can migrate your databases using Zero Downtime Migration.

If you must stop the Zero Downtime Migration service, run the following command.
```
zdmuser> $ZDM_HOME/bin/zdmservice stop
```

Verify that the Zero Downtime Migration service installation is successful.

When you run the following command, the output should be similar to that shown here.

zdmuser> $ZDM_HOME/bin/zdmservice status
---------------------------------------
        Service Status
---------------------------------------
 
Running: true
Tranferport: 5000-7000
Conn String: jdbc:derby:/u01/app/zdmbase/derbyRepo;create=true
Repo Path: /u01/app/zdmbase/derbyRepo
RMI port: 8895
HTTP port: 8896
Wallet path: /u01/app/zdmbase/crsdata/fopds/security

Parent topic: Setting Up Zero Downtime Migration Software

Uninstalling Zero Downtime Migration Software

Remove Zero Downtime Migration software from the Zero Downtime Migration service host.

All commands are run as zdmuser.

Stop the Zero Downtime Migration service.
```
zdmuser> $ZDM_HOME/bin/zdmservice stop
```
Run the following command to uninstall the software.
```
zdmuser> $ZDM_HOME/bin/zdmservice deinstall
```

Parent topic: Setting Up Zero Downtime Migration Software