Before installing the local-mode P6 Integration API, you need to install P6 EPPM. Additionally, you must uninstall any earlier versions of the local P6 Integration API before installing the current version.
The local-mode P6 Integration API Installer provides a wizard to guide you through the installation process, which includes:
- Choosing the installation mode
- Installing the P6 Integration API libraries
- Setting up and configuring the P6 Integration API database
To install local-mode P6 Integration API:
- Download the P6 Integration API part from the P6 EPPM media pack and then extract it.
- Depending on your operating system, change your directory to the media pack part by running one of the following:
- With Windows, navigate to the win\Disk1\install directory and double-click setup.exe.
- With UNIX or Linux, do the following:
- Change your directory using the following command:
cd <Operating_System>\Disk1\install
where <Operating_System> is linux64.
- Enter the following commands:
chmod 755 runInstaller
chmod 755 unzip
./runInstaller
- Click Next.
- On the Welcome screen, click Next.
- On the Select the Installation Type screen, specify the installation mode.
- Local Mode Packages Only: Choose this option to use the P6 Integration API in local mode, without Java RMI.
This option installs database configuration tools and javadoc. - Client Side Packages Only: Choose this option to install client-side libraries and documentation. This option is required for the remote API.
Notes:
- The maximum number of clients that can access a remote server at one time is approximately 50. This number might be less, depending on multiple factors (for example, system hardware, network configuration, and so on)
- When using the P6 Integration API in Remote Mode with the client and server in different time zones, the time of day fields in the client are based on the local time by default (not the server time). If you want the times to match, you can first set the time zone in your client code to be the same as the server time zone for each thread that calls P6 Integration API code.
- Local Mode Packages Only: Choose this option to use the P6 Integration API in local mode, without Java RMI.
- In the Specify Home Details screen:
- In the Name field, enter a name for the P6 Integration API.
- In the Path field, specify the installation location for the P6 Integration API files.
- Click Next.
- In the Available Product Components screen, select the components to install and click Next.
- In the JDK Home Directory screen, enter or browse to the location where JDK is installed.
- In the Summary screen, click Install.
Notes:
- If you installed the local mode package, the Configuration Assistants screen appears after the installation finishes. Do not close this screen. After a short time, the Database Configuration dialog box opens.
- If you installed the client side package, your installation is complete. You can exit the wizard now and skip the remaining steps in this section.
- In the Database Configuration dialog box:
- Choose the database type: Oracle, ATP, or Microsoft SQL Server.
Note: You can later change the database type through the P6 Integration API Database Configuration Setup wizard.
- Click Next.
- Specify the database connection parameters.
- Click Next.
Note: The P6 Integration API requires pubuser access (in the User Name field) to the database. The database name, host address, and host port are specific to your Oracle or Microsoft SQL Server installation. Database Host Port displays the default port for the database type you selected. You can edit this port.
- If the installer detects an existing configuration screen, choose the appropriate action.
Notes:
- If your site includes P6, you can share a new P6 Integration API configuration with P6. However, P6 cannot share an existing configuration with P6 Integration API because it will not support the new P6 Integration API configuration settings.
- If a configuration does not exist, the The installer has detected an existing. . . screen does not appear and the installation process automatically creates a default configuration named Primavera Configuration. You can edit the settings for this configuration through the Primavera P6 Administrator.
- After installation, you can use the Database Configuration Setup wizard to choose or create a different configuration.
- See the P6 EPPM System Administration Guide for more information about configurations.
- Choose the database type: Oracle, ATP, or Microsoft SQL Server.
- When the message displays to confirm the database configuration has completed successfully, click OK.
Click Exit.