Uploading Customization Files Using the Configuration Utility

Use this procedure if a customization includes include XML files, jar files, and other files such as Java customization. If you have installed Gateway on a managed server, see Supporting Java Customization on a Managed Server for more details.

Note: If a customization does not include any jar files, and uses Groovy customization, then upload the XML file from the Gateway user interface.

To add or remove customization files in Gateway:

  1. Stop the Gateway domain before adding or removing providers or customizations.
  2. Ensure the following:
    • The bin folder of the supported Java JDK is included in the PATH.
    • If there are other JDK bin folders in the PATH, it should be listed first.
  3. Navigate to the <Primavera_Gateway_Home>/pdi/snapshots/dbsetup-dist folder.
  4. If you are installing on a non-Microsoft Windows system, type the following command for execute privileges:

    chmod 755 Gateway-Configuration.sh

  5. Run the following command:
    • For Windows installations, run Gateway-Configuration.bat
    • For Linux and Solaris installations, run ./Gateway-Configuration.sh
  6. In the Primavera Gateway Configuration Utility dialog box, enter the following information:
    1. Select Manage Customizations, and select Next.

      Selecting this option updates the pdi.ear file and the Gateway database with custom metadata from the customization XML files.

    2. In the Select Gateway ear file (pdi.ear) location, enter or select Browse to locate the .ear file.
    3. In the Installed Gateway Customizations field, review the list of customization files displayed in the dialog box, and perform any of the following actions:
      • To add a customization, select Add Customization, and navigate to the folder location of the customization file.
      • To remove a customization from the list, select a specific customization, and select Remove.
      • To delete a customization from the database and the pdi.ear file, select the Delete option and select Remove.
  7. Enter the following database connection details:
    • DBA User Name: Enter the name of the database administrator.
    • DBA Password: Enter the password for the database administrator.
    • Database Host: Enter the host name of the Oracle database on which you will be updating the Primavera Gateway database.
    • Database Host Port: Enter the port number of the Oracle database.
    • Database Name: Enter the Gateway database name and select any of the following methods to connect to the database.
      • SID: Enter the SID of the Oracle database.
      • Service: Enter the service name of the Oracle database.
    • Schema Owner: Enter the name of Gateway schema owner. (This name should match the name that was entered when you installed Primavera Gateway.)
    • Schema Password: Enter the password for the schema owner.
    • Select Test Connection. Modify the applicable fields if the connection fails and repeat as necessary.
    • Select Update. The status field displays a success message.

Select Finish to exit the configuration utility.

Related Topics

Deploying a Customization

Supporting Java Customization on a Managed Server



Legal Notices
Copyright © 2013, 2015, Oracle and/or its affiliates. All rights reserved.

Last Published Wednesday, March 25, 2015