You are on page 1of 24

Tivoli IBM Maximo Adapter for Primavera

®

Version 7.1

Installation Guide

Note Before using this information and the product it supports, read the information in “Notices” on page 13.

This edition applies to version 7, release 1, modification 0 of IBM Maximo Adapter for Primavera and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2008. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

. . 2008 iii . . . . . . . . . . . . . 14 Chapter 3. . . . . . . . . . . . . . 7 Index . . 17 © Copyright IBM Corp. . Deploying the EAR files . . . . . Configuring Primavera API on WebLogic Server . . . Configuring the adapter . . 9 Configuring connection details . . . . . . . . . . . . Preparing for installation . . . . . . . 2 Chapter 4. . 5 Notices . 9 Configuring the adapter parameters . . . . . . . . . . . . . .Contents Chapter 1. Installing Maximo Adapter for Primavera . . . 5 Enabling the product license . . . 13 Trademarks . . . . . . . . . . . 9 Configuring logging . . . . . 1 . . . . . . . . . . . 1 . . . 11 Enabling work location resource scheduling . . Chapter 2. . 11 Configuring Primavera API on WebSphere Application Server . .

iv IBM Maximo Adapter for Primavera: Installation Guide .

1 Service Pack 2 Information needed for the installation You need a Maximo administrator login. the configuration and content of your application. For remote mode.1 v Primavera Integration API 6. Before you run the installation program. and directory servers are modified.Chapter 1. the Primavera Integration API must be installed on the same server as the Maximo application server. Installation requirements Before you install Maximo Adapter for Primavera. Before you begin For local mode. database. database. you must have Maximo Asset Management 7. These changes are needed to deploy the Maximo EAR file. Configuring Primavera API on WebSphere Application Server If you use WebSphere® Application Server. create backups of the application. © Copyright IBM Corp. Supported versions The following versions of Primavera products are supported: v Primavera Project Manager 6. the Primavera Integration API client must be installed on the same server as the Maximo application server. ensure you have all the administrative user IDs and passwords for the middleware servers.2 v Primavera Integration API 6.1 installed on the same server. Before installing. The installation program requires access to middleware servers that are installed with Maximo Asset Management to automate the deployment of the process solution package. make the following changes to the Primavera Integration API before you install Maximo Adapter for Primavera. Server data backups When you install Maximo Adapter for Primavera. Preparing for installation Ensure that you meet the requirements and have the information needed to install IBM® Maximo® Adapter for Primavera.2 v Primavera Project Manager 6. and directory servers. 2008 1 .

Primavera API root\lib\ spring.Primavera API root\lib\xml-apis.jar.Primavera API root\lib\ k3.jar. The default port is 9099. enter the path to the intgclient. enter the computer name and port for the API URL.119.Primavera API root\lib\ ojdbc14.0.Primavera API root\lib\ spring.jar.jar.Primavera API root\lib\ xercesImpl.jar. Set the API URL field on the Labor record to point to the Primavera Integration API URL.jar.jar.Primavera API root\lib\log4j.jar.jar.jar.Primavera API root\lib\commons-logging. Primavera API root\lib\activation. the Primavera Integration API must be installed on the same server as the Maximo application server. enter the paths to all jar files from the Primavera API lib folder.jar.Primavera API root\lib\ serializer.Primavera API root\lib\commons-lang.Primavera API root\lib\commons-lang.jar.jar.2 Add these paths: Primavera API root\clientlib\intgclient. in the form pcname:port.Primavera API root\lib\intgserver. For local mode.Primavera API root\lib\bcprovjdk14.jar.1 SP2 2.Primavera API root\lib\sqljdbc.Primavera API root\lib\mail. enter localhost.Primavera API root\lib\xalan.jar.jar. For: Remote mode Local mode using Primavera Integration API 6.Primavera API root\lib\intgserver.home=Primavera API root 3.Primavera API root\lib\jdom. Configuring Primavera API on WebLogic Server If you use BEA WebLogic Server.bootstrap. For local mode.Primavera API root\lib\sqljdbc.jar.2.Primavera API root\lib\ojdbc5.jar.jar.jar. enter the following in the Generic JVM arguments field: -Dprimavera.Primavera API root\lib\xalan. add to the Classpath field the paths to the Primavera API files. From the WebSphere console.jar.Primavera API root\lib\xml-apis.Procedure 1.1.jar. 2 IBM Maximo Adapter for Primavera: Installation Guide .jar.jar Local mode using Primavera Integration API 6.jar.Primavera API root\lib\stax-api-1.jar.Primavera API root\lib\ log4j.1.jar file.Primavera API root\lib\wstx-asl-3. v For local mode.Primavera API root\lib\jdom. Before you begin For local mode.jar.jar. make the following changes to the Primavera Integration API before you install Maximo Adapter for Primavera.jar. v For remote mode.jar. Primavera API root\lib\activation.Primavera API root\lib\mail.Primavera API root\lib\commons-logging.jar. For remote mode.Primavera API root\lib\ xercesImpl.jar.Primavera API root\lib\ serializer. These changes are needed to deploy the Maximo EAR file.jar.

