3.1 Installation Instructions

The driver contains three components that can be installed within your environment on multiple systems and platforms. They include the driver shim, PeopleSoft Service Agent (PSA) and the driver policies.

Depending on your system configuration, you might need to run the installation program several times to install driver components on the appropriate systems. For example, you would install the driver shim where Identity Manager or Remote Loader exists, the PSA where the PeopleSoft Application Server exists, and the driver policies to your iManager server.

For PeopleSoft v5.1, there is no standalone installation method. You install the PeopleSoft v5.1 driver when you install Identity Manager. At that time you can install all of the drivers that come with Identity Manager, or you can select the drivers you want to install, as well as the driver utilities. This is covered in Section 3.2, Installing the PeopleSoft Driver During Identity Manager Installation.

After you install the PeopleSoft driver, you must configure the driver. You do this through iManager or through Designer. To configure the PeopleSoft driver through iManager, see Section 3.3, Importing the Driver Configuration in iManager. To configure the PeopleSoft driver through Designer, see Section 3.4, Installing the PeopleSoft Driver through Designer.

3.1.1 Preparing To Install the PeopleSoft Driver

There are three separate .jar files required to complete the driver installation:

  • psjoa.jar: The PeopleSoft middleware library. This file is located in the web/psjoa directory of the PeopleTools software distribution. You should copy this file to the \lib subdirectory with the driver Java* library files.

    This file, and any additional Component Interface API class libraries that your solution requires, should be placed together in the \lib subdirectory with the DirXML* Java library files. By default this is Novell\NDS\lib for a local driver installation or Novell\RemoteLoader\lib for a remote installation.

  • psoftshim.jar: This is the driver shim and is installed when you run the Identity Manager installation program.

  • dirxmlcomps.jar: This library contains the compiled APIs for the DIRXML_SCHEMA01, DIRXML_TST_PERS, and DIRXML_TRANSnn Component interfaces delivered in the PSA. This library is installed when you run the Identity Manager installation program.

    The test utility citester.class file is also installed when you run the Identity Manager installation program and select to install the driver utilities.