Share this page

# 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 OpenText 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 OpenText 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. Open the server.conf file and then make the following updates to the server configuration parameters:

      - 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.

   2. 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

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: