BEAWebLogic Adapter for PeopleSoft® 8 Installation and Configuration Guide Version 8.1 Document Date: July 2003 Revised: Revised: Februrary 2004 Copyright Copyright © 2004 BEA Systems, Inc. All Rights Reserved. Portions Copyright © 2004 iWay Software. All Rights Reserved. Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part, be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form without prior consent, in writing, from BEA Systems, Inc. Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the BEA Systems License Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR supplement 16-52.227-86; or their equivalent. Information in this document is subject to change without notice and does not represent a commitment on the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, Jolt, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA Builder, BEA Campaign Manager for WebLogic, BEA eLink, BEA Liquid Data for WebLogic, BEA Manager, BEA WebLogic Commerce Server, BEA WebLogic Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Express, BEA WebLogic Integration, BEA WebLogic Personalization Server, BEA WebLogic Platform, BEA WebLogic Portal, BEA WebLogic Server, BEA WebLogic Workshop and How Business Becomes E-Business are trademarks of BEA Systems, Inc. All other trademarks are the property of their respective companies. Contents About This Document Who Should Read This Documentation. .v Background Knowledge . i-vi Additional Information . vi Contact Us! . .vii Installing the BEA WebLogic Adapter for PeopleSoft 8 Preparing to Install the Adapter . 1-2 Review the Release Notes. 1-2 Understanding the Representation of Paths . 1-2 Installing the Adapter . 1-3 Step 1. Obtain the BEA WebLogic Adapter for PeopleSoft 8 . 1-3 Step 2. Configure the Domain . 1-4 Step 3. Extract the Adapter Files and Change the WebLogic Script . 1-4 Extracting Files and Adjusting the Classpath for Windows . 1-4 Extracting Files and Adjusting the Classpath for UNIX . 1-6 Step 4. Update the BEA License. 1-7 Step 5. Deploy the Adapter. 1-8 Step 6. Create an Adapter Administrative User . 1-11 Next Steps . 1-13 Installing the BEA Application Explorer . 1-13 Starting Integration with PeopleSoft. 1-13 BEA WebLogic Adapter for PeopleSoft 8 Installation Guide iii Installing the Component Interfaces Extracting and Importing the Component Interface Files. 2-1 Extracting the Component Interface Files . 2-2 Extracting the Files on Window System. 2-2 Extracting the Files on a UNIX System . 2-2 Importing the Component Interface Files into PeopleSoft . 2-2 Copying the Component Interface Files into PeopleSoft . 2-3 Building the Component Interface Project in PeopleSoft. 2-4 Configuring Security for the Component Interfaces. 2-6 Testing the Component Interfaces. 2-8 Next Steps . 2-10 Installing and Configuring the BEA TCP/IP Message Router Installing the BEA TCP/IP Handler for PeopleSoft 8.1 . 3-1 Extracting and Installing the BEA TCP/IP Handler . 3-2 Configuring the BEA TCP/IP Handler for the PeopleSoft Gateway Server . 3-2 Installing the BEA TCP/IP Target Connector for PeopleSoft 8.4 and Higher . 3-5 Extracting and Installing the Target Connector . 3-5 Creating a Gateway . 3-6 Index iv BEA WebLogic Adapter for PeopleSoft 8 Installation Guide About This Document This document explains how to install and configure the BEA WebLogic Adapter for PeopleSoft 8. This document is organized as follows: z Chapter 1, “Installing the BEA WebLogic Adapter for PeopleSoft 8,” explains how to install the adapter. z Chapter 2, “Installing the Component Interfaces,” explains how to install and configure the PeopleSoft component interfaces. z Chapter 3, “Installing and Configuring the BEA TCP/IP Message Router,” explains how to install and configure the BEA TCP/IP Message Router to enable PeopleSoft events. Who Should Read This Documentation This document is intended for the following members of an integration team: z Integration Specialists—Lead the integration design effort. Integration specialists have expertise in defining the business and technical requirements of integration projects, and in designing integration solutions that implement specific features of WebLogic Integration. The skills of integration specialists include business and technical analysis, architecture design, project management, and WebLogic Integration product knowledge. z Technical Analysts—Provide expertise in an organization’s information technology infrastructure, including telecommunications, operating systems, applications, data repositories, future technologies, and IT organizations. The skills of technical analysts include technical analysis, application design, and information systems knowledge. BEA WebLogic Adapter for PeopleSoft 8 Installation Guide v z Enterprise Information System (EIS) Specialists—Provide domain expertise in the systems that are being integrated using WebLogic adapters. The skills of EIS specialists include technical analysis and application integration design. z System Administrators—Provide in-depth technical and operational knowledge about databases and applications deployed in an organization. The skills of system administrators include capacity and load analysis, performance analysis and tuning, deployment topologies, and support planning. Background Knowledge This document assumes that you have an understanding of: z Web technologies z WebLogic Integration z PeopleSoft software, system, and environment. This includes understanding of PeopleSoft tools and configuration as well as processes and data models. z Your specific PeopleSoft business needs and applications. Additional Information To learn more about the software components associated with the adapter, see the following documents: z BEA WebLogic Adapter for PeopleSoft 8 Release Notes http://edocs.bea.com/wladapters/peoplesoft/docs81/pdf/relnotes.pdf z BEA WebLogic Adapter for PeopleSoft 8 Installation and Configuration Guide http://edocs.bea.com/wladapters/peoplesoft/docs81/pdf/install.pdf z BEA Application Explorer Installation and Configuration Guide http://edocs.bea.com/wladapters/bae/docs81/index.html z Introduction to the BEA WebLogic Adapters http://edocs.bea.com/wladapters/docs81/index.html z BEA WebLogic Adapters 8.1.0 Dev2Dev Product Documentation vi BEA WebLogic Adapter for PeopleSoft 8 Installation Guide http://dev2dev.bea.com/products/product.jsp?highlight=wla z Application Integration documentation Introducing Application Integration http://edocs.bea.com/wli/docs81/aiover/index.html Using the Application Integration Design Console http://edocs.bea.com/wli/docs81/aiuser/index.html z BEA WebLogic Integration documentation http://edocs.bea.com/wli/docs81/index.html z BEA WebLogic Platform documentation http://edocs.bea.com/platform/docs81/index.html z PeopleSoft documentation www.peoplesoft.com Contact Us! Your feedback on the BEA WebLogic Adapter for PeopleSoft 8 documentation is important to us. Send us e-mail at [email protected] if you have questions or comments. Your comments will be reviewed directly by the BEA professionals who create and update the BEA WebLogic Adapter for PeopleSoft 8 documentation. In your e-mail message, please indicate that you are using the documentation for BEA WebLogic Adapter for PeopleSoft 8 and the version of the documentation. If you have any questions about this version of BEA WebLogic Adapter for PeopleSoft 8, or if you have problems using the BEA WebLogic Adapter for PeopleSoft 8, contact BEA Customer Support through BEA WebSUPPORT at www.bea.com. You can also contact Customer Support by using the contact information provided on the Customer Support Card which is included in the product package. When contacting Customer Support, be prepared to provide the following information: z Your name, e-mail address, phone number, and fax number z Your company name and company address z Your machine type and authorization codes z The name and version of the product you are using BEA WebLogic Adapter for PeopleSoft 8 Installation Guide vii z A description of the problem and the content of pertinent error messages viii BEA WebLogic Adapter for PeopleSoft 8 Installation Guide CHAPTER 1 Installing the BEA WebLogic Adapter for PeopleSoft 8 This section explains how to install the BEA WebLogic Adapter for PeopleSoft 8 with WebLogic Integration on both Windows and UNIX systems. This section is organized as follows: z Preparing to Install the Adapter z Understanding the Representation of Paths z Installing the Adapter z Next