Chapter 1.jar.Primavera API root\lib\intgserver.jar.Primavera API root\lib\sqljdbc.jar: Local mode using Primavera Integration API 6.Primavera API root\lib\ojdbc5.home=Primavera API root 5. Search for Dweblogic.Primavera API root\lib\ serializer.Primavera API root\lib\bcprovjdk14.Primavera API root\lib\xml-apis.Primavera API root\lib\ xercesImpl. %SAVE_CLASSPATH% 4.2.Primavera API root\lib\xalan.jar. Search for set CLASSPATH=.jar. b.1 SP2 For example: set CLASSPATH=Primavera API root\clientlib\intgclient.jar.Primavera API root\lib\mail.Primavera API root\lib\stax-api-1.Primavera API root\lib\ spring. use the correct file extension and slash for your operating system.jar.Primavera API root\lib\ serializer.jar.Primavera API root\lib\wstx-asl-3.Primavera API root\lib\ ojdbc14.2 Add these paths: Primavera API root\clientlib\intgclient. For: Remote mode Local mode using Primavera Integration API 6.jar.Primavera API root\lib\commons-logging.jar.jar.For remote mode.jar.jar. add the path to the intgclient.Primavera API root\lib\ k3.jar.jar.jar.119.jar.Primavera API root\lib\log4j.jar.Primavera API root\lib\xml-apis.jar. For local mode.Name=%SERVER_NAME% -Dprimavera. Procedure 1.jar. as follows: Dweblogic.jar. 2.jar.Primavera API root\lib\commons-logging.Primavera API root\lib\commons-lang.Primavera API root\lib\ xercesImpl. open the startWebLogic file in the BEA dir\user_projects\domains\Maximo Server directory.Primavera API root\lib\xalan.bootstrap.jar.1.0. For remote mode.jar.Primavera API root\lib\jdom. Add the following JVM argument at the end of the line.jar.jar.jar. For local mode: a.jar.jar file.Primavera API root\lib\commons-lang.Primavera API root\lib\ spring.Primavera API root\lib\ log4j.Name=%SERVER_NAME%.jar. Using a text editor. Save and close the file.Primavera API root\lib\jdom. 3.jar.Primavera API root\lib\intgserver. the Primavera Integration API client must be installed on the same server as the Maximo application server.Primavera API root\lib\sqljdbc. Add the paths to the Primavera API files between the equal sign and %SAVE_CLASSPATH%. Primavera API root\lib\activation.jar.jar. About this task For this procedure. Primavera API root\lib\activation.jar. add the paths to all jar files from the Primavera API lib folder.1.jar. Preparing for installation 3 .Primavera API root\lib\mail.

Set the API URL field on the Labor record to point to the Primavera Integration API URL. in the form pcname:port. v For local mode. The default port is 9099.6. v For remote mode. enter the computer name and port for the API URL. 4 IBM Maximo Adapter for Primavera: Installation Guide . enter localhost.

In the next installation windows. click Done.Chapter 2. When the installation is complete. 6. in the Package Successfully Deployed window. If the application server is running. 2. The installation program attempts to connect to the middleware servers by using the middleware login information that you specify. Procedure 1. then click Install the product on the left side of the screen. stop the server and wait a few minutes before you start the installation program. In the Package Options windows.exe program from the root directory of the product DVD. 3. Enabling the product license You must enable the license before you can use the product. In the Welcome window. clear the Supported Package Options check boxes to have the EAR files redeployed and the Maximo database updated by the installation program. If the Windows® autorun feature is disabled. The launchpad starts automatically. Before you begin v If you use IBM WebSphere Application Server. 2. select I accept the terms in the license agreement. click Next. then click Next. you can start the launchpad by running the launchpad. in the Package Successfully Deployed window. The Deployment Progress window shows the progress of the installation. 7. From the launchpad. Start all middleware servers before you run the installation program. v If you use BEA WebLogic Server. Install IBM Maximo Adapter for Primavera. enter the login credentials for the middleware servers. Follow the steps in the wizard. 2008 5 . ensure that the application server (MAXIMOSERVER) is stopped. 9. If the application server is not stopped. When the installation is complete. 4. Installing Maximo Adapter for Primavera Install and deploy Maximo Adapter for Primavera through the process solution installation program. Procedure 1. 8. click the link under Enable IBM Maximo Adapter for Primavera License for usage. In the Software License Agreement window. the installation process stops. select the language for the installation. then click Next. 5. In the Middleware Login Information window. click Done. ensure that the middleware servers are started. Click the link under 1. click OK or Next. Insert the Maximo Adapter for Primavera DVD in the DVD drive. © Copyright IBM Corp. In the Pre-install Summary window.

