.FO OFF ******************************************************** IBM i5/OS CUMULATIVE PTF PACKAGE INSTALLATION INSTRUCTIONS SF99540 Level 11137 PACKAGE ID: C1137540 VERSION 5 RELEASE 4.0 ******************************************************** Cumulative PTF Package Instructions Last Updated: 05/30/2011 Change History: Note: Online copy of this document is the master. Any printed copy should be assumed to be obsolete and not used unless the date of last update is verified to match that shown on the online master copy. The information contained in this document was current at the time this cumulative PTF package was made available. We recommend you get the most current information which can be found via the following URL: http://www-912.ibm.com/s_dir/sline003.nsf/sline003home From this Web site, select "All Preventive Service Planning Documents by Release", then select "R540". PSP SF98540 lists HIPER PTFs not included in this cumulative PTF package and any defective PTFs identified since this package was released. Starting in V5R4M0, you may now receive the cumulative PTF package in one of three different formats: * Electronically downloaded as individual PTF save files * Electronically downloaded as optical image files * Physical optical media (when it cannot be downloaded electronically) The installation instructions contained in this document will guide you through the install steps needed for each format. ************************************************ * PTF PRE-INSTALLATION INSTRUCTIONS FOR i5/OS * ************************************************ As with any PTF order, before you install the PTFs you should review the cover letter of each delivered PTF for any special instructions that may need to be followed. The cumulative PTF package media itself does not have any PTF cover letters because any special instructions that need to be followed for the cumulative package are contained in this document. However, when you ordered your cumulative PTF package, you were automatically sent the latest HIPER and Database PTF groups along with the cumulative PTF package. You should review the cover letters for the PTFs in these groups that are applicable to your system. The commands needed for copying and printing (or displaying) the PTF cover letter(s) are included below. 1. COPYING PTF COVER LETTERS: * Mount the PTF media and sign on using a security officer user profile such as QSECOFR. * To copy all cover letters from media onto the system for PTFs that are not already applied to your system, enter the following command: CPYPTFCVR DEV(device_name) LICPGM(*ALL) SELECT(*NOTAPY) * To copy a specific cover letter from media onto the system, enter the following command: CPYPTFCVR DEV(device_name) LICPGM(product_id) SELECT(ptf_id) 2. DISPLAYING OR PRINTING PTF COVER LETTERS: * The PTF cover letters must be copied from the media first before they can be displayed or printed. * To display or print cover letters for all PTFs that are currently not applied on your system, enter one of the following commands: DSPPTFCVR LICPGM(*ALL) SELECT(*NOTAPY) DSPPTFCVR LICPGM(*ALL) SELECT(*NOTAPY) OUTPUT(*PRINT) Note: You can also specify CVRATR(*SPCINST) on the DSPPTFCVR command to view all cover letters that have special instructions. * To display or print a specific cover letter, enter one of the following commands: DSPPTFCVR LICPGM(product_id) SELECT(ptf_id) DSPPTFCVR LICPGM(product_id) SELECT(ptf_id) OUTPUT(*PRINT) *********************************************************************** * NOTICE * * * * Failure to follow these instructions may result in failure of your * * system to operate. Follow the directions carefully every time you * * install a cumulative PTF package. * * * * Cumulative PTF packages must be installed delayed for proper PTF * * installation. Do NOT use any immediate apply install options to * * install this package; otherwise, unpredictable results may occur. * ************************************************************************ ************************************************************************ * * * Vital PTF information: Application of PTFs within this cumulative * * PTF package may disable or render ineffective programs that use * * system memory addresses not generated by the IBM translator, * * including programs that circumvent control technology designed to * * limit interactive capacity to purchased levels. These PTFs may * * be prerequisites for future PTFs. By applying these PTFs you * * authorize and agree to the foregoing. * * * ************************************************************************ ************************************************************************ * * * Each of these PTFs is subject to the terms of the license agreement * * which accompanied, or was contained in, the Program for which you * * are obtaining such PTF. You are not authorized to install or use * * any such PTF except as part of the Program for which you have a * * valid Proof of Entitlement. * * * * SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS * * EXPLICITLY AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN * * APPLICABLE SUPPORT AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS * * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED * * WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A * * PARTICULAR PURPOSE, AND NON INFRINGEMENT, REGARDING EACH PTF. * * * * The applicable license agreement may have been provided to you in * * printed form and/or may be viewed using the Work with Software * * Agreements (WRKSFWAGR) CL command. * * * ************************************************************************ ************************************************************************ * * * ATTENTION OBJECTCONNECT USERS: * * If you are running in an OBJECTCONNECT environment with multiple * * systems at V5R4Mx, there are PTFs on this cumulative package which * * must be applied to all systems in that environment. Starting with * * PTF SI25137 which was on cumulative package C7107540, this PTF or * * any of its superseding PTFs must be applied to all systems which are * * in the OBJECTCONNECT environment. If the latest PTFs are already * * applied to all systems in the OBJECTCONNECT environment, then no * * further action should be necessary from an OBJECTCONNECT perspective.* * * ************************************************************************ ************************************************************************ *Attention Content Manager OnDemand - 5722RD1 - Users * * * *If you have Content Manager OnDemand - 5722RD1 - installed, please see* *http://www.ibm.com/support/docview.wss?uid=swg21427866 for any im- * *portant special instructions. * ************************************************************************ ************************************************************************ *If you have DataPropagator for i5/os - 5722DP4 - installed, please * *refer to PSP document SF96013 and review the cover letters for 5722DP4* *PTFs for any important special instructions. * ************************************************************************ The approximate install time for this cumulative PTF package is two to four hours. Note: Installation of this cumulative PTF package may require two IPLs to install. Some PTFs are required to be applied before this package can be applied. If the required PTFs are already applied, only one IPL will be necessary. The PTF install processing will automatically apply the following PTFs when necessary. If the PTF is not already applied and it is superseded in this package, the superseding PTF will be applied. For systems installed with V5R4M0 Licensed Internal Code: 5722999-MF41210 For systems installed with V5R4M5 Licensed Internal Code: none The install instructions will guide you through the installation process which will load all PTFs from the media, then, if necessary, IPL to apply the required PTFs. It will then direct you to complete the installation to apply the remaining PTFs in the package. You should have a current backup of your system before applying this package. If you have backed up your system since the last time you applied PTFs, that backup is acceptable. Be sure the IPL mode is set at Normal on the control panel and sign on using a security officer user profile such as QSECOFR. DO NOT cancel any of the steps once they are started. Allow each step to complete normally. Select the appropriate INSTALL steps below based on the format in which you received the cumulative PTF package. ************************************ * INSTALL FROM OPTICAL IMAGE FILES * ************************************ Use these steps when you ordered and received the cumulative PTF package electronically as optical image files: 1. Create your image catalog and add the image files to the catalog. For information on how to create an image catalog, refer to the iSeries Information Center: http://publib.boulder.ibm.com/infocenter/iseries/v5r4/index.jsp (i5/OS and related software->Maintain and manage i5/OS and related software->Use software fixes->Install fixes->Step 3:Choose your fix installation scenario->Install fixes from an image catalog). 2. Load the image catalog into the virtual optical device using the following command: LODIMGCLG IMGCLG(ptfcatalog) DEVICE(OPTVRTxx) OPTION(*LOAD) 3. Type GO PTF and press the Enter key. 4. Take menu option 8 and press the Enter key. 5. Review the appropriate options and notes which follow, below, then complete the Install Options for Program Temporary Fixes screen and press the Enter key. Device . . . . . . OPTVRTxx (for example, OPTVRT01) Automatic IPL . . Y = Yes or N = No Prompt for media . 1 or 3 Restart type . . . *SYS Other options . . Y = Yes Note: If you have received individual and/or PTF groups as save files that you want to install at the same time as the cumulative PTF package, type 3 in the Prompt for media field. 6. Review the appropriate options and notes which follow, below, then complete the Other Install Options screen and press the Enter key. Omit PTFs . . N = No or Y = Yes Apply type . . 1 = Set all PTFs delayed PTF type . . . 1 = All PTFs Copy PTFs . . N = No or Y = Yes Note: Depending on the previous options specified, some fields above may not be shown. Note: If you have PTFs to omit, type Y in the Other Options field and follow the directions on the displays which follow. Refer to Appendix A in the detailed installation instructions section on omitting PTFs. 7. The display shows the licensed programs for which PTFs are being loaded. All volumes that are loaded in the image catalog are automatically processed. 8. Continue with the COMPLETE THE INSTALL PROCESS section. ****************************** * INSTALL FROM OPTICAL MEDIA * ****************************** Use these steps when you ordered and received the cumulative PTF package as physical optical media: 1. Enter the following command and press the Enter key. CHGMSGQ QSYSOPR *BREAK SEV(70) This step ensures a break message will appear if the system determines you should mount the next volume. IMPORTANT--If there are no PTFs on the other volumes that are applicable to your system, the system will not prompt you for the other volumes. 2. Ensure volume one of the cumulative PTF package media, labeled C1137540_01, is loaded in the appropriate drive for the media you are using. 3. Type GO PTF and press the Enter key. 4. Take menu option 8 and press the Enter key. 5. Review the appropriate options and notes which follow, below, then complete the Install Options for Program Temporary Fixes screen and press the Enter key. Device . . . . . . OPTxx (for example, OPT01) Automatic IPL . . Y = Yes or N = No Prompt for media . 2 or 3 Restart type . . . *SYS Other options . . Y = Yes Note: Enter a 2 in the Prompt for media field in order to install the HIPER and Database PTF groups along with your cumulative PTF package. If you have received individual and/or PTF groups as save files that you want to install at the same time as the cumulative PTF package, type 3 in the Prompt for media field. 6. Review the appropriate options and notes which follow, below, then complete the Other Install Options screen and press the Enter key. Omit PTFs . . N = No or Y = Yes Apply type . . 1 = Set all PTFs delayed PTF type . . . 1 = All PTFs Copy PTFs . . N = No or Y = Yes Note: Depending on the previous options specified, some fields above may not be shown. Note: If you have PTFs to omit, type Y in the Other Options field and follow the directions on the displays which follow. Refer to Appendix A in the detailed installation instructions section on omitting PTFs. 7. The display shows the licensed programs for which PTFs are being loaded. a. After each volume is processed, you will receive a message to mount the next volume. Load the volume indicated and use the G option to continue. b. After all the applicable volumes for the cumulative PTF package have been processed, you will automatically be prompted to mount the first volume of the next media set in order to install the HIPER and Database PTF groups. Mount the first volume in the set and use the G option to continue. c. Continue mounting any additional volumes. When all your volume sets have been processed, use the X option to complete the PTF installation. Note: If there are volumes that contain PTFs that are not applicable to your system, the system will not prompt you to mount those volumes. 8. Continue with the COMPLETE THE INSTALL PROCESS section. ******************************** * COMPLETE THE INSTALL PROCESS * ******************************** Use these steps to complete the install process. 1. If the PTF install completes, continue with step 2. If the Confirm IPL for Special Handling PTFs display is shown: a. Press F10 to end all jobs on the system and IPL the system. b. After the IPL, type GO PTF and press the Enter key. c. Take menu option 8 and press the Enter key. d. The Continue PTF Install display is shown. Press Enter to continue the previous PTF install without loading additional PTFs from an install device. e. Complete the Install Options for Program Temporary Fixes screen and press the Enter key. Device . . . . . . *NONE Automatic IPL . . Y = Yes or N = No Prompt for media . 1 Restart type . . . *SYS Other options . . N = No 2. If you entered a Y (Yes) for the Automatic IPL option, the system will be IPLed automatically. If you entered N (No) for the Automatic IPL field, use the PWRDWNSYS command when you are ready to complete the installation of the package. 3. After the IPL completes, use the following procedure to verify the cumulative PTF package was properly installed: a. Sign on as QSECOFR. b. Type WRKPTFGRP SF99540 on any command line. c. If the Status field is "Installed" and the Level field is "11137", continue with step 4, otherwise, continue with step 3d. d. Type GO LICPGM on any command line. e. Press the Enter key. The Work with Licensed Programs display is shown. f. Select option 50. g. Press the Enter key. The Install History display is shown. h. Press the Enter key. The Display History Log Contents display appears. * If the cumulative PTF package was installed successfully, you will see messages indicating the applying of PTFs completed. Continue with step 5. * If the cumulative PTF package was not installed successfully, you will see messages indicating the applying of PTFs failed. Contact your provider of software service for assistance. * If the previous IPL was abnormal, only PTFs for the Licensed Internal Code will be applied (5722999). You can check if the previous IPL was abnormal by typing the following command: DSPSYSVAL SYSVAL(QABNORMSW) If the IPL was abnormal and you are installing this package immediately after a system install, perform the IPL again to apply the remaining PTFs. 4. If you have an eServer i5, you may be required to perform a server IPL to activate fixes that affect the server firmware portion of the Licensed Internal Code. If you do not have an eServer i5 or your system does not have more than 1 logical partition, continue with step 5. A server IPL is an IPL whereby all logical partitions on the server are shut down at the same time. This allows a new level of the server firmware to be activated on the server. If your system is defined as the i5/OS service partition and you are not controlling the level of server firmware using a Hardware Management Console, then you may be required to perform a server IPL if any PTFs that were installed affect the server firmware portion of the Licensed Internal Code. To determine if your system is operating as the service partition and has PTFs that require a server IPL perform the following steps: a. To determine if your system is the service partition, enter the following command and press the Enter key: DSPPTF LICPGM(5722999) b. The Display PTF status display is shown. If the IPL source field shows only ##MACH#B or ##MACH#A, then your system is not defined as the service partition. If the IPL source field shows ##SERV#T or ##SERV#P, then your system is defined as the service partition. c. If message CPD35F8 or CPD35F9 is displayed at the bottom of the panel, then a server IPL must be performed to activate the changes to the server firmware. If you are required to perform a server IPL, ensure your server IPL source is set to ##SERV#T. For information on how to perform a server IPL refer to the iSeries Information Center: http://publib.boulder.ibm.com/infocenter/iseries/v5r4/index.jsp (i5/OS and related software->Maintain and manage i5/OS and related software->Use software fixes->Install fixes->Step 3: Choose your fix installation scenario->Install fixes on systems managed by Hardware Management Console). Note: If your server has only one partition defined, no special steps need to be performed. The next IPL will activate the changes to the server firmware. 5. You can resume normal system operation at this time. You should back up your system again at your earliest convenience. If you have comments or concerns with cumulative PTF packages, contact your provider of software service.