2.3 How to Apply This Maintenance Level Release in the PGX Server?

This section describes how to apply this ML release in the PGX Server.

Note:

This section assumes that PGX Server is installed on a separate server. If Compliance Studio and PGX Server are installed on the same server, then skip steps 1 to 3.
To install this ML release in the PGX server:
  1. Download and copy 37649413_GENERIC.zip on to your server (in Binary mode) where Compliance Studio is installed.
  2. Extract the contents of patch archive file using the following command.
    unzip -a <Name of the file to be unzipped>
    For example, unzip -a 37649413_GENERIC.zip
  3. Provide 0755 permission to all files inside 37649413_GENERIC folder. To provide permission, execute the following.
    chmod -R 0755 37649413_GENERIC

    Note:

    The "-a" option is mandatory to unzip the patch. In case you notice an error message "unzip: not found [No such file or directory]" when the package is not installed, contact your UNIX administrator to resolve this issue.
  4. Navigate to the <PATCH_HOME>/bin directory.

    Note:

    <PATCH_HOME> indicates the path where patch contents are extracted.
  5. Open the config.sh file and configure the following parameters.

    Table 2-3 Parameters of config.sh file

    Parameter Significance Value
    COMPLIANCE_STUDIO_INSTALLATION_PATH Indicates the path where the Compliance Studio installer file is extracted. Provide the path where the new installer is extracted.

    For example, /scratch/ testuser/OFS_COMPLIANCE_STUDIO

    Note: This parameter is optional.
    PGX_INSTALLATION_HOME Indicates the path where the pgx-server-<version>.zip file is extracted. Provide the path where the PGX server is extracted.

    Note: This parameter is mandatory.
  6. Navigate to the <PATCH_HOME>/bin directory.

    Note:

    <PATCH_HOME> indicates the path where patch contents are extracted.
  7. To apply the patch, execute the following.
    ./applyPatch.sh -pgx
    Follow the console logs for execution details. In case of any errors, contact My Oracle Support.
  8. Restart PGX server. To restart, execute the following.
    ./pgx-server.sh --restart

    Note:

    The following are the expected behaviour while applying patch in the PGX Server:
    • If PGX is not installed, the patch will update the zip file version if the PGX server zip file is present.
    • The patch will update the necessary files and initiate the process if the unzipped PGX server is present.
    • If it is not configured before applying the patch, then PGX Server start up may give an error. Deployer must either configure the PGX Server properly or remove the unzipped PGX Server folder (pgx-server).
    Backup of old jars and files is present in the <PATCH_HOME>/backup folder.

    Note:

    This patch will create backups of the affected jars, files, and directories, storing them in a backup folder.