Installing the connector

The following subsections describe how to install the connector on a UNIX or Windows system.

After your WebSphere business integration system is installed, you can install additional connectors from the product CD at any time. To do this, run the Installer for IBM WebSphere Business Integration Adapter, and select the connectors that you want to install.

Installing on a UNIX system

To install the connector on a UNIX system, run Installer, and select the IBM WebSphere Business Integration Adapter for PeopleSoft. Installer installs standard files associated with the adapter. Table 1 describes the UNIX file structure used by the connector.

Table 1. Installed UNIX file structure for the connector
Subdirectory of $ProductDirS Description
connectors/PeopleSoft
  • Contains the connector's CWPeopleSoft.jar and the start_PeopleSoft.sh files.

The startup script for the connector is called from the generic connector manager script. When you click Install from the product installer's Connector Configuration screen, the installer creates a customized wrapper for this connector manager script.

When the connector works with WebSphere Interchange Server broker, use this customized wrapper to start and stop the connector. When the connector works with WebSphere MQ Integrator broker, use this customized wrapper only to start the connector; use mqsiremotestopadapter to stop the connector.

  • Contains an executable named EventNotificationInstall.exe, which contains the event notification objects

  • Contains a file named SavePostChg.txt, which contains a sample of the PeopleCode required to process events

/bin Please verify that this folder contains the CWConnEnv.sh file.
/lib Please verify that the directory contains the WBIA.jar file. This file corresponds to ADK 2.2.0. If an older version of ADK is required, please refer to the Connector Development Guide.
connectors/PeopleSoft/dependencies
  • Contains the psjoa.jar files that you must copy from the current version of PeopleTools.

  • Contains the PSFTCI.jar file, which contains all the PeopleSoft Component Interface class files that PeopleSoft generates after you build and compile the APIs.

connectors/messages Contains the PeopleSoftConnector.txt file, as well as PeopleSoftConnector_ll_TT.txt files (message files specific to a language (_ll) and a country or territory (_TT)).
connectors/PeopleSoft/samples Contains a sample PeopleSoft-specific business object.
repository/PeopleSoft Contains the CN_PeopleSoft.txt file.

Before you can use the connector, you must configure the connector from the installer's Connector Configuration screen. From this screen:

Note:
For more information on installing the connector component, refer to the Implementation Guide for the WebSphere MQ Integrator Broker. or, for the WebSphere InterChange Server, the System Installation Guide for Windows or Unix.

Installing on a Windows system

To install the connector on a Windows system, run Installer, and select the IBM WebSphere Business Integration Adapter for PeopleSoft. Installer installs standard files associated with the connector. Table 2 describes the Windows file structure used by the connector.

Table 2. Installed Windows file structure for the connector
Subdirectory of%ProductDirS% Description
\connectors\PeopleSoft
  • Contains the connector's CWPeopleSoft.jar and the start_PeopleSoft.bat files.

  • Contains an executable named EventNotificationInstall.exe, which contains the event notification objects

  • Contains a file named SavePostChg.txt, which contains a sample of the PeopleCode required to process events

..\bin Please verify that this folder contains the CWConnEnv.bat file.
..\lib Please verify that the directory contains the WBIA.jar file. This file corresponds to ADK 2.2.0. If an older version of ADK is required, please refer to the Connector Development Guide.
\connectors\PeopleSoft\dependencies
  • Contains the psjoa.jar files that you must copy from the current version of PeopleTools.

  • Contains the PSFTCI.jar file, which contains all the PeopleSoft Component Interface class files that PeopleSoft generates after you build and compile the APIs.

\connectors\messages Contains the PeopleSoftConnector.txt file, as well as PeopleSoftConnector_ll_TT.txt files (message files specific to a language (_ll) and a country or territory (_TT)).
\connectors\PeopleSoft\samples Contains a sample PeopleSoft-specific business object.
\repository\PeopleSoft\ Contains the CN_PeopleSoft.txt file.

Installer adds a menu option for the connector's application-specific component to the IBM WebSphere Business Integration Adapters menu (if WebSphere MQ Integrator broker is the integration broker) or to the IBM WebSphere business integration adaptor menu (if the WebSphere InterChange Sever is the integration broker). For a fast way to start the connector, create a shortcut to this component on the desktop.

Note:
For more information on installing the connector component, refer to the Implementation Guide for the WebSphere MQ Integrator Broker. or, for the WebSphere InterChange Server, the System Installation Guide for Windows or Unix.

Copyright IBM Corp. 1997, 2003