configure the adapter.What to do next If you use BEA WebLogic Server. manually redeploy the EAR files. 6 IBM Maximo Adapter for Primavera: Installation Guide . Otherwise.

sh (UNIX). you must deploy the EAR files from the WebLogic Server Console after you install Maximo Adapter for Primavera./startWebLogic. Deploying the EAR files If you use BEA WebLogic Server.ear. Start the Administration Console by typing the following URL in the address bar of your browser : http://<host name>:7001/console 3. Before you begin To view the WebLogic Server Console. Start the BEA WebLogic Server. a. Message ″Server started in RUNNING mode″ displays when the WebLogic Server starts running. 2.Chapter 3. Deploying the EAR files starts the application server. Change to the mydomain directory: drive_letter:\BEA_installation_location\ user_projects\domain\mydomain (Windows) or /home/mxadmin/bea/ user_projects/domains/mydomain (UNIX®). you must have a Java™ Virtual Machine installed. Enter startWebLogic.cmd (Windows) or . Procedure 1. © Copyright IBM Corp. 2008 7 . Follow the instructions in the WebLogic Console help to deploy maximo.ear and then maximohelp. b.

8 IBM Maximo Adapter for Primavera: Installation Guide .

Configuring connection details Configure Primavera connection details in the Labor (PV) application in Maximo. Valid values One or more strings of <Maximo_status>. In Maximo.primavera.notstarted Description Determines the Maximo work order statuses that are translated into a Primavera activity status of notstarted. and enable work location resource scheduling to work with multiple locations. 4. type the URL of the RMI Primavera API server. or the host IP address in dotted decimal format. Procedure 1. Any Maximo labor record with the Primavera Connection Details fields completed can transfer data between Maximo and Primavera P6.status. In Maximo. 5. 2.Chapter 4. click the Test Connection button. This user name must exist in the Primavera P6 application and must have Primavera API privileges. © Copyright IBM Corp. Configuring the adapter Configure the parameters for connection with Primavera. the remote host name. In the API URL field. Optionally. 2008 9 . select Go To → System Configuration → Platform Configuration → System Properties. You can configure the following parameters: Parameter mxe.status. specify the credentials that the adapter uses to sign into Primavera P6. type the name of the database to use with Primavera P6. Procedure 1. In the Primavera DB Name field. statuses that are Default: <INPRG><HISTEDIT> translated into a Primavera activity status of inprogress. where <hostname> can be localhost. Select the parameter that you want to configure. The format is: <hostname>:<port>. 2. Default: <CAN><WAPPR> <WMATL><WPCOND> <WSCH><APPR> mxe.primavera.inprogress Determines the One or more strings of Maximo work order <Maximo_status>. To test the connection. then type its value in the text box. select Go To → Administration → Resources → Labor (PV). In the User Name and Password fields. Configuring the adapter parameters Configure the Maximo Adapter for Primavera parameters in Maximo as required for your environment. configure Maximo Adapter for Primavera parameters and logging for your environment. 3. then select the Primavera tab.

Y (default) . in days.nodesc Numeric value.The user name not logged. Default: 7 mxe. Determines the description of a work order when no description is provided. Y is N is (default) .completed Description Valid values Determines the One or more strings of Maximo work order <Maximo_status>.Maximo calendars are not exported.Maximo calendars are exported.The leading zeros are removed.primavera.globallog 10 IBM Maximo Adapter for Primavera: Installation Guide . Default: “NO DESCRIPTION” mxe. You can also use this parameter to name a project when no project description is provided. mxe. to run a full validation of the PLUSVCACHE table.system.exportcalendars Y (default) . N .validatefreq Indicates the frequency. This parameter is used to ensure the synchronization of resource records between Maximo and Primavera. mxe.primavera.leadingzero Indicates whether leading zeros on work order numbers are removed when the work orders are exported to Primavera. Indicates whether the user name of each user is logged before messages related to that user in the adapter log file.status.The leading zeros are not removed.The user name logged.primavera.primavera. (default) .cache. mxe. N . statuses that are Default: <COMP><CLOSE> translated into a Primavera activity status of completed.Parameter mxe. Indicates whether Maximo calendars are exported to Primavera. The validation occurs the first time an export or import operation is performed after the number of days specified. Text enclosed in double quotation marks.primavera.

