Use this procedure if a customization includes XML files, jar files, and other files such as Java customizations. If you have installed Gateway on a managed server, see Updating the gateway.ear File for On-Premises 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.
Prerequisites
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.
- Sign in to WebLogic as an administrator and stop the Gateway domain before adding customizations.
- If you are using a non-Microsoft Windows system, type the following command for execute privileges:
chmod 755 Gateway-Configuration.sh
Procedure
To add customization files in Gateway:
- Navigate to any of the following folder locations:
- <Primavera_Gateway_Home>/gateway/app/utilities folder
where
<Primavera_Gateway_Home> is the installed location of Gateway.
- <Gateway Download Folder>/GenericInstaller/GatewayUtility folder.
- <Primavera_Gateway_Home>/gateway/app/utilities folder
- Run the following command:
- For Windows installations, run Gateway-Configuration.bat
- For Linux and Solaris installations, run ./Gateway-Configuration.sh
- In the Primavera Gateway Configuration Utility dialog box:
- Select Manage Customizations to update the gateway.ear file and the Gateway database with custom metadata from the customization XML files.
Note: Select Next on each screen to advance to the next step.
- In the Select Gateway ear file (gateway.ear) location field, enter or select Browse to locate the .ear file in the <Primavera_Gateway_Home>/gateway/app/utilities folder.
- In the Installed Gateway Customizations field, select Add Customization and navigate to the folder location of the customization file.
- 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.
- Select Manage Customizations to update the gateway.ear file and the Gateway database with custom metadata from the customization XML files.
- Redeploy gateway.ear in WebLogic to ensure the changes are reflected in Primavera Gateway. For more details, see Updating the gateway.ear File for On-Premises.