Migrating to a UNIX Machine

To migrate the PPM Server to a UNIX machine:

1. Obtain a new license key, as described in Obtaining a New License Key.

2. Stop the PPM Server.

   For information about how to stop the PPM Server, see Start and stop the PPM Server on a single-server system.

3. Migrate the PPM file system.

   1. On the PPM Server host machine, navigate to the parent of the <PPM_Home> directory.

   2. Use an archiving utility (such as Tar or Zip) to create an archive file of the entire <PPM_Home> directory.

      Example:

      If the <PPM_Home> directory is named "PPM", run the command:

      $ tar cf ppm930.tar PPM

   3. Use FTP in binary mode to copy the archive file to the target machine. Put the archive file in the parent of the new <PPM_Home> directory.

   4. To extract the archive file, run the command:

      $ tar xf ppm930.tar

      This creates the new PPM Server directory structure. A directory named PPM is created automatically.

4. Migrate the PPM database schema.

   For information about how to migrate the database schema, see Migrating the Database Schemas.

5. Reconfigure the PPM Server in the target location.

   1. Run the kConfig.sh script, which is located in the <PPM_Home>/bin directory.

   The kConfig.sh script starts the server configuration utility, which then displays the values for each server parameter from the previous server configuration.

   2. Browse through all server configuration parameters, and make the following updates:

      • Update all parameters that refer to the DNS name or IP address of the old server to instead refer to the DNS name or IP address of the new server.

      • BASE_URL specifies the Web location (top directory name) of the PPM Server.

      • RMI_URL specifies the port on which the PPM Server listens to initiate RMI client/server communication. (This must be a unique port, distinct from the Web server, SQL*Net, and the HTTP or HTTPS ports.)

      • Update all parameters that reference a specific directory on the old server to instead reference the corresponding directory on the new server. These parameters include:

      • ORACLE_HOME specifies the home directory for the Oracle client tools on the PPM Server machine.

      • BASE_PATH specifies the full path to the directory where the PPM Server is installed.

      • ATTACHMENT_DIRNAME specifies the absolute pathname of the directory where attached documents are to be stored. This directory must give read/write access to Web browsers and, if the system includes an external Web server, exist outside the directory tree.

      • SERVER_TYPE_CODE specifies the operating system on which the PPM Server is installed. Because you are placing the server on a computer running UNIX, make sure you update the value to UNIX.

      • SERVER_NAME specifies the name of the PPM Server instance. If multiple PPM Servers are running on the same machine, this name must be unique for each server.

   3. To implement your changes, run the kUpdateHtml.sh script from the <PPM_Home>/bin directory.

6. Install the new Autopass license key file using the kLicenseInstall.sh tool.

   The license file is installed and becomes effective right away, with a message popping up showing how many licenses are installed.

7. Start the new PPM Server.

Related Information