Performing a PeopleTools Patch Update on a PeopleSoft Environment  Running in Oracle Cloud


Options



Before You Begin

Purpose

In this tutorial, you'll be using PeopleSoft Deployment Package (DPK) to deploy PeopleTools Server on an Oracle Linux VM and PeopleTools Client on a Microsoft Windows VM in Oracle Compute Cloud Service.

Time to Complete

60 minutes (approximately)

Background

The PeopleSoft PeopleTools DPKs provide an easy mechanism to download and apply the latest PeopleSoft PeopleTools patch.

Context

This tutorial is part of the following set of tutorials, which describe how to deploy a PeopleSoft environment to Oracle Compute Cloud Service:

  • Generating an SSH Key Pair for Oracle Compute Cloud Service Instances
  • Migrating PeopleSoft Applications to Oracle Compute Cloud Service
  • Installing Micro Focus COBOL Compiler and License on an Oracle Compute Cloud Service Instance (optional)
  • Compiling PeopleSoft COBOL Programs on an Oracle Compute Cloud Service Instance (optional)
  • Performing PeopleTools-Only Upgrade on PeopleSoft Environments Running in Oracle Cloud (optional)
  • Performing a PeopleTools Patch Update on a PeopleSoft Environment Running in Oracle Cloud (optional)
  • Cloning a PeopleSoft Environment in Oracle Cloud (optional)
  • Scaling Existing PeopleSoft Environments on Oracle Cloud (optional)
  • Using PeopleSoft Update Images in Oracle Compute Cloud Service

What Do You Need?

  • Access to File Server VM in the Oracle Compute Cloud Service where the DPKs are downloaded from the Oracle Storage Cloud Service Object Storage.
  • Oracle Linux VM in Oracle Compute Cloud Service

    The PeopleSoft PeopleTools Server DPKs can be deployed on any supported Oracle Linux VM, 64-bit platform certified by Oracle for PeopleSoft. A minimum of 6 GB RAM and 100 GB free disk space are required to deploy the PeopleSoft PeopleTools server.
  • Microsoft Windows VM in Oracle Compute Cloud Service

    The PeopleSoft PeopleTools Clienk DPK can be deployed on any supported Microsoft Windows platform certified by Oracle for PeopleSoft.
  • PeopleSoft application database

    Obtain the information for the Oracle database that you want the mid-tier to access, including the database host name, server name, and port number.

Process Overview

To deploy the latest PeopleSoft PeopleTools mid-tier components from one VM to another, you will:

  1. Download the PeopleSoft PeopleTools DPK zip files.
  2. Deploy a mid-tier PeopleSoft environment using the PeopleSoft PeopleTools Bootstrap DPK script.
  3. Deploy the PeopleSoft PeopleTools Client for applying a upgrade or patch.
  4. Perform tests with the deployed PeopleTools Server and Client mid-tier components.

Copying the DPKs

Copy the DPKs for PeopleSoft PeopleTools from the File Server VM in the Oracle Compute Cloud Service where the DPKs are downloaded from the Oracle Storage Cloud Service Object Storage, to a directory called DPK_INSTALL in a Windows VM in the Oracle Cloud.

Setting Up the PeopleSoft Environment

After you have copied the DPK files to DPK_INSTALL directory, you will use the PeopleSoft PeopleTools Bootstrap DPK to set up a complete PeopleSoft mid-tier environment.

  1. Extract the first DPK zip file (Filename.1ofn.zip) in the DPK_INSTALL directory on your host. This will create a directory called setup in DPK_INSTALL.
  2. Run the Bootstrap DPK script, as follows:

    On a Linux VM:
    Run the script DPK DPK_INSTALL/setup/psft-dpk-setup.sh, and use the --env_type midtier option to set up only the Application Server, Process Scheduler and PIA mid-tier components:
    sh psft-dpk-setup.sh --env_type midtier
  3. The script displays messages indicating the steps in the setup process.
    The success or failure of each step is indicated by [ OK ] or [ FAILURE ].
  4. Specify the deployment directory, /PSFT_BASE that you created earlier when prompted for the base directory to extract the DPKs.
  5. Provide the following information at the prompts. The bootstrap script provides information on the requirements for each item:
    • Database name: For example, HCM92
    • PeopleSoft Connect ID: For example, people
    • PeopleSoft Connect ID password
    • Application Server Domain password (optional)
    • Oracle Web Logic admin password    
  6. Answer y (yes) or n (no) to configure Oracle SES.
  7. Answer y (yes) to the question:
    Do you want to continue with the default initialization process? [y|n]:

    If you select the default initialization process, the PeopleSoft environment is created with one Application Server domain, one Process Scheduler domain, and one PIA domain.
  8. Review the bootstrap log file.

    Linux VM:
    The complete bootstrapping log is written to the file psft-dpk-setup.log<date>  in the same location as the bootstrap script.

