Select this installation option to install the Primavera Gateway application, configure the WebLogic domain for Gateway, and create and connect to the Gateway database as follows:
If you want to install and configure an entirely new Primavera Gateway version, a Primavera Gateway database, Gateway domain in WebLogic, and providers delivered with Primavera Gateway are installed and configured as follows:
- Invoke the Primavera Gateway installation wizard.
For Windows 64-bit Installations:
Go to the <Gateway Download Folder>/GenericInstaller folder and run
installGateway.bat.For Linux and Solaris 64-bit Installations:
- Go to the <Gateway Download Folder>/GenericInstaller folder and run
./installGateway.sh. - Give execute permission using the syntax:
chmod 755 installGateway.sh
- Go to the <Gateway Download Folder>/GenericInstaller folder and run
- On the Welcome screen, select Next.
Note: Select Next on each screen to advance to the next step.
- On the Specify Installation Location screen, enter the following information:
Primavera Gateway 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 Select Installation Type screen, select the Install and Configure Primavera Gateway option.
Note: This option is selected by default for all new installations.
- On the Specify Database Installation screen, select any of the following database installation options:
- Install New Database: Select this option to install a new Primavera Gateway database. If the database already exists, enter a new schema owner.
- Use Existing Database: Select this option to install the Primavera Gateway application, and continue using the current Gateway database.
- On the Connection Details screen, enter the following information to connect to the Gateway database:
- 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 of maximum 5 digits 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.
- SID: Select this option to connect to the database using the system identifier.
- Service: Select this option if you choose to connect to the database using a service name.
If you chose Install New Database, enter the following additional information:
- Schema Owner: Enter the name of the Primavera Gateway database schema owner.
- Schema Password: Enter a case-sensitive password for the schema owner.
- Confirm Password: Re-enter the case-sensitive password.
Note: Make a note of the schema owner and password. You will need these to connect to the Gateway database.
- DBA User Name: Enter the user name of the Oracle database administrator.
- DBA Password: Enter the password of the Oracle database administrator.
- Select Test Connection 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.
If you chose Use Existing Database, then enter the Schema Password, and the DBA Password.
- On the Specify JDK and Middleware Locations screen, enter the following information:
- Java Home Directory: Enter or select Browse to locate the JAVA_HOME location that will be used by the WebLogic domain.
Note: Refer to the Tested Configurations document for supported versions of JDK.
- Oracle Middleware Home: Enter or select Browse to the WebLogic Oracle Home directory.
- WebLogic Server Directory: Populates the WebLogic server directory by default. For example, C:/<WebLogic_Home>/wlserver.
- Domain Location: Populates the WebLogic domain folder by default. For example, C:/<WebLogic_Home>/user_projects/domains.
- Java Home Directory: Enter or select Browse to locate the JAVA_HOME location that will be used by the WebLogic domain.
- On the New Domain Details screen, enter the following information to create the WebLogic domain for Primavera Gateway:
- Administrator User Name: Enter a name for the WebLogic domain administrator.
- Administrator User Password: Enter an alphanumeric password of at least 8 characters for the WebLogic domain administrator. Passwords may contain the following special characters: underscore (_), dollar ($), or pound (#).
Note: Make a note of the domain administrator user name and password.
- Confirm Password: Re-enter the case-sensitive password.
- Domain Name: Enter a new WebLogic domain name for Primavera Gateway. For example, PrimaveraGateway. The installer will create a sub-folder with this domain name under the domain location folder provided on the previous screen.
- Administrator Server Port: Enter a unique SSL port number for the new domain.
- Administrator Server SSL Port: Enter a unique port number for the new SSL domain.
- On the Managed Server Details screen, enter the connection details if you are installing Gateway on a managed server:
- Managed Server Deployment: Select this option to deploy Primavera Gateway on a Managed server.
- Managed Server Port: Enter a unique port number for the managed server.
- Managed Server SSL Port: Enter a unique SSL port number for the managed server.
- Node Manager Port: Enter a unique port number for the node manager. The port number 5556 displays by default.
- 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.
- (Optional) If you choose to configure an LDAP Directory, enter the following information and select Next on each screen. These screens display only if you chose to install Primavera Gateway on a managed server:
- On the LDAP Server Details screen, enter the following information:
- Configure LDAP Server: Select this option to configure an LDAP server.
- Directory Server Type: Select the type of LDAP directory server from the drop-down list. Choices include: Oracle Internet Directory, Oracle Unified Directory, Oracle Directory Server Enterprise Edition, and Microsoft Active Directory.
- Server URL: Enter the LDAP server URL in the format, ldap://<oid_host>:<oid_port> or ldaps://<oid_host>:<oid_port>. To use SSL (ldaps), you may need to configure the Custom Trust Keystore for the LDAP server in WebLogic domain before users can authenticate successfully. For more details, refer to WebLogic documentation.
- Server Principal: Enter the Distinguished Name (DN) of the LDAP user that the WebLogic server should use to connect to the LDAP server in the format, cn=<user name>.
- Server Password: Enter the password to connect to the LDAP server.
- Server Search DN: Enter the SearchDN (Base DN) for users and groups in LDAP which will be used by Primavera Gateway to reconcile. Use format dc=<value>.
- On the LDAP Server Attributes screen, enter the following information:
- LDAP Group Container: Enter the full path of the LDAP groups in Distinguished Names (DN) format. For example, for OID, enter cn=groups, dc=myDomain, dc=com. For OU, enter ou = Groups, dc = prim, dc = local.
- LDAP User Container: Enter LDAP user groups in Distinguished Names (DN) format. For example, cn=Users,dc=myDomain,dc=com.
- User Name: Depending on the LDAP server directory type, select the default user name attribute from the drop-down list. Select uid, sn, or cn for Oracle Internet Directory or Oracle Unified Directory. Select cn or sAMaccountname for Microsoft Active Directory. Select cn for Oracle Directory Server.
- User Object: Depending on the LDAP server directory type, select the default object class of users. Select inetOrgPerson, person, or organizationalPerson for Oracle Internet Directory or Oracle Unified Directory; user for Microsoft Active Directory; person or groupOfUniqueNames for Oracle Directory Server.
- Group Attribute: Select the cn attribute that uniquely identifies the group from the drop-down list.
- Group Object: Depending on the LDAP Directory server type, select the attribute that uniquely identifies the object class of groups from the drop-down list. Select groupOfUniqueNames for Oracle Internet Directory and Oracle Unified Directory; groupOfUniqueNames for Oracle Directory Server; group for Microsoft Active Directory.
- On the LDAP Server Details screen, enter the following information:
- On the LDAP Server Mapping screen, enter the name of the LDAP server group that defines each of the following groups:
- Gateway Administrators Group
- Gateway Users Group
- Gateway Developers Group
- Gateway Admins No Data Access Group
- Gateway Users no Data Access Group
LDAP users must either be in this group or in a group assigned to this group.
- On the Install Primavera Providers screen, the following providers will be installed by default:
- EnterpriseTrack
- File
- P6
- Primavera Cloud
- Unifier
Select Restore Providers to restore all primavera providers in the displayed list.
Select Remove Provider to remove a selected provider from the displayed list.
- On the 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 Add Provider 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 Delete Provider to delete a selected third-party provider from the displayed list.
- Do Not Add Provider: Select this option when you choose to install only the Gateway database.
- If you chose to install the P6 provider on the Primavera Providers screen, then set up P6 deployment in Gateway on the Configure P6 Deployment screen:
- Configure P6 Deployment: Select this option to configure P6 deployment in Gateway.
- P6 Webservices Authentication Type: Select Username Token or SAML 2.0 from the list.
- User Name: Enter the name of a P6 administrator with access to projects in P6 EPPM.
- Password: If you chose UserName Token authentication, enter the case-sensitive password of the P6 administrator.
- Endpoint: Enter the URL to connect with P6 Web Services in the format, http:<host name>:<port>/p6ws/services/SyncServiceV1
- P6 Database Instance ID: Enter the database instance ID associated with the P6 application.
- Enable Encryption: Select this option if you want to enable encryption when using P6 web services.
- Keystore File: Enter or Browse... to the keystore file.
For more details on how to generate a keystore file and keystore password, see Enabling Encryption Between Gateway and P6 Web Services for On-Premises. (on premises only)
- Keystore Password: Enter the password for the keystore file.
- Certificate Alias: Enter the certificate alias used for authentication.
- P6 Currency: Enter the base currency for the P6 deployment.
- If you chose to install Unifier provider on the Primavera Providers screen, then set up an Unifier deployment in Gateway on the Configure Unifier Deployment screen:
- Configure Unifier Deployment: Select this option to configure Unifier deployment in Gateway.
- Short Name: Enter the short name of the company used in Unifier.
- Authentication Code: Enter the authentication code to use when data is integrated with Unifier from external systems using web services.
- End Point URL: Enter the URL to connect with Unifier application in the format: http://<host name>:<port>
- The Installation Summary screen displays all the components selected for installation in the previous steps. Review all the selected installation options. Select Save if you want to save the installation summary details in an .ini file. This is also a Saved Response file.
Select Back or select the appropriate window in the left pane to change your install option.
Select Install to begin installing Primavera Gateway.
Note: Save the stored .ini file as a backup of your current installation and configuration choices in a secure location.
- The Installation Progress screen displays a success message on successful completion.
Note: Copy the properties files in the wlst folder to a save location if you want to replicate the installation using the silent installer later.
- The Configuration Progress screen displays the progression of the installation and configuration tasks.
- On the Installation Complete screen, select Finish to complete Primavera Gateway installation and close the wizard.