Previous     Contents     Index     DocHome     Next     
iPlanet Enterprise Connector for PeopleSoft Administrator's Guide



Chapter 2   Installation


This chapter describes how to install and uninstall the iPlanet Application Server Enterprise Connector for PeopleSoft. The software components installed include the PeopleSoft Enterprise Connector, which is a shared object, and the PeopleSoft Worker, which is an executable file.

This chapter contains information about the following topics:



Software Prerequisites

The following software prerequisites are necessary to install the iPlanet Application Server Enterprise Connector for PeopleSoft:

  • the iPlanet Application Server version 6.0 SP1 must be installed

  • the iPlanet Application Server Unified Integration (UIF) version 6.0 SP1 must be installed

  • the PeopleSoft client software must be installed

    • For Windows NT, you must set the environment variable path to include the directory that contains the PeopleSoft client software (psmsg.dll) file.

  • One of the following web browsers should be installed:

    • Netscape Communicator 4.5

    • Microsoft Internet Explorer 4.0 (NT only)


Caution

The PeopleSoft connector operates with the iPlanet Application Server, therefore it must be installed in the same directory in which the iPlanet Application Server is installed.



Supported PeopleSoft Versions

The iPlanet Application Server Enterprise Connector for PeopleSoft supports PeopleSoft Versions 7.55. and 7.56



Hardware Requirements


The following hardware requirements are necessary for installing the connectors.


Computers and Operating Systems

  • One of the following operating systems:

    • Microsoft Windows NT version 4.0 with Service Pack 5

    • Sun SPARC running Solaris version 2.6

  • Memory Per CPU: 256MB minimum; 512MB recommended.

  • Available disk space: 200 MB for Windows NT, 400 MB for Solaris.

  • Client library that matches the version of the PeopleSoft Server to which you are connecting.



Preparing to Install

Before installing the iPlanet Application Server Enterprise connector for PeopleSoft complete the following steps:

  • Verify the PeopleSoft Server connectivity.

  • Stop the iPlanet Application Server if it is running.Without stopping the application server, the installation program may not be able to overwrite files currently in use.

  • Read the iPlanet Application Server Enterprise Connector for PeopleSoft Release Notes for any last minute updates, located at http://docs.iplanet.com/docs/manuals/ias.html.



Installing on Windows NT

The following describes the procedures for installing and uninstalling iPlanet Application Server for PeopleSoft on Windows NT.

You must be logged in to Windows NT as the administrator to install the iPlanet Application Server Enterprise Connector for PeopleSoft


Pre-installation

  1. Insert the iPlanet Application Server Enterprise Connector for PeopleSoft Install CD-ROM into the CD-ROM drive.

  2. Read the README.txt file on the CD-ROM.


To Install on Windows NT

  1. Read the README.txt file on the CD-ROM.

  2. Copy NT/inspsft.zip from the CD-ROM into a temporary local directory.

  3. Unzip inspsft.zip, then run setup.exe.

  4. Read the Welcome message and click on the Next button. See Figure 2-1.

  5. Follow the instructions on the screen to progress through the introduction.

Figure 2-1    Welcome Message

  1. Thoroughly read and understand this information before installing, and accept the license agreement. See Figure 2-2.

Figure 2-2    Software License Agreement

  1. Choose your installation directory, then click Next. See Figure 2-3.

Figure 2-3    Location of Installation


Note

You must install the iPlanet Application Server Enterprise Connector for PeopleSoft in the same directory as you installed iPlanet Application Server.



Figure 2-4    Components to Install

  1. The Enterprise Connector for PeopleSoft 6.0 SP1 is selected as seen in Figure 2-4. Click Next to continue.

  2. Type in your PeopleSoft Host Configuration information, and click Next. See Figure 2-5.

    The host configuration information defines the Peoplesoft Host system.
    Note

    The User ID and Password must be in uppercase.


Figure 2-5    PeopleSoft Host Configuration

The Oracle Backend Configuration screen appears. See Figure 2-6.

  1. Enter the requested information and click Next.

Figure 2-6    Oracle Backend Configuration


Note

Leave the Service and Type fields blank.


The Configuration Summary window appears. See Figure 2-7.

  1. Review the Configuration Summary window. If correct, click Install.

Figure 2-7    Configuration Summary

  1. (Optional) Figure 2-8 displays the possible warning window(s) that can appear if the installer detects that the iPlanet Application Server Enterprise Connector for PeopleSoft is already installed. Choose Yes to overwrite the existing adapter type and all sample data source definitions shipped with the PeopleSoft connector. User defined data sources are not overwritten. Select No if you are simply adding another iPlanet Application Server instance to an existing cluster.

    Confirm your decision.

Figure 2-8    Warning Windows

The Completion of Installation Window is displayed as in Figure 2-9.

  1. Read the Completion of Installation window which is displayed when all files are installed. Choose from the two options presented, remove any disks from their drives, and click Finish.

    The iPlanet Application Server Enterprise Connector for PeopleSoft is now installed.

    The machine must be rebooted and start the iPlanet Application Server before using the iPlanet Application Server Enterprise Connector for PeopleSoft.