Deploying the PeopleTools Client on Microsoft Windows VM

This procedure uses the PeopleTools Client DPK that is provided with the PeopleSoft PeopleTools Patch DPKs to deploy the PeopleTools Client for Oracle database on a Microsoft Windows VM in Oracle Compute Cloud Service.

The deployment of the PeopleSoft PeopleTools server DPK creates a folder for the PeopleTools Client.

If you deployed on a Linux operating system, either using VirtualBox or using the DPK bootstrap script, the
PeopleSoft virtual machine setup creates a Samba Shared Drive folder system which you access to carry out
this procedure. On the Microsoft Windows VM you have designated for the PeopleTools client, map a
drive to the Samba Share Drive folder for the PeopleSoft virtual machine.

For example, map drive C: to \\192.168.1.103.

  1. Go to the T:\tools-client folder (from Samba Share).
  2. Open a command prompt, running as administrator.
  3. Go to the C:\tools-client directory, and run the setup script with this command:
    SetupPTClient.bat -t
  4. Answer Y at the following prompt to deploy the PeopleTools Client:
    Do you want to deploy PeopleTools client? [Y/N]: Y
  5. Press ENTER to accept the default location to the installation directory, referred to as PSHOME, for the PeopleTools Client for the following prompt:
    Please specify the PSHOME for the PeopleTools Client [C:\PT8.55.01_Client]:
  6. Choose 1 (Oracle) for the Database Platform for the database that you want to access.
    Please Select the Database Platform:
    1.    Oracle
    2.    DB2 for LUW
    3.    Microsoft SQL Server
    4.    DB2 for zOS
    Enter your choice [1-4] : 1
  7. Enter Y or N at the following prompt:
    Do you want to configure PeopleTools client? [Y/N]:

    If you answer N (no), you do not want to configure the PeopleTools client, continue with step 8.
    If you answer Y (yes), specify the information for your environment at the following prompts:
    • Database Name:
    • Server Name:
    • UserId:
    • Connect ID:
    • Connect Password:
    • Retype Connect Password
  8. Choose 2 (Tools Patch) at the following prompt:
    Please make your selection for the Tools Client deployment:
    1.    Tools Full Upgrade
    2.    Tools Patch
    3.    None of the above
    Enter your choice [1-3]:
  9. Enter Y to install Change Assistant at the following prompt:
    Do you want to install Change Assistant? [Y/N]:
  10. Press ENTER to accept the default deployment location (referred to as PSFT_BASE) at the next prompt:
    Please specify the directory to install Change Assistant
    [C:\Program Files\PeopleSoft\Change Assistant]:
  11. Type Y or N to the following prompts:
    Do you want to install Change Impact Analyzer? [Y/N]: 
    Do you want to install PeopleSoft Test Framework? [Y/N]:
    Do you want to configure PeopleSoft Test Framework? [Y/N]:
  12. To review the log file for the setup process, go to:

    %USERPROFILE%\AppData\Local\Temp\PeopleSoft\PTClientDeploy.log.

    For example,  C:\Users\username\AppData\Local\Temp\PeopleSoft\PTClientDeploy.log.

The environment set up by the PeopleTools Client deployment depends upon the type of deployment you selected:

  • Tools Upgrade

    The deployment process installs a PeopleTools client PS_HOME that includes the directories needed for a PeopleSoft PeopleTools-only upgrade, such as data, projects, and scripts directories.

    To apply the actual upgrade, see the PeopleTools upgrade documentation for information.
    See the tutorial Performing PeopleTools-Only Upgrade on PeopleSoft Environments Running in Oracle Cloud.
  • Tools Patch
    The deployment process installs a PeopleTools client PS_HOME that includes the directories needed for a PeopleSoft PeopleTools patch application, such as the PTP directory.
    To apply the actual patch, see the PeopleTools Patch documentation for information.
  • Tools Client
    The deployment process installs a PeopleTools client PS_HOME. Choose the deployment type "None of the above” for this deployment.
  • Change Assistant installation
    You can install Change Assistant as part of the PeopleTools Client deployment, or as a separate installation.

Applying the PeopleTools Patch

  1. Open the readme.txt file from the \tools-client folder, where the SetupPTClient.bat is located.
  2. Follow the step-by-step detailed instructions for applying the patch.

Verification and Testing

Test the VM to ensure that it was configured correctly by logging in to PIA to make sure that the server is accessible. 

For Process Scheduler servers this will involve running test reports or audits. Note that you must set up report distribution to see the posted reports.

Test the PeopleTools Client by logging into Application Designer, Configuration Manager and other client components (Change Assistant, Change Impact Analyzer, and PeopleSoft Test Framework if they are deployed).

Want to Learn More?