Installing and Configuring the P6 Adapter Release 15.1 March 2015
Contents Installation Tasks... 5 Create a WebLogic 11g Domain for the P6 Adapter Deployment... 6 Create a WebLogic 12c Domain for the P6 Adapter Deployment... 6 Create an Endorsed Folder... 7 Configure P6 EPPM Web Services Message Protection Settings... 7 Disable Content Repository in the Configuration Settings... 9 Set Java Options for the Weblogic Domain... 9 Edit Memory Settings... 10 Start the WebLogic Domain... 11 Deploy the p6adapter.ear File into the WebLogic Domain... 11 Upgrading the P6 Adapter... 13 Preface... 15 Where to Get Training... 15 Where to Get Support (embed)... 15 Legal Notices... 17 3
Installation Tasks This section presents P6 Adapter installation tasks. Notes: Oracle recommends using strong passwords. Strong passwords in Primavera Gateway are defined as passwords containing between 8 and 20 characters and at least one numeric and one alpha character. To further strengthen the password, use a mixture of upper and lower case letters. For security reasons, Oracle strongly recommends that you replace the default database users' passwords immediately after a manual database installation or an upgrade. Do not use special characters in the database name, for example: { } [ ] : ; < >,.?! @ # $ % ^ & * ( ) - _ / \ ~ ` _ Deploying the P6 Adapter for P6 EPPM Obtain the P6-ERP_R<release_level>IntegrationSyncServices.zip file from the tools folder of the physical media or download. This zip file contains the following: endorsed folder containing the saaj-impl.jar file p6adapter file Unzip these files to a local directory. Then follow the instructions in this document to deploy and configure the adapter. In This Section Create a WebLogic 11g Domain for the P6 Adapter Deployment... 5 Create a WebLogic 12c Domain for the P6 Adapter Deployment... 6 Create an Endorsed Folder... 7 Configure P6 EPPM Web Services Message Protection Settings... 7 Disable Content Repository in the Configuration Settings... 9 Set Java Options for the Weblogic Domain... 9 Edit Memory Settings... 10 Start the WebLogic Domain... 11 Deploy the p6adapter.ear File into the WebLogic Domain... 11 5
Installing and Configuring the P6 Adapter Create a WebLogic 11g Domain for the P6 Adapter Deployment You need to create a WebLogic domain on which to deploy your P6 Adapter. To create the WebLogic domain for your P6 Adapter: 1) Run the Oracle WebLogic Configuration Wizard. 2) On the Welcome page, select Create a new WebLogic domain and select Next. 3) On the Select Domain Source page, select Next to accept the default selections. 4) In the Specify Domain Name and Location: a. Enter the domain name. b. Enter the domain location. c. Select Next. 5) On the Configure Administrator Username and Password page: a. In the Name field, enter your user name. b. In the User password field, enter your password information. c. In the Confirm user password field, re-enter your password. d. Select Next. 6) On the Configure Server Start Mode and JDK page: a. In the WebLogic Domain Startup Mode pane, select Production Mode. Note: Do not install the domain in the default Development Mode. It leads to P6Adapter issues. b. In the JDK Selection pane, select one of the options. If you select Available JDKs, select one of the JDKs and click Next. If you select Other JDK, enter or browse for a location in the Location field and select Next. 7) On the Select Optional Configuration page, select Administration Server and then select Next. 8) On the Configure the Administration Server page: a. Complete the page as applicable. Ensure that the listen port is an unused port, and document the port you use for your records. b. Select Next. 9) In the Configuration Summary page, review the configuration and select Create. 10) In the Creating Domain page, select Done. Create a WebLogic 12c Domain for the P6 Adapter Deployment You need to create a WebLogic domain on which to deploy your P6 Adapter. The following instructions represent the creation of a basic WebLogic server domain. To create the WebLogic domain for your P6 Adapter: 6
Installation Tasks Note: Click Next after each step. 1) Run the Oracle WebLogic Configuration Wizard. 2) On the Configuration Type page, do the following: a. Select Create a new domain. b. In the Domain Location field, enter the path to the new domain, or click Browse to create the domain directory. 3) On the Templates page, do the following: a. Select Create Domain Using Product Templates and then select the Basic WebLogic Domain - 12.1.3 [wlserver] check box. 4) On the Administrator Account page, specify the username and password for the domain's administrator account 5) On the Domain Mode and JDK page, do the following: a. Select Production. Note: Do not install the domain in the default Development Mode. It leads to P6Adapter issues. b. Select the JDK to use in the domain or click Browse to navigate to the JDK you want to use. 6) [Optional] On the Advanced Configuration page, select the check box for each category (if any) for which you want to perform advanced configuration tasks. Refer to the Fusion Middleware Creating Domains Using the Configuration Wizard guide for more information about the pages that result from the selection of any of the check boxes. 7) On the Configuration Summary page, click Create. 8) Select Done. Create an Endorsed Folder You need to create an endorsed folder to properly configure your P6 Adapter. To create an endorsed folder: 1) Locate the folder that contains the JDK you used when you created the WebLogic domain. This folder is known as <JDK_HOME>. If it does not already exist, create an endorsed folder: <JDK_HOME>/jre/lib/endorsed. 2) In the <p6adapter_install_home>/endorsed folder, locate the saaj-impl.jar file. 3) Copy the saaj-impl.jar file to the endorsed folder you created (<JDK_HOME>/jre/lib/endorsed). Configure P6 EPPM Web Services Message Protection Settings The P6 Adapter uses Web Services to connect to a P6 EPPM deployment. You need to configure your Message Protection settings for your P6 EPPM applications. You use these settings when you configure your P6 Adapter using the following procedure: 7
Installing and Configuring the P6 Adapter 1) Launch the Primavera P6 Administrator. Change to the <p6home>\p6 folder, where <p6home> is the location you specified when installing P6 EPPM. On Windows, run the adminpv.cmd file. On Solaris/Linux, run the adminpv.sh script. 2) Enter your privileged user name and password for the Primavera database (for example, privuser). 3) In the Configurations tab, expand your configuration. 4) Navigate to a configuration to modify. 5) On the Configurations tab: a. Set the Web Services/Security/Authentication/Mode setting to Username Token Profile. b. Set the Web Services/Security/Authentication/Username Token Profile settings for Nonce and Created. 1. Set Nonce/Require Nonce to false or true, depending on your requirements. If you set this field to true, you must select Enable Encryption when you configure the P6 Deployment in Primavera Gateway. 2. Set Created/Require Created to false. c. Set the Web Services/Security/Message Protection settings: 1. Set Require Timestamp to false. 2. Set Require Digital Signatures for Incoming Messages to false or true, depending on your requirements. If you set this field to true, you must select Enable Encryption when you configure the P6 Deployment in Primavera Gateway. 3. Do one of the following: If you are not using encryption, set Require Encryption for Incoming Messages to false. If you are using encryption, set Require Encryption for Incoming Messages to true and then set the following KeyStore properties: KeyStore Type: JKS File location: Enter the location of the file on which the KeyStore resides. KeyStore Password: Enter the KeyStore password. Private Key Alias: Enter the alias of the private key. Private Key Password: Enter the password that is associated with the private key. d. Select Save Changes. Note: With this version of P6 Adapter, only WS-Addressing version 200508 is supported. Ensure that the WS-Addressing element in the Request header contains the Message ID attribute. 8
Installation Tasks Disable Content Repository in the Configuration Settings P6 Adapter does not work when the content repository is enabled in the configuration used by P6Adapter in the P6 Administrator Application. You must disable the content repository setting, in the P6 Administrator Application as follows: 1) In the Configurations tab, create a new configuration or select an existing <Configuration Name>, then select, Database, Instance, Content Repository. 2) Select None as the value for the Content Repository. 3) If needed, modify the BREBootstrap.xml file to point to the correct configuration which has the repository disabled for the P6 adapter. Set Java Options for the Weblogic Domain To set the location of your P6 bootstrap file. 1) Navigate to <P6_Adapter_Domain_Home>\bin and click startweblogic.cmd (Windows) or startweblogic.sh (non-windows) file for the WebLogic domain in which you will deploy the p6adapter.ear file. 2) Add the following JVM option to the startweblogic startup script: On Windows: set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dprimavera.bootstrap.home=<BOOTSTRAP_HOME> -Djavax.xml.soap.MessageFactory=com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1I mpl -Djavax.xml.soap.SOAPConnectionFactory=weblogic.wsee.saaj.SOAPConnectionFactoryImpl On non-windows: JAVA_OPTIONS="${SAVE_JAVA_OPTIONS} -Dprimavera.bootstrap.home=<BOOTSTRAP_HOME> -Djavax.xml.soap.MessageFactory=com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1I mpl -Djavax.xml.soap.SOAPConnectionFactory=weblogic.wsee.saaj.SOAPConnectionFactoryImpl" Tips Note: Replace <P6_BOOTSTRAP_HOME> in the preceding lines with the location that contains a BREbootstrap.xml file. Important terms and applications that you should be familiar with when you configure the Weblogic Domain: Configuration: A P6 database record that contains a group of settings that determines how the P6 Application runs. A P6 database can hold multiple configuration records in the database. BREBootStrap.xml: An XML file that points to a particular configuration record within a particular database. The configuration record is identified by the configuration name. dbconfig.cmd or dbconfig.sh: A tool that allows you to create a BREBootstrap.xml file AND create or use an existing configuration record. The BREBootstrap.xml file is created in the same directory as the dbconfig.cmd file. If a BREBootstrap.xml exists in that directory, the dbconfig.cmd utility overwrites the existing BREBootstrap.xml file. P6 Administrator application (adminpv.cmd or adminpv.sh): Allows you to subsequently change the details of any configuration that lives in the database pointed to by BREBootstrap.xml. 9
Installing and Configuring the P6 Adapter Edit Memory Settings Oracle recommends that you set the following memory parameters for the typical environment that is hosting the P6 Adapter. 1) Determine which JDK you are using for your P6 Adapter domain. 2) Determine whether the application server that is hosting the P6 Adapter domain is running on a 64 bit operating system. If the application server is running on a 64 bit operating system, determine whether the application server is using the 64 bit mode when hosting the domain: a. Locate and open the following file: Windows For Weblogic 11g: <Middleware_home>\<wlserver_home>\common\bin\commEnv.cmd For WebLogic 12c: <Middleware_home>\wlserver\common\bin\commEnv.cmd Linux For WebLogic 11g: <Middleware_home>/<wlserver_home>/common/bin/commEnv.sh For WebLogic 12c: <Middleware_home>/wlserver/common/bin/commEnv.sh b. Search for the following line and set <setting> to True: Windows set JAVA_USE_64BIT=<setting> Linux JAVA_USE_64BIT=<setting> c. Close the commenv.cmd / commenv.sh file. 3) Locate and open the following file: Windows <P6_Adapter_Domain_Home>\bin\setDomainEnv.cmd Linux <P6_Adapter_Domain_Home>/bin/setDomainEnv.sh 4) Make the following edits to the setdomainenv.cmd / setdomainenv.sh file: a. Search for the following line: Windows set MEM_ARGS_64BIT=%WLS_MEM_ARGS_64BIT% Linux MEM_ARGS_64BIT="${WLS_MEM_ARGS_64BIT}" b. Replace the line above with the following lines: Windows @REM set MEM_ARGS_64BIT=%WLS_MEM_ARGS_64BIT% 10
Installation Tasks set MEM_ARGS_64BIT=-XX:NewSize=256m -Xms1024m -Xmx1024m Linux # MEM_ARGS_64BIT="${WLS_MEM_ARGS_64BIT}" MEM_ARGS_64BIT="-XX:NewSize=256m -Xms1024m -Xmx1024m 5) Save the changes to the setdomainenv.cmd / setdomainenv.sh file. 6) Restart the WebLogic domain. Start the WebLogic Domain To start the WebLogic domain for the P6 Adapter deployment: 1) Launch startweblogic.cmd (or startweblogic.sh for Linux) at <Domain home>\bin. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin 2) When prompted, enter the administrator user name and password for the P6 Adapter domain. 3) After the domain starts, open the WebLogic Administration Console, for example: http://localhost:7001/console 4) In the console, enter the administrator user name and password for the domain. Deploy the p6adapter.ear File into the WebLogic Domain To deploy the p6adapter.ear into the WebLogic domain using the WebLogic Administration Console: 1) In the Change Center pane, select Lock & Edit. 2) In the Domain Structure pane, select Deployments. 3) In the Summary of Deployments pane, select Install. 4) In the Install Application Assistant pane: a. Specify the path to the p6adapter.ear file and select Next. For example: c:\install_home\p6adapter.ear. b. Select Install this deployment as an application and select Next. c. Accept the defaults and select Next. d. Review the configuration settings you have chosen and select Finish to complete the installation. 5) In the Settings for p6adapter window, select Save. 6) In the Change Center pane, select Activate Changes. 7) In the Domain Structure pane, select Deployments. 8) In the Summary of Deployments pane: a. Select p6adapter. b. Select the down arrow to the right of the Start button and select Servicing all requests. 9) In the Start Application Assistant pane, select Yes. 11
Installing and Configuring the P6 Adapter Note: The p6adapter state column should be Active. If the state is Start Running, refresh the screen until the status is changed to Active. 12
Upgrading the P6 Adapter To deploy a new version of the P6 Adapter, you must perform the following tasks in the WebLogic Administration Console: 1) Log in to the WebLogic Administration Console with administrator credentials. 2) Delete the current deployment of the p6adapter.ear file as follows: a. In the Deployments pane, click Stop, Force Stop Now. b. In the Stop Deployments screen, click Yes to confirm. In the Deployments pane, the State of the p6adapter.ear will now display Prepared. c. In the Change Center pane, click Lock and Edit. d. In the Deployments pane, select p6adapter.ear and click the Delete button. e. In the Delete Deployments screen, click Yes to confirm. f. In the Change Center pane, click the Activate Changes button. The current P6 adapter deployment is deleted. 3) Follow instructions to Deploy the p6adapter.ear File into the WebLogic Domain (on page 11). 13
Preface This document discusses installation tasks associated with the P6 Adapter. In This Section Where to Get Training... 15 Where to Get Support (embed)... 15 Where to Get Training To access comprehensive training for all Primavera products, go to: http://education.oracle.com Oracle Learning Library The Oracle Learning Library (OLL) provides online learning content covering Primavera products. Content includes whitepapers, videos, tutorials, articles, demos, step-by-step instructions to accomplish specific tasks, and self-paced interactive learning modules. To access the learning library s Primavera content, go to: http://www.oracle.com/oll/primavera Where to Get Support (embed) Access to Oracle Support Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/us/support/contact-068555.html or visit http://www.oracle.com/us/corporate/accessibility/support/index.html if you are hearing impaired. Using Primavera's Support Resource Centers Primavera s Support Resource Center provides links to important support and product information. Primavera's Product Information Centers (PICs) organize documents found on My Oracle Support (MOS), providing quick access to product and version specific information such as important knowledge documents, Release Value Propositions, and Oracle University training. PICs also offer documentation on Lifetime Management, from planning to installs, upgrades, and maintenance. Visit https://support.oracle.com/epmos/faces/documentdisplay?id=1486951.1 to access links to all of the current PICs. PICs also provide access to: 15
Installing and Configuring the P6 Adapter Communities which are moderated by Oracle providing a place for collaboration among industry peers to share best practices. News from our development and strategy groups. Education via a list of available Primavera product trainings through Oracle University. The Oracle Advisor Webcast program brings interactive expertise straight to the desktop using Oracle Web Conferencing technology. This capability brings you and Oracle experts together to access information about support services, products, technologies, best practices, and more. 16
Legal Notices Oracle Primavera Prime Installing and Configuring the P6 Adapter Copyright 2011, 2014, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. This software or hardware and documentation may provide access to or information on content, products and services from third-parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services. 17