**************************************************************************
*                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. 

***********************************************************************