Quick Start

This article covers the steps required to deploy the pdbctl utility.

Prerequisites

• 64-bit machine with JDK 1.8.0_252 or higher version.

• CDP is installed.

• Key Manager should be accessible from the utility.

• The utility should be able to connect with the database where CDP clients are installed. However, for fast processing, it is recommended to deploy the utility on the same machine.

Extract the pdbctl Utility

1. Unzip the pdbctl_v1.x.x.zip file.

   The screenshots provided in this article are from a Linux machine.

   

   For Java 9 and higher versions, download and add the following jar files in the classes folder of the pdbctl utility:

   • activation-1.1.1

   • jaxb-api-2.3.1

   • jaxb-core-2.3.0.1

   • jaxb-impl-2.3.1

2. Set the parameters in the IngrianNAE.properties file for the pdbctl utility. The file’s location is /pdbctl/classes/IngrianNAE.properties. These parameters are described in the Configuration section.

   Set the Key Manager IP (NAE_IP) and port (NAE_Port) similar to ones set for the CDP clients.

3. Set the environment variable PDB_MUTIL_PATH to the directory where pdbctl is extracted.

   For Linux machines, run the following command:

       export PDB_MUTIL_PATH=<location of pdbctl>
   

   For Windows machines, run the following command

       set PDB_MUTIL_PATH=<location of pdbctl>
   

The utility can now be used along with CDP and Key Manager for data migration.

Run the pdbctl Utility

To run the utility:

1. Navigate to the directory where the utility is extracted.

2. Run the utility.

   • On Linux machines, run:

         ./pdbctl
     

     It will display the available commands for the pdbctl utility. To know more about the commands, use the following syntax:

         ./pdbctl <command> -h
     

     

   • On Windows machines, run:

         pdbctl.exe
     

     It will display the available commands for the pdbctl utility. To know more about the commands, use the following syntax:

         pdbctl.exe <command> -h