you can define. Select Assets → Locations. sites. If you want to specify the work location prefix that is added to all craft records exported to Primavera P6.Configuring logging Configure logging for Maximo Adapter for Primavera using the standard Maximo logging mechanism. type a value in the Work Location Prefix field. select Go To → Administration → Organizations (PV). For information about logging configuration. Configuring the adapter 11 . refer to the Maximo documentation. 4. About this task Enabling work location resource scheduling affects all organizations. Enabling work location resource scheduling If work location resource scheduling is enabled. Retrieve the location record. select Primavera Options. the site ID of the work order is added to the craft records. 3. Chapter 4. On the Select Action menu. a. and projects. then System Options. On the Location tab. complete the following steps for each location The work location prefix must be unique within an organization. Select the Schedule by Work Location check box and click OK. c. 2. and manage resources for multiple sites. b. schedule. In Maximo. To enable work location resource scheduling: Procedure 1. Save the record. d. If you do not specify a prefix.

12 IBM Maximo Adapter for Primavera: Installation Guide .

However. Minato-ku Tokyo 106-0032. IBM may not offer the products. in writing. IBM may have patents or pending patent applications covering subject matter described in this document. program. Some states do not allow disclaimer of express or implied warranties in certain transactions. For license inquiries regarding double-byte (DBCS) information. therefore. services. This information could include technical inaccuracies or typographical errors. program. Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. this statement may not apply to you. or service. © Copyright IBM Corp. The furnishing of this document does not grant you any license to these patents. INCLUDING. Any reference to an IBM product. to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk. program. or service is not intended to state or imply that only that IBM product. THE IMPLIED WARRANTIES OF NON-INFRINGEMENT. it is the user’s responsibility to evaluate and verify the operation of any non-IBM product. EITHER EXPRESS OR IMPLIED. NY 10504-1785 U. program. You can send license inquiries.S. or features discussed in this document in other countries. 2008 13 . Consult your local IBM representative for information about the products and services currently available in your area. BUT NOT LIMITED TO. or service that does not infringe any IBM intellectual property right may be used instead. Any functionally equivalent product. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. these changes will be incorporated in new editions of the publication.Notices This information was developed for products and services offered in the U. to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome.A. contact the IBM Intellectual Property Department in your country or send inquiries.S. MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. in writing. or service may be used. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Changes are periodically made to the information herein.

To illustrate them as completely as possible. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy. and ibm. brands. the IBM logo. the examples include the names of individuals. or any equivalent agreement between us. IBM International Program License Agreement. IBM has not tested those products and cannot confirm the accuracy of performance. Such information may be available. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.shtml. or both. Microsoft®. Inc. Windows NT®.ibm. registered or common law trademarks owned by IBM at the time this information was published. should contact: U.S.IBM Corporation 2Z4A/101 11400 Burnet Road Austin.A.com/ legal/copytrade. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™). payment of a fee.S. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement. subject to appropriate terms and conditions.com® are trademarks or registered trademarks of International Business Machines Corporation in the United States. or both. other countries. Windows. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems. and the Windows logo are trademarks of Microsoft Corporation in the United States.Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged.S. other countries. All statements regarding IBM’s future direction or intent are subject to change or withdrawal without notice. these symbols indicate U. TX 78758 U. 14 IBM Maximo Adapter for Primavera: Installation Guide . including in some cases. and products. This information contains examples of data and reports used in daily business operations. or both. Such trademarks may also be registered or common law trademarks in other countries. companies. their published announcements or other publicly available sources. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at http://www. the photographs and color illustrations may not appear.A. in the United States. compatibility or any other claims related to non-IBM products. and represent goals and objectives only. Trademarks IBM. other countries. Information concerning non-IBM products was obtained from the suppliers of those products.

Notices 15 .UNIX is a registered trademark of The Open Group in the United States and other countries. product. Other company. and service names may be trademarks or service marks of others.

16 IBM Maximo Adapter for Primavera: Installation Guide .

Index C configuration 9 connection details 9 E EAR deploying 7 I installation information needed preparation 1 requirements 1 using PSI 5 1 L license enablement logging 11 5 P parameters 9 preparation for installation 1 Primavera API configuration on WebLogic 2 on WebSphere 1 PSI (process solution installer) installation 5 R requirements installation 1 resource scheduling 11 W work location resource scheduling 11 © Copyright IBM Corp. 2008 17 .

18 IBM Maximo Adapter for Primavera: Installation Guide .

.

Printed in USA .