Upgrading Primavera Gateway
Primavera Gateway upgrade will only upgrade the Gateway database not the existing installation or domain. You will need to install Primavera Gateway application in a new directory and deploy to a new domain (or manually update the deployment).
Note: When the new domain is created by the installer the memory setting, users and other settings must be manually reset after installation. For example, if Gateway 1.0 has 2GB of memory, the installer will set 1GB and it must be modified manually to 2GB after the installation. Similarly with Gateway users, LDAP settings, and HTTPS settings.
For Linux and Solaris Installations
- Give execute permission to run the installer using the syntax: chmod 755 <file name>
- Depending on the operating system, execute ./runInstaller.sh or setup.exe:
- Linux 64-bit: Execute ./runInstaller.sh file from the linux64/Disk1/install directory
- Solaris 64-bit: Execute ./runInstaller.sh file from the solaris64/Disk1/install directory
- Windows 64-bit: Double-click setup.exe file from the win64\Disk1\install directory
To upgrade Primavera Gateway database, run the Gateway installer selecting the following options in the installation sequence:
- On the Welcome screen, select Next.
- On the Specify Installation Location screen, enter the following information:
- Primavera Home: Enter the path and directory or select Browse to select the directory and path for installing Primavera Gateway.
For Windows installations, the default Primavera home installation location is C:\PrimaveraGateway.
For Linux installations, the default Primavera home installation location is /home/<User ID>/PrimaveraGateway.
For Solaris installations, the default Primavera home installation location is /home/<User ID>/PrimaveraGateway.
- On the Specify Database Installation screen, select Use Existing Database.
- On the Database Connection Details screen, provide the following database connection details:
- Database Host Address: Enter the host name or the server IP address for the Primavera Gateway database.
- Database Host Port: Enter a unique port number for the Gateway database schema. Port number 1521 displays by default.
- Database Name: Enter the database name to connect with the Gateway database. By default, orcl. Select Service to deploy Gateway in a Managed server.
- SID: Select this option to connect to the database using the system identifier.
- Service: Select this option to connect to the database using a service name.
- Schema Owner: Enter the name of the Primavera Gateway database schema owner.
- Schema Password: Enter a case-sensitive password for the schema owner.
- DBA User Name: Enter the user name of the Oracle database administrator.
- DBA Password: Enter the password of the Oracle database administrator.
- Select the Test Connection button to check for database connectivity. If the test is successful, the following message displays: Connection is successful. If the test is not successful, check the port number specified, schema user ID and case-sensitive password combination, SID or Service value, and the database host address.
- On the Select Installation Type screen, select the Install and Configure Primavera Gateway option.
- Select Yes to the Database Version Warning message: The existing database schema uses an old Gateway database version. If you continue, the database will be upgraded to the latest version. Do you want to continue?
- On the Specify Middleware Location screen, enter the following information regarding the WebLogic installation:
- Oracle Middleware Home: Enter or select Browse to navigate the path and locate the Middleware folder.
- WebLogic Server Directory: Enter or select Browse to navigate the path and locate the WebLogic server directory. For example, C:\<WebLogic_Home>\wlserver.
- Domain Location: Enter or select Browse to navigate and locate the WebLogic domain folder. For example, C:\<WL_Server_Home>\wl1213\user_projects\domains.
- On the New Domain Details screen, enter the following information to create the WebLogic domain for Primavera Gateway:
- On the Gateway Administrator Details screen, create a user profile for a Primavera Gateway administrator as follows:
- Gateway Administrator User Name: Enter a name for the Primavera Gateway administrator. The admin user, GatewayAdmin, displays by default.
- Gateway Administrator Password: Enter an alphanumeric password of at least 8 characters for the Primavera Gateway administrator.
- Confirm Password: Re-enter the case-sensitive password.
- On the Specify Java Development Kit Location screen, enter the following information:
- On the Install Primavera Providers screen, the following Primavera providers will be installed by default:
- EnterpriseTrack
- P6
- Prime
- Unifier
Select the Restore Providers button to restore all primavera providers in the displayed list.
Select the Remove Provider button to remove a selected provider from the displayed list.
- On the Select Third Party Providers screen, select the providers you wish to install.
- Primavera's Sample Provider: Select this option to install the Primavera sample provider packaged with Gateway. This option is selected by default.
- Third-Party Providers: Select this option to add or delete alternative third-party providers.
- Select the Add Provider button to navigate and locate the home directory for each third-party provider. Ensure that the lib sub-folder includes the provider's jar file, the data sub-folder includes the metadata xml files. The optional supplement sub-folder can contain any additional files. Folder names are case-sensitive.
- Select the Delete Provider button to delete a selected third-party provider from the displayed list.
- Select all other installation options as needed and click Finish.
- Manually configure and restore the domain for the following if the settings were changed from the defaults in the previous domain:
- Recreate Gateway users in the three user role groups: PrimaveraGatewayAdmin, PrimaveraGatewayDeveloper, PrimaveraGatewayUser
- Restore JVM memory setting by editing <Primavera_Gateway_Home>\wlst\setGatewayMemory.cmd (.sh)
- HTTPS Settings
- LDAP Configurations in the Weblogic administrative console of the Gateway domain
- Reinstall customizations using the Gateway configuration utilities in the <Primavera_Gateway_Home>\snapshots\dbsetup-dist folder