************************************************************************** * Extension Software October, 1997 READMEFIRST * ************************************************************************** Contents of this Document ------------------------- 1. What is HP-UX Extension Software? o Location of Patch Bundles - Layout of CD-ROM o Extension Software Documentation - Obtaining Additional Information About Extension Software - Obtaining Information on Each Bundle - Obtaining Information on Individual Patches o User Comments 2. Installing Extension Software o Overwriting New Patches o Installing Extension Software on a 9.X System o Installing on a 9.X system - Instructions to Install on a 9.X System o Installing on a 10.X System - Standalone Installation - Heterogeneous NFSD Cluster - Homogeneous NFSD Cluster - Instructions to Install on a 10.X System o List of Errors that Should Be Disregarded 3. Legal Notices **************************************************************************** 1. What is HP-UX Extension Software? #################################### ************************** NOTE ***************************************** The CD-ROM you have just received is cumulative and replaces all other Extension Software CD-ROMs. If you have others, please discard them. ************************************************************************* The CD-ROM in this package is labelled: Part No.: B3782-10209 HP-UX Extension Software DateCode: 3737 Make sure the label on your CD-ROM, and in particular the part number, matches the above description. Each Extension Software CD-ROM has a corresponding READMEFIRST. Check that you use the latest CD-ROM and READMEFIRST. Extension Software is HP's umbrella term for three types of patches: * general-release patches. These patches pertain to core HP-UX and are of interest to all customers. * critical patches. These patches fix problems that cause data loss or data corruption. * hardware-enablement patches. These patches allow new peripherals to run on existing systems. Also included with these patches are hardware drivers. This CD-ROM contains groups of patches called patch bundles that cover several HP-UX releases. The patch bundle types are listed below according to the HP-UX series. HP recommends that you install the General-Release Patch Bundles. General-Release Patch Bundles contain all patches: general-release patches, critical patches, and hardware-enablement patches. Location of Patch Bundles ------------------------- The examples throughout this document, assume you will use /cdrom as the mount directory. If the CD-ROM is mounted to some other directory, substitute the name of that directory for /cdrom in the pathnames used here. The patch bundles are located in the following directories: Series Depot Path Patch Bundle Type of Patches ---------- ------------------- --------------- ---------------- Release 9.04 ------------ Series 800 /cdrom/9.X/800/9.04 XSW800GR0904 General-Release Series 800 /cdrom/9.X/800/9.04 XSW800HWCR904 Hardware-Enablement & Critical Release 9.05 ------------ Series 700 /cdrom/9.X/700/9.05 XSW700GR0905 General-Release Release 9.07 ------------ Series 700 /cdrom/9.X/700/9.07 XSW700GR0907 General-Release Release 10.01 - Refreshed ------------------------- Series 700 /cdrom/10.X/700/10.01 XSW700GR1001 General-Release Series 700 /cdrom/10.X/700/10.01 XSW700CR1001 Critical Series 700 /cdrom/10.X/700/10.01 XSW700HW1001 Hardware-Enablement Series 800 /cdrom/10.X/800/10.01 XSW800GR1001 General-Release Series 800 /cdrom/10.X/800/10.01 XSW800HWCR1001 Hardware-Enablement & Critical Release 10.10 - Refreshed ------------------------- Series 700 /cdrom/10.X/700/10.10 XSW700CR1010 Critical Series 700 /cdrom/10.X/700/10.10 XSW700GR1010 General-Release Series 700 /cdrom/10.X/700/10.10 XSW700HW1010 Hardware-Enablement Series 800 /cdrom/10.X/800/10.10 XSW800GR1010 General-Release Series 800 /cdrom/10.X/800/10.10 XSW800HWCR1010 Hardware-Enablement & Critical Release 10.20 - Refreshed ------------------------- Series 700 /cdrom/10.X/700/10.20 XSW700CR1020 Critical Series 700 /cdrom/10.X/700/10.20 XSW700GR1020 General-Release Series 700 /cdrom/10.X/700/10.20 XSW700HW1020 Hardware-Enablement Series 800 /cdrom/10.X/800/10.20 XSW800GR1020 General-Release Series 800 /cdrom/10.X/800/10.20 XSW800HWCR1020 Hardware-Enablement & Critical ************************** NOTE ***************************************** The patch bundles that are refreshed (updated) in this CD-ROM are for the following releases: 10.01, 10.10, 10.20. The 9.05 patch bundle has the same patch bundles as those in the March, 1997 Extension Software CD-ROM, part number B3782-10162. The 9.04 and 9.07 patch bundles have the same contents as those in the November 1996 Extension Software CD-ROM, part number B3782-10132. The 9.X patch bundles have new names. ************************************************************************* Layout of CD-ROM ---------------- The CD-ROM layout looks like this: /cdrom/10.X/ 700/ 10.01/ XSW700CR1001 XSW700GR1001 XSW700HW1001 10.10/ XSW700GR1001 XSW700CR1001 XSW700HW1001 10.20/ XSW700CR1020 XSW700GR1020 XSW700HW1020 800/ 10.01/ XSW800GR1001 XSW800HWCR1001 10.10/ XSW800GR1010 XSW800HWCR1010 10.20/ XSW800GR1020 XSW800HWCR1020 /cdrom/9.X /700 /9.05/ XSW700GR0905 /9.07/ XSW700GR0907 /800 /9.04/ XSW800GR0904 XSW800HWCR0904 /cdrom/READMEFIRST /cdrom/Documentation/ patch_pgrm.txt Readme_10.X/ add_info_10.X patch_bundle_name.lst Readme_9.X/ add_info_9.X patch_bundle_name.lst The patch bundle names remain the same from release to release. Extension Software Documentation -------------------------------- This document explains how to install the patch bundles. Obtaining Additional Information About Extension Software --------------------------------------------------------- The ascii files add_info_9.X and add_info_10.X provide information such as: * an introduction to Extension Software * steps to follow before installing the patch bundle * installation considerations * using interactive and non-interactive modes * removing patches and recovering disk space These files are located on the CD-ROM in the 9.X and 10.X Readme directories. For example: /cdrom/Documentation/Readme_9.X/add_info_9.X The HP-UX Patch Program White Paper (patch_pgrm.txt) is included on the CD-ROM for your convenience. Obtaining Information on Each Bundle ------------------------------------ Each patch bundle has a corresponding patch_bundle_name.lst file. These ascii files contain the following information: * bundle contents list * disk usage * other information specific to the bundle These files are located on the CD-ROM in the 9.X and 10.X Readme directories. For example: /cdrom/Documentation/Readme_10.X/XSW700HW1020.lst When a patch bundle is installed, these files will be installed in the /usr/share/doc/Extension_Software/ directory. Obtaining Information on Individual Patches ------------------------------------------- To obtain information on individual patches, do the following. on a 9.X system: 1. Install patch documentation: /etc/update -s absolute_path_of_patch_bundle_depot PATCHES-TEXT For example, for information about patches in the XSW700HW0905 bundle, type: /etc/update -s /cdrom/9.X/700/9.05/XSW700HW0905 PATCHES-TEXT 2. Read the PHXX_yyyyy.text file in the /tmp/PHTXT/ directory. on a 10.X system: 1. Install the patch documentation: /usr/sbin/swinstall -s absolute_path_of_patch_bundle_depot PatchText For example, for information about patches in the XSW800HW1020 bundle, type: /usr/sbin/swinstall -s /cdrom/10.X/800/10.20/XSW800HW1020 PatchText 2. Read the PHXX_yyyyy.text file in the/tmp/PHTXT/patch_bundle_name directory. User Comments ------------- Please send your comments regarding the contents, form, and ease of use to: extsw@cup.hp.com 2. Installing Extension Software ################################ Before you install Extension Software, do the following: 1. Read this document. If you are not familiar with Extension Software, read the add_info_9.X or add_info_10.X document. 2. Plan downtime. Install the patch bundles when the system is not being used. 9.X systems must be in single-user mode. Be sure to schedule a time that is convenient for your users. The system, and any NFS Diskless HP-UX cluster clients, will be rebooted when the patch bundle is installed. 3. Read the following note. We recommend that you install the General-Release Bundles which include all the patches, but in case you use the Pick and Choose method, please read the following. ************************** NOTES ***************************************** Patch PHKL_9724 for 10.20: This patch has been recalled and removed from distribution. Multi-processor s800 systems with this patch installed may see X11R6 applications hang in the poll() system call. The problem has been experienced by CDE customers when moving or resizing dtterm windows. The dtterm processes will hang, but they can be killed. Other applications that use the poll() system call may also be affected. Series 700 single processor systems and applications using X11R5 are not affected. HP recommends that patch PHKL_9724 be removed from any s800 multi-processor system that is using an application that utilizes the poll() system call. ---------------------------------------------------------------------- Patch PHSS_9680 for 10.20: Warning - if you remove this patch, it will remove your PEX library. You will need to restore this library from a backup media. This problem will be fixed in XR35. ------------------------------------------------------------------------ Patch PHKL_9365 for 10.20: If you have a PA-8000 based system, PLEASE INSTALL THIS CRITICAL PATCH. This patch is part of the Series 700 patch bundle for HP-UX 10.20. You can install either XSW700GR1020 or XSW700CR1020. ------------------------------------------------------------------------- Patch PHKL_9366 for 10.20: If you have a PA-8000 based system, PLEASE INSTALL THIS CRITICAL PATCH. This patch is part of the Series 800 patch bundle for HP-UX 10.20 You can install either XSW800GR1020 or XSW800CR1020. -------------------------------------------------------------------------- Patch PHKL_7359 for 10.10: This patch is part of the Series 700 patch bundle for HP-UX 10.10 (XSW700GR1010 and XSW700CR1010) and Series 800 patch bundle for HP-UX 10.10 (XSW800GR1010). This patch is not considered a critical patch, but is included to prevent problems for customers using NFSD clusters. HP recommends loading PHKL_7359 whether NFSD is used or not. ------------------------------------------------------------------------- Do you plan to install HP OnLineJFS (the advanced VxFS product-AdvJournalFS.VXFS-ADV-KRN)? If the following patches are installed on your system, you must remove them and all other VxFS patches BEFORE you install the product. Patch PHKL_8731 for the Series 700, 10.01 Patch PHKL_8712 for the Series 800, 10.01 Patch PHKL_9073 for the Series 700, 10.10 Patch PHKL_9074 for the Series 800, 10.10 Patch PHKL_9529 for the Series 700, 10.20 Patch PHKL_9530 for the Series 800, 10.20 Use swremove or swcluster to remove VxFS patches. All patches listed in the Supersedes field in the /tmp/PHTXT/PHKL_xxxxx file (where PHKL_xxxxx is the VxFS patch listed above) must be removed, except: on the 700: on the 800: PHKL_6025 PHKL_6024 PHKL_5662 PHKL_5663 PHKL_5739 PHKL_5737 PHKL_5814 PHKL_5813 PHKL_5840 PHKL_5839 PHKL_5889 PHKL_5888 Follow these steps: 1. Open the file /tmp/PHTXT/PHKL_xxxxx.text; find the "Supersedes" field and record the patch names listed there. Do not record the above patches (PHKL_6025, PHKL_5662, PHKL_5739, PHKL_5814, PHKL_5840, PHKL_5889 or PHKL_6024, PHKL_5663, PHKL_5737, PHKL_5813, PHKL_5839, PHKL_5888). 2. Use swremove or swcluster to remove PHKL_xxxxx. 3. Type swlist 4. If any patch name you recorded is displayed, use swremove or swcluster to remove it. 5. Repeat #3 and continue removing patches until you have removed all VxFS patches (PHKL_6025, PHKL_5662, PHKL_5739, PHKL_5814, PHKL_5840, PHKL_5889 or PHKL_6024, PHKL_5663, PHKL_5737, PHKL_5813, PHKL_5839, PHKL_5888). After you have completed installing HP OnLineJFS, PHKL_xxxxx can be re-installed. ************************************************************************* Overwriting New Patches ----------------------- If you have installed any patches since the last time that you installed a patch bundle, you may have installed a patch that is more recent than a patch in the current patch bundle on this CD-ROM. In that case, you will receive this error: ERROR: the patch '<patch_name>' has been superseded by the following patch : <patch_name> >>>> This patch MUST NOT be installed. <<<< The swagent.log file will record the error during the analysis phase as: ERROR: Exclude and during the installation phase as: ERROR: Skipped Do not be concerned about these errors--they are generated for your information. The /cdrom/Documentation/Readme_9.X/patch_bundle_name.lst file contains a list of newer patches as of a PatchDate. The most up-to-date list of patches is available from HP SupportLine. You will use a slightly different procedure depending on whether you are patching a 9.X or a 10.X system. Installing Extension Software on a 9.X System --------------------------------------------- 9.X patch bundles are in Distributed Update and Install (DUI) format. Before installing the patch software on your system, you must install the patch_install tool. Follow the instructions to install patch_install and the patches themselves, as shown here. For more information, refer to /cdrom/Documentation/Readme_9.X/add_info_9.X. Instructions to Install on a 9.X System --------------------------------------- 1. Put the "HP-UX Extension Software" CD-ROM into the CD-ROM drive. 2. Log in as root and put the system in single-user mode: /etc/shutdown 3. Make sure the CD-ROM drive is mounted: /etc/mount If the drive is not mounted, mount it: /etc/mount /dev/dsk/devicefile /your_mount_directory where /your_mount_directory is the name for the CD-ROM drive. If you have just attached the drive to your system, you can use SAM the menu-driven System Adminstration Manager, to create device files for it; go to the Device List menu under Peripheral Devices, click on the entry for the CD-ROM drive, pull down the Actions menu and choose Show Device Files. SAM builds device files if they are not already there. (On a small system, get out of SAM before running Software Distributor (SD), or you may run out of memory.) 4. Install the patch_install tool onto your system: /etc/update -s absolute_path_of_patch_bundle_depot PATCH-TOOLS For example: /etc/update -s /cdrom/9.X/700/9.05/XSW700GR0905 PATCH-TOOLS ************************** CAUTION *********************************** Use /etc/update to install patch_install but DO NOT use it to install the patch bundle itself. Follow the directions below. ********************************************************************** 5. Run patch_install: /etc/patch_install 6. Select Change Source or Destination -> 7. Select From CD-ROM (directory) to Local System... 8. Change the Source Directory: to absolute_path_of_patch_bundle_depot 9. Press Done. 10. Answer n to the question about protected software. There is no protected software on the CD. 11. Choose Select all Applicable Patches on Source Media. 12. Select Start Loading Now. ************************** NOTE ***************************************** ERRORs during installation should be examined. ************************************************************************* Installing Extension Software on a 10.X System ---------------------------------------------- 10.X patch bundles are in Software Distributor (SD) format. Follow the instructions below to install the patches. For more help, refer to /cdrom/Documentation/Readme_10.X/add_info_10.X. The install process is different depending on whether your system is a standalone, a heterogeneous NFSD cluster, or a homogeneous NFSD cluster. For detailed information about SD, refer to the manual Managing HP-UX Software with SD-UX. You can also refer to the man pages on SD commands. Standalone Installation ----------------------- If you wish to run a non-interactive session on a standalone system or 800 NFSD server type: /usr/sbin/swinstall -x autoreboot=true -x match_target=true -x mount_all_filesystems=true -s absolute_path_of_patch_bundle_depot Otherwise, invoke an interactive swinstall session: /usr/sbin/swinstall Either an interactive or non-interactive swinstall session can be executed on either a standalone system or an 800 NFSD server. Heterogeneous NFSD Cluster -------------------------- Installing the patch bundle on a heterogeneous NFSD cluster (a Series 800 server with Series 700 clients) requires two SD sessions. The first is a swinstall session on the NFSD server with the 800 bundle. Follow the steps in the previous standalone section. The second is a swcluster -i -b session on the NFSD server with the 700 bundle. The swcluster session installs the 700 bundle to the alternate root. Details describing swcluster appear in the "Homogeneous NFSD cluster" section below. The only difference is that in the heterogeneous case, swcluster does not reboot the 800 server after the software is installed to the alternate root. The steps are: /usr/sbin/swinstall... # on the NFSD server using the 800 patch bundle. /usr/sbin/swcluster -i -b... # on the NSFD server using the 700 patch bundle for NFSD clients. The details of how to use swinstall are covered in "Standalone Systems" in this chapter. Details about swcluster appear in the next paragraph, as swcluster is similar in operation for both homogeneous and heterogeneous NFSD clusters. Homogeneous NFSD Cluster ------------------------ To install the patch bundle on a homogeneous NFSD cluster you need only one SD session. Type: /usr/sbin/swcluster -i -b This command results in multiple swinstall operations: 1. swinstall is first invoked in preview mode where analysis is performed to determine which patches to load to the shared root (/export/shared_roots/OS_700). This is where the MWTH or Pick and Choose method is executed. When the preview mode completes, swcluster halts all the clients. 2. Next swinstall is reinvoked to perform the real installation. When swinstall completes successfully, swcluster reboots the server. 3. When the server comes back up, swcluster is reinvoked to launch a third swinstall to complete the link installs. The link installs make the software installed on the shared root available to the NFSD clients' private roots. Instructions to Install on a 10.X System ---------------------------------------- 1. Put the "HP-UX Extension Software" CD-ROM into the CD-ROM drive. 2. Log into the system as root. 3. Make sure all users are off the system. 4. Make sure the CD-ROM drive is mounted: /usr/sbin/mount If there is no entry for the CD-ROM drive, mount it: /usr/sbin/mount /dev/dsk/devicefile your_mount_directory For example: /usr/sbin/mount /dev/dsk/c0t2d0 /cdrom If you have just attached the drive to your system, you can use SAM the menu-driven System Adminstration Manager, to create device files for it; go to the Device List menu under Peripheral Devices, click on the entry for the CD-ROM drive, pull down the Actions menu and choose Show Device Files. SAM builds device files if they are not already there. (On a small system, get out of SAM before running SD, or you may run out of memory.) 5. Run SD in interactive mode (type: /usr/sbin/swinstall) or non-interactive mode (as previously described in the "Standalone Installation" section) or 1) If this system is a heterogeneous NFS Diskless (NFSD) cluster server (a Series 800 server with Series 700 clients): * on the NFSD server to install the Series 800 patch bundle, type: swinstall * on the NFSD server to install the Series 700 patch bundle, type: /usr/sbin/swcluster -i -b 2) If this system is a homogeneous NFS Diskless cluster server (a Series 700 server), type: /usr/sbin/swcluster -i -b The -b option forces the clients to shut down during the actual installation. 6. Change the Source Depot Path. Select the Source Depot Path. Change the path to absolute_path_of_patch_bundle_depot For example: /cdrom/10.X/700/10.20/XSWHW7001020 is the depot for a Series 700 running 10.20. 7. Pull down the Actions menu and choose Match What Target Has. swinstall will load patches only for products already installed on your system. You can see what has been selected for you by double-clicking on the name of the patch bundle showing in the Software Selection window. 8. Pull down the Actions menu again and choose Install (analysis). You can follow swinstall's actions by clicking on Logfile. 9. If there are no errors, confirm that you want to go ahead with the installation. ************************** NOTE ***************************************** ERRORs during installation should be examined. ************************************************************************* List of Errors that Should Be Disregarded ----------------------------------------- The May, 1997 Extension Software contained patch PHNE_9081 in the XSW700GR1020 and the XSW800GR1020 bundles. However, patch PHNE_9081 was recalled after the May Extension Software was released. There is no new replacement patch for PHNE_9081 yet, therefore, PHNE_8164 has been included in this version of Extension Softwareinstead. (PHNE_9081 supersedes PHNE_8164). If you have installed the the above named bundles on your system, you will encounter an error while installing this version of Extension Software. You will need to remove PHNE_9081 first and then you are able to install PHNE_8164. The error message has been included here for your reference: ERROR: the patch PHNE_8164 has been superseded by the following patch : PHNE_9081 >>>> This patch MUST NOT be installed. <<<< ERROR: The "checkinstall" script for "PHNE_8164" failed (exit code "1"). The script location was "/var/tmp/AAAa01590/catalog/PHNE_8164/pfiles/checkinstall". * This script had errors and the execution of this product cannot proceed until the problem is fixed. Check the above output from the script for further details. ****************************************************************** 3. Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this document, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material. A copy of the specific warranty terms applicable to your Hewlett-Packard product and replacement parts can be obtained from your local Sales and Service Office. (C)Copyright 1996, 1997 Hewlett-Packard Company (C)Copyright 1980, 1984 AT&&T, Inc. (C)Copyright 1979, 1980, 1983 The Regents of the University of California This document contains information which is protected by copyright. All rights are reserved. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. ***********************************************************************