Copy the Application Software

If your source application or web tiers are running on the Linux operating system with a current version of PeopleTools, then you will be able to manually migrate (“lift and shift”) the application and web tiers to the OCI environment. This example uses PeopleTools 8.57.11 and Oracle Linux version 7 (OEL 7) with the latest update.

If your source middle tier nodes are running a non-Linux operating system, then you must install the PeopleSoft application and web tiers on your OCI compute instances, using the psft-dpk-setup.sh tooling. You must install Puppet for orchestration. See PeopleSoft PeopleTools 8.58 Deployment Packages Installation for instructions.

Manually Lift PeopleSoft Application and Web Tiers

“Lifting” the PeopleSoft application and web tier software from the source system involves packaging up the PeopleSoft software install on the source system. The on-premises PeopleSoft environment can be up and running during this process.
  1. Log in to one of your source application web tier servers as the application owner (psadm2).
  2. Zip up the following locations:
    • PS_HOME
    • PS_APP_HOME
    • PS_CUST_HOME
    • JAVA_HOME
    • BEA home directory
    • ORACLE_HOME
    • TNS_ADMIN
    $ zip -r ps_home.zip $PS_HOME
    $ zip -r ps_app_home.zip $PS_APP_HOME
    $ zip -r ps_cust_home.zip $PS_CUST_HOME
    $ zip -r ps_jdk.zip $JAVA_HOME
    $ zip -r bea.zip BEA directory location/bea
    $ zip -r oracle_home.zip $ORACLE_HOME
    $ zip -r tns_admin.zip $TNS_ADMIN
    TIP: If several of these locations are subdirectories under a main directory, such as /u01/app/psft/pt, you can zip up the main directory:
    $ zip -r pt.zip /full-path/pt

    To capture the Tuxedo application and process scheduler domain configurations, also zip up the PS_CFG_HOME/appserv directory and PS_CFG_HOME/peoplesoft.properties file. Do not zip up the PS_CFG_HOME/webserv directory, as this will be rebuilt on the OCI compute instances.

  3. Upload (copy) all ZIP files to the shared directory created on one of the OCI compute instances. Note you will perform the remote copy on the OCI environment as the opc user.
    It may be necessary to allow write privileges for the opc user to write to the above directory. You can remove the privilege once the copy is complete.
    From the source or on-premises system, you can use the scp command to copy the ZIP files if you have several:
    $ scp -I path to key file *.zip opc@IP address to iad-psft-hcm-app01:/u01/app/psft/pt/
    If you created one large ZIP file, then your command may be similar to:
    $ scp -I path to key file pt.zip opc@iad-psft-hcm-app01:/u01/app/psft/
  4. Change ownership of the ZIP files to psadm2 on the OCI compute instance.
    $ ssh -I path to key file opc@iad-psft-hcm-app01
    $ sudo su – root
    # cd /u01/app/psft/pt
    # chown psadm2:oinstall *.zip

Install the PeopleSoft Software

To install the PeopleSoft software, unzip the uploaded ZIP files into the correct directory locations. Since the file system is shared across all middle tiers in OCI, this is done on just one of the PeopleSoft compute instances.
  • Unzip the uploaded ZIP files onto one of the PeopleSoft compute instances.
    • An example of unzipping individual ZIP files:

      $ ssh -I path to key file opc@iad-psft-hcm-app01
      $ sudo su – psadm2
      $ cd /u01/app/psft/pt
      $ unzip ps_home.zip
      $ unzip ps_app_home.zip
      $ unzip ps_cust_home.zip
      $ unzip ps_jdk.zip
      $ unzip ps_bea.zip
      $ unzip oracle_home.zip
      $ unzip tns_admin.zip
    • If all your directories are in one ZIP file, your command will be similar to the following:

      $ ssh -I path to key file opc@iad-psft-hcm-app01
      $ sudo su – psadm2
      $ cd /u01/app/psft
      $ unzip pt.zip

Restore the Application and Process Scheduler Domain Configuration

If you captured the application server (APPSRV) and process scheduler (PRCS) domain configurations from the source system under PS_CFG_HOME/appsrv directory, then you can restore these configurations onto those OCI compute instances that will host the application server and process scheduler server domains.
  1. Copy the ps_cfg_home.zip file to all OCI compute instances that will host the application and process scheduler domains.
  2. As the psadm2 user, unzip the file on each of those OCI compute instances.
    $ cd $PS_CFG_HOME
    $ unzip ps_cfg_home.zip
  3. Verify that the directory structure looks similar to the following:
    Application server domain:
    
    $PS_CFG_HOME/appserv/App server domain name from source system
    Process scheduler domain:
    $PS_CFG_HOME/appserv/App server domain name from source system/prcs/Process server domain name from source system

Create Custom Administrative Scripts

You can create and populate your custom administrative script directory, $SCRIPT_DIR, introduced in the PeopleSoft Software Directory Structure. For examples, see the sample scripts in the Basic Tasks directory in GitHub.