Figure 2-9    Completion of Installation  


To Uninstall from Windows NT

  1. Select Start > Programs - iPlanet Application Server 6.0 > Uninstaller.

    The iPlanet Uninstall window is displayed. See Figure 2-10.

Figure 2-10    iPlanet Uninstaller Window


  1. Deselect all components for iPlanet Application Server except iPlanet Application Server Enterprise Connector for PeopleSoft, then click Uninstall.

    The uninstaller checks for dependencies between subcomponents and the main component. If you try to deselect a component and its subcomponent are toggled on, a warning message appears.


To Deselect the Enterprise Connector for PeopleSoft

Deselect items in the following order:

  1. Deselect Netscape Server Family Core components.

  2. Deselect Administration Services.

  3. Deselect Netscape Directory Suite.

  4. Deselect UIF 6.0 SP1.


To Deselect the iPlanet Application Server

Deselect items as follows:

  1. Highlight the iPlanet Application Server 6.0 SP1 entry.

  2. Click the Sub Components button to display the options.

    Deselect options in the following order:

  3. Deselect Application Server 6.0 Core Binaries.

  4. Deselect Administrator Tool.

  5. Deselect Web Connector Plug-in Component.

  6. Deselect Deployment Tool.

  7. Deselect Core Server Component.

    Click the Continue button to return to the main uninstall menu.

    Caution

    If you do not follow the order of deselection above, alert messages are displayed and you may not be able to deselect the desired option


  8. Click Uninstall.

    A message is displayed. See Figure 2-11.

Figure 2-11    Uninstall Message

  1. Click OK to complete the uninstallation procedure.



Installing on Solaris

The following procedures describe how to install and uninstall the iPlanet Application Server Enterprise Connector for PeopleSoft on a Solaris Operating System.


Pre-installation

  1. Insert the iPlanet Application Server Enterprise Connector for PeopleSoft Install CD-ROM into the CD-ROM drive.

  2. Mount the CD-ROM, for example, /cdrom/cdrom0.

  3. Read the README.txt file on the CD-ROM.


To Install on Solaris

  1. Copy the Solaris/inspsft.tar file from the CD-ROM into a temporary local directory.

  2. Untar the inspsft.tar file.

    For example: tar -xvf inspsft.tar

  3. Run the ./setup command

    Follow the instructions of the installation program. During installation, press the following key sequences for:

    CTRL+B to back up to the previous screen.

    CTRL+C to cancel the installation program. This results in an incomplete installation. To install again, rerun the installation program from the beginning.

  4. Figure 2-12 is displayed. Either press enter or type Yes to continue.

Figure 2-12    Welcome Message

  1. Enter Yes.

    Figure 2-13 is displayed.

Figure 2-13    License

  1. Thoroughly read and understand the license information before installing. Enter Yes.

    Figure 2-14 is displayed.

Figure 2-14    Component Selection

  1. Press Enter.
    Note The iPlanet Application Server and UIF must already be resident on your system. You must perform this step to proceed with the connector installation.


    Figure 2-15 is displayed.

Figure 2-15    Location of Installation

  1. To accept the default shown in the brackets, press Enter.

    Otherwise, enter in the iPlanet Application Server installation directory, and press Enter.

    Figure 2-16 is displayed.

Figure 2-16    Components to Install

  1. Press Enter.

    Figure 2-17 is displayed.

Figure 2-17    Additional Components

  1. Press Enter.

    Figure 2-18 is displayed.

Figure 2-18    Computer Name Selection

  1. Press Enter to accept the default or enter another name <host.domain.com>.

    Figure 2-19 is displayed.

Figure 2-19    System User Selection

  1. To accept the default shown in brackets, press Enter.

    Figure 2-20 is displayed.

Figure 2-20    System Group

  1. To accept the default shown in brackets, press Enter.

    Figure 2-21 is displayed.

Figure 2-21    PeopleSoft Host Name

  1. Enter the Host Name.

    Figure 2-22 is displayed.

Figure 2-22    Listener Port

  1. Enter in the Listener Port.

    Figure 2-23 is displayed.

Figure 2-23    User ID

  1. Enter the User ID.

    Figure 2-24 is displayed.

Figure 2-24    Password

  1. Enter the Password.

    Figure 2-25. is displayed

Figure 2-25   

Oracle Host Name

  1. Enter the Oracle Host Name.

    Figure 2-26 is displayed.

Figure 2-26    Oracle Listener Port

  1. Enter the Oracle Listener Port.

    Figure 2-27 is displayed.

Figure 2-27    Database SID

  1. Enter the database SID.

    Figure 2-30 is displayed.

Figure 2-28    User ID

  1. Enter the User ID.

    Figure 2-29 is displayed.

Figure 2-29    User Password

  1. Enter the Password.

    Figure 2-30 is displayed.

