PeopleTools 8.54.11 Patch Installation Instructions
*****************************************
PREREQUISITES
***************
1. PeopleTools 8.54 installed
2. Database connectivity established
3. Review all Patch Notes listed below the Patch Installation section in this document
PATCH INSTALLATION
**********************
1.1. Create an Empty folder named pt85411 on your system.
1.2. Copy 85411.zip into pt85411 folder, and extract the contents of the ZIP file into this same folder.
2. Shut down any application servers, web servers, Process Scheduler servers, and EM Agents that are currently running. Completely exit any running psadmin processes after shutting down your application servers, web servers, and Batch Servers.
2.1. Make sure that there are no lingering threads from any server processes. Such threads can interfere with successfully installing new server files. If there are any threads remaining after you shutdown the servers and domains, you need to manually kill or remove them.
2.2. AIX Customers please note: You must run the 'slibclean' utility (as 'root') on your server(s) to remove any unused shared libraries from memory.
2.3. Stop EM Agents using <PS_HOME>\PSEMAgent\StopAgent.bat or /StopAgent.sh
3. Back up your existing PeopleTools 8.54 folders
3.1. Back up your existing <PS_HOME> and <PS_CFG_HOME> target locations on all servers where you intend to install this Patch.
3.1.1. The variable <PS_HOME> refers to the location of the high-level directory where you have already installed PeopleTools 8.54.
3.1.2. The variable <PS_CFG_HOME> refers to the location of the high-level directory where your configuration files are stored. If the variable <PS_CFG_HOME> has not been explicitly set on your server to another location, it will default to $HOME/psft (Unix/Linux) and %HOMEDRIVE%%HOMEPATH%\psft (Windows).
4. Install Patch Files
4.1. For Windows:
4.1.1. Run \pt85411\cd85411\Disk1\setup.bat
4.1.2. Provide the license code you used to install the base PeopleTools 8.54 DVD/ZIP, and install the patched components to all of the appropriate PeopleSoft Servers (Application Server, Batch Server, Database Server, Web Server, and File Server).
4.1.3. Install the patch on top of your existing high-level PeopleSoft folder. (Note: Ensure you created a back-up of your <PS_HOME> as indicated in step 1 first, so that you can restore any pre-existing files or configuration if unforeseen trouble occurs.)
4.1.4. z/OS: If you are running a batch (Process Scheduler) server on z/OS, transfer the files you just installed to the z/OS batch server by running the PeopleSoft Server Transfer program (pstrans.exe).
4.1.4.1. Run <PS_HOME>\bin\client\winx86\pstrans.exe. (Please refer to the 'Setting up the Batch Environment on z/OS' chapter in your 'Enterprise PeopleTools 8.54 Installation for DB2 UDB for z/OS' book for more details on using the pstrans.exe utility and reconfiguring your Process Scheduler server.)
4.2. For UNIX/Linux:
4.2.1. Change file permissions on the installation files to make them executable on UNIX/Linux servers:
chmod +x setup.sh
chmod +x ./InstData/setup.*
4.2.2. Install the binaries by running the /pt85411/cd85411/Disk1/setup.sh installer shell script:
./setup.sh -tempdir /tmp
4.2.3. Provide your license code that you used to install the base PeopleTools 8.54 DVD/ZIP, and install the patched components to all of the applicable PeopleSoft Servers (Application Server, Batch Server, Database Server, Web Server, and File Server).
4.2.4. Install the patch on top of your existing high-level PeopleSoft folder (<PS_HOME>). (Note: Ensure you created a back-up of your <PS_HOME> location as indicated in step 1 first, so that you can restore any pre-existing files or configuration if unforeseen trouble occurs.)
5. Using Change Assistant (CA), apply all 8.54.11 database changes and clear rowset cache - You can now apply all database changes for this patch by installing a single PeopleTools Package (PTP) using new functionality available in Change Assistant. By using this new preferred method in PeopleTool 8.54, you can skip the manual steps 6 through 9 below.
5.1. Install the 8.54.11 version of Change Assistant found in <PS_HOME>\setup\PsCA
5.2 Apply the PTP85411 PeopleTools Package through Change Assistant using the graphical interface, within the Update Manager mode, under 'Apply a Patch to Your Current PeopleTools Release'. (NOTE: DB2/zOS customers must edit the script listed in step 8.2 below before applying this Package.) Additional details can be found in the Change Assistant and Update Manager PeopleBook - Using Change Assistant with PeopleSoft Update Manager - Chapter 12 Applying PeopleTools Patch.
5.2.1 Optionally, if you have configured a target environment and general options in Change Assistant, you can apply the PTP via the command line by using an updated version of the following syntax:
Changeassistant.bat -MODE UM -ACTION PTPAPPLY -TGTENV <YOUR_TARGET_DB_ENV_NAME_LIKE_PT854TST> -UPD PTP85411
5.3 Skip to step 10 to complete patch installation
6. Update Your Database with Patch Version Information and Clear Rowset Cache
6.1. Using PeopleTools 8.54.11 launch Data Mover and log on to your database as a PeopleSoft User.
6.2. Run the script <PS_HOME>\scripts\ptpatch.dms (Note: This script can only be run once per database per patch. If you reapply this patch to the same database, do not run this script again.)
6.3. Run the script <PS_HOME>\scripts\clear_rowset_cache.dms, to clear old and possibly incompatible Rowset Cache objects from the database.
7. Install Database Changes Included in this Patch
7.1. Using PeopleTools 8.54.11, launch Application Designer, and sign on to the database as a PeopleSoft User.
7.2. Select <Tools>, <Copy Project>, <From File>
7.3. Enter <PS_HOME>\projects and select PATCH854 from the list of projects.
7.4. Select <Options> and highlight the languages <Common> and <English> ONLY.
7.5. Select <Copy> to begin copying updated PeopleTools objects to your database.
==
(Steps 7.6 through 7.16 below are for All customers who are currently using PeopleTools 8.54.01, 02, 03, through 8.54.10. All other customers upgrading from a prior PeopleTools release (like 8.53, or 8.52, etc...) directly to 8.54 11 or a later patch can skip to step 7.17.)
==
7.6. To create PeopleTools indexes select Build, Project.
7.7. Select Create Indexes.
7.8. Select Build script file in the Build Execute Options region.
7.9. Click Settings and select the Scripts tab.
7.10. Select Write Alter comments to script. Enter script file name(s) in the Script File Names region.
7.11. Select the Alter tab and ensure that the Adds, Changes, Renames, and Deletes check boxes are selected in the Alter Any region. Drop column if data present should be selected in the Drop Column Options region and Truncate data if field too short should be selected in the Change Column Length Options region. Make sure that the option Alter by Table Rename is selected in the Alter Table Options region.
7.12. Select the Create tab and ensure that the Skip table if it already exists, Recreate view if it already exists, and Recreate index only if modified options are selected. Click OK.
7.13. When the Build dialog box reappears, Click Build.
7.14. Click Close when the process is completed.
7.15. Edit the generated SQL script for the correct tablespace names and sizing parameters if you are not using delivered PeopleSoft tablespace names.
7.16. Run the generated SQL script(s) in your preferred platform-specific query tool to bring your database structure in sync with the PeopleSoft PeopleTools record definitions.
7.17. When the copy (and if applicable, build) steps above are complete, if you have no additional languages installed, you can exit Application Designer.
8. Load Updated PeopleTools System Data Included in this Patch
8.1. Using PeopleTools 8.54.11, launch Data Mover, and sign on to the database as a PeopleSoft User.
8.2. Run <PS_HOME>\scripts\patch854tls.dms to load updated system seed data into the PeopleTools tables
8.3. Exit Data Mover.
9. Load Translations and Translated PeopleTools Messages
9.1. Load PeopleTools Patch Translations (Steps 9.1 - 9.1.6 are for Multilingual Installations Only)
9.1.1. Using PeopleTools 8.54.11, launch Application Designer, and sign on to the database as a PeopleSoft User.
9.1.2. Select <Tools>, <Copy Project>, <From File>.
9.1.3. Enter <PS_HOME>\projects and select PATCH854ML from the list of projects.
9.1.4. Select <Options> and highlight the languages you have installed. Note: Do not select <Common> or <English> for this step.
9.1.5. Select Copy to begin copying updated PeopleTools objects to your database
9.1.6. When the copy completes, exit Application Designer.
9.2 Load PeopleTools Multilingual Messages and System Data
9.2.1. Using PeopleTools 8.54.11, launch Data Mover, and sign on to the database as a PeopleSoft User.
9.2.2. Run <PS_HOME>\scripts\msgtl<lang_cd>.dms to load the updated messages into your database. Where <lang_cd> = each of your installed languages, including English.
9.2.3. Run <PS_HOME>\scripts\patch854tls<lang_cd>.DMS to load the translated system seed data into your database. Where <lang_cd> = each of your additional installed languages, excluding English.
9.2.4. Exit Data Mover.
10. Completing Installation and configuring this PeopleTools Patch
10.1. Reinstall any products as needed from the following folders:
10.1.1. Change Assistant: <PS_HOME>\setup\PsCA (If you already installed the 8.54.11 version of Change Assistant in step 5.1, you can skip this installation.)
10.1.2. PeopleSoft Internet Architecture (PIA): <PS_HOME>\setup\PsMpPIAInstall
10.1.2.1. Choose 'Redeploy PeopleSoft Internet Architecture' when prompted
10.1.3. PeopleSoft Test Framework <PS_HOME>\setup\PsTestFramework
10.1.4. PeopleSoft Client - <PS_HOME>\setup\Client\Disk1 (Note: If you installed this PeopleTools Patch on UNIX or Linux, you can copy the complete “Client” directory structure (found inside <PS_HOME\setup\Client) to a Microsoft Windows machine. You can then share that Client installer location out across the network for anyone who needs to re-install the PeopleSoft Client locally.)
10.2. Re-Create your Application Server Domain(s). You must recreate your Application Server Domains after applying any PeopleTools Patch. You can typically use the same name and all of the same information as was in-use prior to the application of this patch, but you must recreate the domain and not just copy the old configuration file as corruption can occur in some instances.
10.3. Purge all Web Server cache. (Knowledge Management document <Document: 753215.1> has more details on purging if needed.)
10.4. Re-start your Application server(s), Batch server(s), Web Server(s), and EM Agents.
*****************************************
PREREQUISITES
***************
1. PeopleTools 8.54 installed
2. Database connectivity established
3. Review all Patch Notes listed below the Patch Installation section in this document
PATCH INSTALLATION
**********************
1.1. Create an Empty folder named pt85411 on your system.
1.2. Copy 85411.zip into pt85411 folder, and extract the contents of the ZIP file into this same folder.
2. Shut down any application servers, web servers, Process Scheduler servers, and EM Agents that are currently running. Completely exit any running psadmin processes after shutting down your application servers, web servers, and Batch Servers.
2.1. Make sure that there are no lingering threads from any server processes. Such threads can interfere with successfully installing new server files. If there are any threads remaining after you shutdown the servers and domains, you need to manually kill or remove them.
2.2. AIX Customers please note: You must run the 'slibclean' utility (as 'root') on your server(s) to remove any unused shared libraries from memory.
2.3. Stop EM Agents using <PS_HOME>\PSEMAgent\StopAgent.bat or /StopAgent.sh
3. Back up your existing PeopleTools 8.54 folders
3.1. Back up your existing <PS_HOME> and <PS_CFG_HOME> target locations on all servers where you intend to install this Patch.
3.1.1. The variable <PS_HOME> refers to the location of the high-level directory where you have already installed PeopleTools 8.54.
3.1.2. The variable <PS_CFG_HOME> refers to the location of the high-level directory where your configuration files are stored. If the variable <PS_CFG_HOME> has not been explicitly set on your server to another location, it will default to $HOME/psft (Unix/Linux) and %HOMEDRIVE%%HOMEPATH%\psft (Windows).
4. Install Patch Files
4.1. For Windows:
4.1.1. Run \pt85411\cd85411\Disk1\setup.bat
4.1.2. Provide the license code you used to install the base PeopleTools 8.54 DVD/ZIP, and install the patched components to all of the appropriate PeopleSoft Servers (Application Server, Batch Server, Database Server, Web Server, and File Server).
4.1.3. Install the patch on top of your existing high-level PeopleSoft folder. (Note: Ensure you created a back-up of your <PS_HOME> as indicated in step 1 first, so that you can restore any pre-existing files or configuration if unforeseen trouble occurs.)
4.1.4. z/OS: If you are running a batch (Process Scheduler) server on z/OS, transfer the files you just installed to the z/OS batch server by running the PeopleSoft Server Transfer program (pstrans.exe).
4.1.4.1. Run <PS_HOME>\bin\client\winx86\pstrans.exe. (Please refer to the 'Setting up the Batch Environment on z/OS' chapter in your 'Enterprise PeopleTools 8.54 Installation for DB2 UDB for z/OS' book for more details on using the pstrans.exe utility and reconfiguring your Process Scheduler server.)
4.2. For UNIX/Linux:
4.2.1. Change file permissions on the installation files to make them executable on UNIX/Linux servers:
chmod +x setup.sh
chmod +x ./InstData/setup.*
4.2.2. Install the binaries by running the /pt85411/cd85411/Disk1/setup.sh installer shell script:
./setup.sh -tempdir /tmp
4.2.3. Provide your license code that you used to install the base PeopleTools 8.54 DVD/ZIP, and install the patched components to all of the applicable PeopleSoft Servers (Application Server, Batch Server, Database Server, Web Server, and File Server).
4.2.4. Install the patch on top of your existing high-level PeopleSoft folder (<PS_HOME>). (Note: Ensure you created a back-up of your <PS_HOME> location as indicated in step 1 first, so that you can restore any pre-existing files or configuration if unforeseen trouble occurs.)
5. Using Change Assistant (CA), apply all 8.54.11 database changes and clear rowset cache - You can now apply all database changes for this patch by installing a single PeopleTools Package (PTP) using new functionality available in Change Assistant. By using this new preferred method in PeopleTool 8.54, you can skip the manual steps 6 through 9 below.
5.1. Install the 8.54.11 version of Change Assistant found in <PS_HOME>\setup\PsCA
5.2 Apply the PTP85411 PeopleTools Package through Change Assistant using the graphical interface, within the Update Manager mode, under 'Apply a Patch to Your Current PeopleTools Release'. (NOTE: DB2/zOS customers must edit the script listed in step 8.2 below before applying this Package.) Additional details can be found in the Change Assistant and Update Manager PeopleBook - Using Change Assistant with PeopleSoft Update Manager - Chapter 12 Applying PeopleTools Patch.
5.2.1 Optionally, if you have configured a target environment and general options in Change Assistant, you can apply the PTP via the command line by using an updated version of the following syntax:
Changeassistant.bat -MODE UM -ACTION PTPAPPLY -TGTENV <YOUR_TARGET_DB_ENV_NAME_LIKE_PT854TST> -UPD PTP85411
5.3 Skip to step 10 to complete patch installation
6. Update Your Database with Patch Version Information and Clear Rowset Cache
6.1. Using PeopleTools 8.54.11 launch Data Mover and log on to your database as a PeopleSoft User.
6.2. Run the script <PS_HOME>\scripts\ptpatch.dms (Note: This script can only be run once per database per patch. If you reapply this patch to the same database, do not run this script again.)
6.3. Run the script <PS_HOME>\scripts\clear_rowset_cache.dms, to clear old and possibly incompatible Rowset Cache objects from the database.
7. Install Database Changes Included in this Patch
7.1. Using PeopleTools 8.54.11, launch Application Designer, and sign on to the database as a PeopleSoft User.
7.2. Select <Tools>, <Copy Project>, <From File>
7.3. Enter <PS_HOME>\projects and select PATCH854 from the list of projects.
7.4. Select <Options> and highlight the languages <Common> and <English> ONLY.
7.5. Select <Copy> to begin copying updated PeopleTools objects to your database.
==
(Steps 7.6 through 7.16 below are for All customers who are currently using PeopleTools 8.54.01, 02, 03, through 8.54.10. All other customers upgrading from a prior PeopleTools release (like 8.53, or 8.52, etc...) directly to 8.54 11 or a later patch can skip to step 7.17.)
==
7.6. To create PeopleTools indexes select Build, Project.
7.7. Select Create Indexes.
7.8. Select Build script file in the Build Execute Options region.
7.9. Click Settings and select the Scripts tab.
7.10. Select Write Alter comments to script. Enter script file name(s) in the Script File Names region.
7.11. Select the Alter tab and ensure that the Adds, Changes, Renames, and Deletes check boxes are selected in the Alter Any region. Drop column if data present should be selected in the Drop Column Options region and Truncate data if field too short should be selected in the Change Column Length Options region. Make sure that the option Alter by Table Rename is selected in the Alter Table Options region.
7.12. Select the Create tab and ensure that the Skip table if it already exists, Recreate view if it already exists, and Recreate index only if modified options are selected. Click OK.
7.13. When the Build dialog box reappears, Click Build.
7.14. Click Close when the process is completed.
7.15. Edit the generated SQL script for the correct tablespace names and sizing parameters if you are not using delivered PeopleSoft tablespace names.
7.16. Run the generated SQL script(s) in your preferred platform-specific query tool to bring your database structure in sync with the PeopleSoft PeopleTools record definitions.
7.17. When the copy (and if applicable, build) steps above are complete, if you have no additional languages installed, you can exit Application Designer.
8. Load Updated PeopleTools System Data Included in this Patch
8.1. Using PeopleTools 8.54.11, launch Data Mover, and sign on to the database as a PeopleSoft User.
8.2. Run <PS_HOME>\scripts\patch854tls.dms to load updated system seed data into the PeopleTools tables
8.3. Exit Data Mover.
9. Load Translations and Translated PeopleTools Messages
9.1. Load PeopleTools Patch Translations (Steps 9.1 - 9.1.6 are for Multilingual Installations Only)
9.1.1. Using PeopleTools 8.54.11, launch Application Designer, and sign on to the database as a PeopleSoft User.
9.1.2. Select <Tools>, <Copy Project>, <From File>.
9.1.3. Enter <PS_HOME>\projects and select PATCH854ML from the list of projects.
9.1.4. Select <Options> and highlight the languages you have installed. Note: Do not select <Common> or <English> for this step.
9.1.5. Select Copy to begin copying updated PeopleTools objects to your database
9.1.6. When the copy completes, exit Application Designer.
9.2 Load PeopleTools Multilingual Messages and System Data
9.2.1. Using PeopleTools 8.54.11, launch Data Mover, and sign on to the database as a PeopleSoft User.
9.2.2. Run <PS_HOME>\scripts\msgtl<lang_cd>.dms to load the updated messages into your database. Where <lang_cd> = each of your installed languages, including English.
9.2.3. Run <PS_HOME>\scripts\patch854tls<lang_cd>.DMS to load the translated system seed data into your database. Where <lang_cd> = each of your additional installed languages, excluding English.
9.2.4. Exit Data Mover.
10. Completing Installation and configuring this PeopleTools Patch
10.1. Reinstall any products as needed from the following folders:
10.1.1. Change Assistant: <PS_HOME>\setup\PsCA (If you already installed the 8.54.11 version of Change Assistant in step 5.1, you can skip this installation.)
10.1.2. PeopleSoft Internet Architecture (PIA): <PS_HOME>\setup\PsMpPIAInstall
10.1.2.1. Choose 'Redeploy PeopleSoft Internet Architecture' when prompted
10.1.3. PeopleSoft Test Framework <PS_HOME>\setup\PsTestFramework
10.1.4. PeopleSoft Client - <PS_HOME>\setup\Client\Disk1 (Note: If you installed this PeopleTools Patch on UNIX or Linux, you can copy the complete “Client” directory structure (found inside <PS_HOME\setup\Client) to a Microsoft Windows machine. You can then share that Client installer location out across the network for anyone who needs to re-install the PeopleSoft Client locally.)
10.2. Re-Create your Application Server Domain(s). You must recreate your Application Server Domains after applying any PeopleTools Patch. You can typically use the same name and all of the same information as was in-use prior to the application of this patch, but you must recreate the domain and not just copy the old configuration file as corruption can occur in some instances.
10.3. Purge all Web Server cache. (Knowledge Management document <Document: 753215.1> has more details on purging if needed.)
10.4. Re-start your Application server(s), Batch server(s), Web Server(s), and EM Agents.
No comments :
Post a Comment