Figure 2-30    Summation

  1. Press Enter to continue.

  2. Warning window(s) as displayed in Figure 2-31 and Figure 2-32 may appear if the installer detects that the iPlanet Application Server Enterprise Connector for PeopleSoft is already installed. Choose Yes to overwrite the existing adapter type and all sample data source definitions shipped with the PeopleSoft connector. User defined data sources are not overwritten. Select No if you are simply adding another iPlanet Application Server instance to an existing cluster.

Figure 2-31    Install Warning 1

  1. Confirm your decision as shown in Figure 2-32.

Figure 2-32    Install Warning 2


Note

After successful installation on Solaris, you can run the samples. Refer to Chapter 4 in the iPlanet Application Server Enterprise Connector for PeopleSoft Developer's Guide.



To Uninstall from Solaris

  1. Go to the installation directory, /user/iplanet/ias6, and enter the following command:

    ./uninstall

    Figure 2-33 is displayed.

Figure 2-33    Uninstall Window 1

  1. Select the specific product components you want to uninstall and press Enter.

    Figure 2-34 is displayed.

Figure 2-34    Uninstall Window 2

  1. Select the specific product components you want to uninstall and press Enter.

    The iPlanet Application Server Enterprise Connector for PeopleSoft is now uninstalled.



Upgrading or Reinstalling Issues

If upgrading an earlier version or reinstalling the current version of the iPlanet Application Server Enterprise Connector for PeopleSoft, the installation procedure overwrites the currently installed files. Uninstalling the current version is not required.

Installation of multiple enterprise connectors for multiple EISs (CICS, Tuxedo, and R/3) on the same iPlanet Application Server is allowed.


Note

To avoid problems with overwriting files in use, stop the iPlanet Application Server before installing any new software. Always backup the current files prior to installation including the UIF Repository content.




Post Installation Issues


The following issues are described:


Activating the Samples through NT or Solaris

After installing the iPlanet Application Server enterprise Connector for PeopleSoft you can verify that your installation succeeded and run the PeopleSoft samples provided.

You can activate PeopleSoft programs that access the PeopleSoft management system by entering a series of commands through your operating system. For more information on how to activate and run the PeopleSoft samples, see Chapter 4 of the iPlanet Application Server Enterprise Connector for PeopleSoft Developer's Guide.


Copying Files in Webless Installation

In a webless installation, the web server and iPlanet Application Server reside on separate machine. In this configuration mode, the iPlanet Application Server Enterprise Connector for PeopleSoft installation procedure will not automatically copy the index.html file pertaining to connector samples to web server document root directory.

To run the samples shipped with the iPlanet Application Server Enterprise Connector for PeopleSoft, an index.html file must be copied manually from the iPlanet Application Server instance to web server instance.


To Copy Files to Run the Program Samples

  1. Create the psftSamples directory under the web server document root directory.

    For example, <iWS installdir>/docs/psftSamples.

  2. Copy the index.html file from <iASrootdir>/ias/APPS/adapters/htmldocs/psft/psftSamples directory to <iWS installdir>/docs/psftSamples directory on web server machine.


Launching the Daemon

To start working with the iPlanet Application Server Enterprise Connector for PeopleSoft, you must run the startpsftworker process. The startpsftworker process invokes the daemon. See High-level System Architecture.


To Launch the Daemon

  • At the terminal prompt enter the following command line:

    startpsftworker.sh start

    or

  • on Windows NT, select Start > iPLanet Application Server 6.0 > PEOPLESOFT Connector 6.0 > Start Worker Process.


Editing Scripts

The following two scripts should be edited after installing the iPlanet Application Server Enterprise Connector for PeopleSoft:

  • startpsftworker.sh

  • psconsole.sh


To Edit the startpsftworker.sh Script

  1. Add the directory of the PeopleSoft client software to the LD_LIBRARY_PATH variable.

    If for example the

    LD_LIBRARY_PATH =/installedias/iplanet/ias/ias6/APPS/bin

    and the PeopleSoft client software is located in the same root directory in the ps folder,

    add the following

    LD_LIBRARY_PATH =/installedias/ias6/ias/APPS/bin:/installedias/iplanet/ias6/ias/APPS/bin/ps

  2. Add the following two lines to the script:

    PS_HOME=/installedias/iplanet/ias6/ias/APPS/bin/ps

    (This is the same path added to the LD_LIBRARY_PATH variable.)

    export PS_HOME


To Edit the psconsole.sh Script

  1. Add the following two lines to the psconsole.sh script:

    PS_HOME=/installedias/iplanet/ias6/ias/APPS/bin/ps

    (This is the same path added to the LD_LIBRARY_PATH variable.)

    export PS_HOME

  2. Add the directory of the PeopleSoft client software.

    For example, if the client software is located in the ps folder, where the iAS is installed, add the following line:

    LD_LIBRARY_PATH=/installedias/iplanet/ias6/ias/APPS/bin/ps


Previous     Contents     Index     DocHome     Next     
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corp. All rights reserved.

Last Updated November 07, 2000