4    Sample Patch Kit Installation

This chapter provides samples of using dupatch to do the following:

4.1    Sample 1: Typical Patch Kit Installation

The example in this section shows a typical patch kit installation.

# dupatch
 
Mon Nov 16 11:25:02 EST 1998
DUPATCH_REV>25
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Main Menu:
    ---------------
 
    1)  Patch Installation
    2)  Patch Deletion
 
    3)  Patch Documentation
    4)  Patch Tracking
 
    5)  Patch Baseline Analysis/Adjustment
 
    h)  Help on Command Line Interface
 
    q)  Quit
 
Enter your choice: 1
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Installation Menu:
    -----------------------------
 
    1)  Pre-Installation Check ONLY
    2)  Check & Install (requires single-user mode)
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: 2
 
Enter path to the top of the patch distribution, 
or enter "q" to get back to the menu : /mnt/patch_kit
 
The products listed below are optional:
 
     There may be more optional products than can be presented on a single
     screen. If this is the case, you can choose products screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any products are installed.
 
     1) Patches for Digital UNIX V4.0D                                          
     2) Patches for TruCluster Available Server Software V1.5                   
 
Or you may choose one of the following options:
 
     3) ALL of the above 
     4) CANCEL selections and redisplay menus
     5) EXIT without installing any products 
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6): 3
 
You are installing patches (to be selected) from the following products:
 
        Patches for Digital UNIX V4.0D                                          
        Patches for TruCluster Available Server Software V1.5                   
 
Is this correct? (y/n): y
 
Gathering patch information...
  (depending upon the size of the patch kit, this may take a while)
 
                ***  Start of Special Instructions  ***
 
                ***  There are NO Special Instructions  ***
 
Press RETURN to proceed...
 
     ------------------------------------------------------------------------
 
     To Make Patches Reversible - PLEASE READ THE FOLLOWING INFORMATION:
 
   - You have the option to make the patches reversible so you can 
     revert the system to its state prior to the installation of a patch.  
 
   - Reversibility is achieved by compressing and saving a copy of the 
     files being replaced by the patches. These files would be restored 
     to the system if you choose to delete a patch.
 
   - If you choose to make patches NON-reversible, then the system cannot 
     be restored to the state prior to the installation of a patch; you 
     will not be able to delete the patches later.
 
   - This patch kit may force a small set of patches to be reversible to 
     ensure your upgrades to future versions of DIGITAL UNIX are successful. 
     The Patch Utility will make those patches reversible automatically. 
 
     Refer to the Release Notes / Installation Instructions provided with
     this patch kit.
 
Do you want the patches to be reversible? [y]: y
 
     By default, the backup copies of the installed patches will be saved in
     "//var/adm/patch/backup".
 
     If you have limited space in /var, you may want to make the backup
     directory the mount point for a separate disk partition, an NFS mounted
     directory, or a symbolic link to another file system.
 
     You must ensure the backup directory is configured the same way during
     any patch removal operations.
 
Your current setup of "//var/adm/patch/backup" is:
 
* A plain directory (not a mount point or a symbolic link)
 
Do you want to proceed with the installation with this setup? [y]: [Return]
 
Your name: Mary Smith
 
Enter any notes about this operation that you would like stored for
future reference (To end your input, enter a "."):
 
: sample installation of all patches...
: .
 
KITNAME> OSF425, TCR150
 
The patches listed below are optional:
 
     There may be more optional patches than can be presented on a single
     screen. If this is the case, you can choose patches screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any patches are installed.
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
     1) Patch 0203.00 - adduser Command Correction                              
     2) Patch 0219.00 - find Command Correction                                 
     3) Patch 0249.00 - dump/restore Incompatability Correction                 
     4) Patch 0276.00 - crontab Command Correction                              
     5) Patch 0287.00 - tar Command Correction                                  
     6) Patch 0364.00 - sendmail Command Correction                             
     7) Patch 0394.00 - acctcom and acctcms Corrections.                        
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells & Utility Patches:
     8) Patch 0365.01 - setacl Command Correction                               
 
--- MORE TO FOLLOW ---
Enter your choices or press RETURN to display the next screen.
 
Choices (for example, 1 2 4-6): 
 
     9) Patch 0372.00 - Bourne Shell Performance Improvement                    
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells, & Utility Patches:
    10) Patch 0017.01 - awk Utility Correction                                  
    11) Patch 0032.01 - diskx Command Correction                                
    12) Patch 0038.01 - vipw Issues Warnings Enhancement                        
    13) Patch 0064.01 - who Command Correction                                  
    14) Patch 0066.01 - lex Command Correction                                  
    15) Patch 0073.01 - LSM volsave Command Correction                          
 
 - TruCluster_V1.5 / ASE API Library Patches:
    16) Patch 0004.00 - Networker Core Dump Correction                          
 
 - TruCluster_V1.5 / ASE Availability Manager (AM) Patches:
    17) Patch 0032.00 - Kern Mem Fault And simple_lock Panic Correction         
 
 - TruCluster_V1.5 / Cluster Patches:
    18) Patch 0005.00 - System Panic dlm getch: illegal csid Correction         
    19) Patch 0006.00 - drdadmin Command Failure, SysStartUp Error Corr(s)      
    20) Patch 0011.00 - Cluster Map Not Being Loaded At Boot Time Correction    
    21) Patch 0013.00 - Cluster Monitor Hang Correction                         
    22) Patch 0026.00 - Booting Second Member To Cluster Correction             
 
Enter your choices or press RETURN to display the next screen.
Choices (for example, 1 2 4-6):
 
Or you may choose one of the following options:
 
    23) ALL of the above 
    24) CANCEL selections and redisplay menus
    25) EXIT without installing any patches 
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6):  23
 
The patches listed below are optional:
 
     There may be more optional patches than can be presented on a single
     screen. If this is the case, you can choose patches screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any patches are installed.
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
     1) Patch 0203.00 - adduser Command Correction                              
     2) Patch 0219.00 - find Command Correction                                 
     3) Patch 0249.00 - dump/restore Incompatability Correction                 
     4) Patch 0276.00 - crontab Command Correction                              
     5) Patch 0287.00 - tar Command Correction                                  
     6) Patch 0364.00 - sendmail Command Correction                             
     7) Patch 0394.00 - acctcom and acctcms Corrections.                        
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells & Utility Patches:
     8) Patch 0365.01 - setacl Command Correction                               
 
--- MORE TO FOLLOW ---
Enter your choices or press RETURN to display the next screen.
 
Choices (for example, 1 2 4-6): 
 
     9) Patch 0372.00 - Bourne Shell Performance Improvement                    
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells, & Utility Patches:
    10) Patch 0017.01 - awk Utility Correction                                  
    11) Patch 0032.01 - diskx Command Correction                                
    12) Patch 0038.01 - vipw Issues Warnings Enhancement                        
    13) Patch 0064.01 - who Command Correction                                  
    14) Patch 0066.01 - lex Command Correction                                  
    15) Patch 0073.01 - LSM volsave Command Correction                          
 
 - TruCluster_V1.5 / ASE API Library Patches:
    16) Patch 0004.00 - Networker Core Dump Correction                          
 
 - TruCluster_V1.5 / ASE Availability Manager (AM) Patches:
    17) Patch 0032.00 - Kern Mem Fault And simple_lock Panic Correction         
 
 - TruCluster_V1.5 / Cluster Patches:
    18) Patch 0005.00 - System Panic dlm getch: illegal csid Correction         
    19) Patch 0006.00 - drdadmin Command Failure, SysStartUp Error Corr(s)      
    20) Patch 0011.00 - Cluster Map Not Being Loaded At Boot Time Correction    
    21) Patch 0013.00 - Cluster Monitor Hang Correction                         
    22) Patch 0026.00 - Booting Second Member To Cluster Correction             
 
Is this correct? (y/n): y
 
Checking patch prerequisites and patch file applicability...
  (depending upon the number of patches you select, this may take a while)
 
************************** CAUTION ************************************ 
 
Interruption of this phase of the operation will corrupt your 
operating system software and compromise the patch database 
integrity. 
 
DO NOT Ctrl/C, power off your system, or in any other way 
interrupt the patch operation. The patch operation is complete 
when you are returned to the Patch Utility menus.
 
***********************************************************************
 
=== Installing "Digital UNIX V4.0D": 
 
Checking file system space required to install specified subsets:
 
File system space checked OK.
 
15 subset(s) will be installed.
 
Loading 1 of 15 subset(s)....
 
Patch: crontab Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 2 of 15 subset(s)....
 
Patch: LSM volsave Command Correction
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 3 of 15 subset(s)....
 
Patch: acctcom and acctcms Corrections.
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 4 of 15 subset(s)....
 
Patch: sendmail Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 5 of 15 subset(s)....
 
Patch: setacl Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 6 of 15 subset(s)....
 
Patch: tar Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 7 of 15 subset(s)....
 
Patch: adduser Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 8 of 15 subset(s)....
 
Patch: lex Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 9 of 15 subset(s)....
 
Patch: who Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 10 of 15 subset(s)....
 
Patch: vipw Issues Warnings Enhancement
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 11 of 15 subset(s)....
 
Patch: find Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 12 of 15 subset(s)....
 
Patch: awk Utility Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 13 of 15 subset(s)....
 
Patch: Bourne Shell Performance Improvement
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 14 of 15 subset(s)....
 
Patch: diskx Command Correction 
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
Loading 15 of 15 subset(s)....
 
Patch: dump/restore Incompatability Correction
   Copying from /var/bl11/patch_kit/DIGITAL_UNIX_V4.0D/kit (disk)
   Verifying
 
15 of 15 subset(s) installed successfully.
 
*Configuring "Patch: crontab Command Correction " (OSFPAT00027600425)
 
*Configuring "Patch: LSM volsave Command Correction" (OSFPAT00007301425)
 
*Configuring "Patch: acctcom and acctcms Corrections." (OSFPAT00039400425)
 
*Configuring "Patch: sendmail Command Correction " (OSFPAT00036400425)
 
*Configuring "Patch: setacl Command Correction " (OSFPAT00036501425)
 
*Configuring "Patch: tar Command Correction " (OSFPAT00028700425)
 
*Configuring "Patch: adduser Command Correction " (OSFPAT00020300425)
 
*Configuring "Patch: lex Command Correction " (OSFPAT00006601425)
 
*Configuring "Patch: who Command Correction " (OSFPAT00006401425)
 
*Configuring "Patch: vipw Issues Warnings Enhancement" (OSFPAT00003801425)
 
*Configuring "Patch: find Command Correction " (OSFPAT00021900425)
 
*Configuring "Patch: awk Utility Correction " (OSFPAT00001701425)
 
*Configuring "Patch: Bourne Shell Performance Improvement" (OSFPAT00037200425)
 
*Configuring "Patch: diskx Command Correction " (OSFPAT00003201425)
 
*Configuring "Patch: dump/restore Incompatability Correction" (OSFPAT00024900425)
 
=== Installing "TruCluster Available Server Software V1.5": 
 
Checking file system space required to install specified subsets:
 
File system space checked OK.
 
7 subset(s) will be installed.
 
Loading 1 of 7 subset(s)....
 
Patch: Kern Mem Fault And simple_lock Panic Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 2 of 7 subset(s)....
 
Patch: Cluster Monitor Hang Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 3 of 7 subset(s)....
 
Patch: Networker Core Dump Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 4 of 7 subset(s)....
 
Patch: System Panic dlm getch: illegal csid Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 5 of 7 subset(s)....
 
Patch: drdadmin Command Failure, SysStartUp Error Corr(s)
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 6 of 7 subset(s)....
 
Patch: Booting Second Member To Cluster Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
Loading 7 of 7 subset(s)....
 
Patch: Cluster Map Not Being Loaded At Boot Time Correction
   Copying from /var/bl11/patch_kit/TruCluster_V1.5/kit (disk)
   Verifying
 
7 of 7 subset(s) installed successfully.
 
*Configuring "Patch: Kern Mem Fault And simple_lock Panic Correction" (TCRPAT00003200150)
 
*Configuring "Patch: Cluster Monitor Hang Correction" (TCRPAT00001300150)
 
*Configuring "Patch: Networker Core Dump Correction" (TCRPAT00000400150)
 
*Configuring "Patch: System Panic dlm getch: illegal csid Correction" (TCRPAT00000500150)
 
*Configuring "Patch: drdadmin Command Failure, SysStartUp Error Corr(s)" (TCRPAT00000600150)
 
*Configuring "Patch: Booting Second Member To Cluster Correction" (TCRPAT00002600150)
 
*Configuring "Patch: Cluster Map Not Being Loaded At Boot Time Correction" (TCRPAT00001100150)
 
=========================================================================
 
 - TruCluster_V1.5 / ASE Availability Manager (AM) Patches:
        Patch 0032.00 - Kern Mem Fault And simple_lock Panic Correction         
 
SPECIAL INSTRUCTIONS FOR TruClusters 1.5 Patch 3.00
WARNING! Possible System Setup Change Required, KZPSA Firmware
 
    If the system contains KZPSA I/O adapters, please ensure A11 or greater
    firmware is installed between the shutdown and reboot.
 
Press RETURN to proceed...
 
   * A kernel rebuild is required for the successfully installed patch(es).
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Installation Menu:
    ------------------------------
 
    1)  Pre-Installation Check ONLY
    2)  Check & Install (requires single-user mode)
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: q
 

4.2    Sample 2: Viewing the Patch Documentation

The example in this section shows how to use dupatch to view the documentation included in the patch kits.

# dupatch
 
Mon Nov 16 12:05:00 EST 1998
DUPATCH_REV>25
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Main Menu:
    ---------------
 
    1)  Patch Installation
    2)  Patch Deletion
 
    3)  Patch Documentation
    4)  Patch Tracking
 
    5)  Patch Baseline Analysis/Adjustment
 
    h)  Help on Command Line Interface
 
    q)  Quit
 
Enter your choice: 3
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Documentation Menu:
    -----------------------------------
 
    1)  View abstracts of installed patches on your system
    2)  View abstracts of patches on the patch kit
 
    3)  View READMEs of installed patches on your system
    4)  View READMEs of patches on the patch kit
 
    5)  View special instructions for installed patches on your system
    6)  View special instructions for patches on the patch kit
 
    7)  View all patch abstracts on your system
    8)  View all patch READMEs on your system
    9)  View all patch special instructions on your system
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: 2
 
Enter path to the top of the patch distribution, 
or enter "q" to get back to the menu : /mnt/patch_kit
 
     There may be more products than can be presented on a single
     screen. If this is the case, you can choose products screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any products are examined.
 
     1) Patches for Digital UNIX V4.0D                                          
     2) Patches for TruCluster Available Server Software V1.5                   
 
Or you may choose one of the following options:
 
     3) ALL of the above 
     4) CANCEL selections and redisplay menus
     5) EXIT without examining any products 
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6): 3
 
You are examining patches (to be selected) from the following products:
 
        Patches for Digital UNIX V4.0D                                          
        Patches for TruCluster Available Server Software V1.5                   
 
Is this correct? (y/n): y
 
     There may be more patches than can be presented on a single
     screen. If this is the case, you can choose patches screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any patches are examined.
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
     1) Patch 0203.00 - adduser Command Correction                              
     2) Patch 0219.00 - find Command Correction                                 
     3) Patch 0249.00 - dump/restore Incompatability Correction                 
     4) Patch 0276.00 - crontab Command Correction                              
     5) Patch 0287.00 - tar Command Correction                                  
     6) Patch 0364.00 - sendmail Command Correction                             
     7) Patch 0394.00 - acctcom and acctcms Corrections.                        
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells & Utility Patches:
     8) Patch 0365.01 - setacl Command Correction                               
     9) Patch 0372.00 - Bourne Shell Performance Improvement                    
 
--- MORE TO FOLLOW ---
Enter your choices or press RETURN to display the next screen.
 
Choices (for example, 1 2 4-6): 
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells, & Utility Patches:
    10) Patch 0017.01 - awk Utility Correction                                  
    11) Patch 0032.01 - diskx Command Correction                                
    12) Patch 0038.01 - vipw Issues Warnings Enhancement                        
    13) Patch 0064.01 - who Command Correction                                  
    14) Patch 0066.01 - lex Command Correction                                  
    15) Patch 0073.01 - LSM volsave Command Correction                          
 
 - TruCluster_V1.5 / ASE API Library Patches:
    16) Patch 0004.00 - Networker Core Dump Correction                          
 
 - TruCluster_V1.5 / ASE Availability Manager (AM) Patches:
    17) Patch 0032.00 - Kern Mem Fault And simple_lock Panic Correction         
 
 - TruCluster_V1.5 / Cluster Patches:
    18) Patch 0005.00 - System Panic dlm getch: illegal csid Correction         
    19) Patch 0006.00 - drdadmin Command Failure, SysStartUp Error Corr(s)      
    20) Patch 0011.00 - Cluster Map Not Being Loaded At Boot Time Correction    
    21) Patch 0013.00 - Cluster Monitor Hang Correction                         
    22) Patch 0026.00 - Booting Second Member To Cluster Correction             
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6): 
 
Or you may choose one of the following options:
 
    23) ALL of the above 
    24) CANCEL selections and redisplay menus
    25) EXIT without examining any patches 
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6): 1-5
 
You are examining the following patches:
 
DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
     1) Patch 0203.00 - adduser Command Correction
     2) Patch 0219.00 - find Command Correction
     3) Patch 0249.00 - dump/restore Incompatability Correction
     4) Patch 0276.00 - crontab Command Correction
     5) Patch 0287.00 - tar Command Correction
 
=========================================================================
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0203.00 - adduser Command Correction
 
This patch fixes a problem in which the adduser(8) command puts user
directories in /usr instead of /usr/users.
 
=========================================================================
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0219.00 - find Command Correction
 
This patch fixes the "find" command in which files in directories which were
mounted with the "-fstype nfsv2" argument were not found.
 
=========================================================================
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0249.00 - dump/restore Incompatability Correction
 
Backups made by the dump program on pre-v4.0d systems were not being correctly
restored by the v4.0d restore program. Specifically, ownership was being set to
root:system in all cases.
 
=========================================================================
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0276.00 - crontab Command Correction
 
This patch prevents the crontab file from incorrectly deleting files found in
file systems mounted under the /var/preserve, /tmp, and /var/tmp directories.
 
=========================================================================
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0287.00 - tar Command Correction
 
This patch fixes an intermittent problem with the tar(1) command in which tar
prematurely terminates. The problem can occur on systems configured with both a
Qlogic/ISP controller and a tape deck connected to a KZPAA controller.
 
Press RETURN to proceed...
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
        - This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Documentation Menu:
    ----------------------------------
 
    1)  View abstracts of installed patches on your system
    2)  View abstracts of patches on the patch kit
 
    3)  View READMEs of installed patches on your system
    4)  View READMEs of patches on the patch kit
 
    5)  View special instructions for installed patches on your system
    6)  View special instructions for patches on the patch kit
 
    7)  View all patch abstracts on your system
    8)  View all patch READMEs on your system
    9)  View all patch special instructions on your system
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: q
 

4.3    Sample 3: Tracking Patches

The example in this section shows how to use dupatch to track patches.

# dupatch
 
Mon Nov 16 12:15:09 EST 1998
DUPATCH_REV>25
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Main Menu:
    ---------------
 
    1)  Patch Installation
    2)  Patch Deletion
 
    3)  Patch Documentation
    4)  Patch Tracking
 
    5)  Patch Baseline Analysis/Adjustment
 
    h)  Help on Command Line Interface
 
    q)  Quit
 
Enter your choice: 4
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Tracking Menu:
    -------------------
 
    1)  List installed patches
    2)  List installed patch files
    3)  List patch kit information on installed patches
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: 1
 
Patches installed on the system:
--------------------------------------
  (depending upon the number of patches you installed, this may take a while)
 
 - DIGITAL_UNIX_V4.0D / Command, Shells, & Utility Patches:
        Patch 0203.00 - adduser Command Correction                              
        Patch 0219.00 - find Command Correction                                 
        Patch 0249.00 - dump/restore Incompatability Correction                 
        Patch 0276.00 - crontab Command Correction                              
        Patch 0287.00 - tar Command Correction                                  
        Patch 0364.00 - sendmail Command Correction                             
        Patch 0394.00 - acctcom and acctcms Corrections.                        
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells & Utility Patches:
        Patch 0365.01 - setacl Command Correction                               
        Patch 0372.00 - Bourne Shell Performance Improvement                    
 
 - DIGITAL_UNIX_V4.0D / Commands, Shells, & Utility Patches:
        Patch 0017.01 - awk Utility Correction                                  
        Patch 0032.01 - diskx Command Correction                                
        Patch 0038.01 - vipw Issues Warnings Enhancement                        
        Patch 0064.01 - who Command Correction                                  
        Patch 0066.01 - lex Command Correction                                  
        Patch 0073.01 - LSM volsave Command Correction                          
 
 - TruCluster_V1.5 / ASE API Library Patches:
        Patch 0004.00 - Networker Core Dump Correction                          
 
 - TruCluster_V1.5 / ASE Availability Manager (AM) Patches:
        Patch 0032.00 - Kern Mem Fault And simple_lock Panic Correction         
 
 - TruCluster_V1.5 / Cluster Patches:
        Patch 0005.00 - System Panic dlm getch: illegal csid Correction         
        Patch 0006.00 - drdadmin Command Failure, SysStartUp Error Corr(s)      
        Patch 0011.00 - Cluster Map Not Being Loaded At Boot Time Correction    
        Patch 0013.00 - Cluster Monitor Hang Correction                         
        Patch 0026.00 - Booting Second Member To Cluster Correction             
 
Press RETURN to get back to the Patch Tracking Menu...
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Tracking Menu:
    ---------------------------
 
    1)  List installed patches
    2)  List installed patch files
    3)  List patch kit information on installed patches
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: 2
 
The list of all patched files on your system:
--------------------------------------------
  (depending upon the number of patches you installed, this may take a while)
 
./opt/TCR150/sbin/init.d/aseam (TruCluster_V1.5 Patch 0011.00)
./sbin/Rsh (DIGITAL_UNIX_V4.0D Patch 0372.00)
./sbin/advfs/advscan (DIGITAL_UNIX_V4.0D Patch 0352.00)
./sbin/advfs/vdf (DIGITAL_UNIX_V4.0D Patch 0314.00)
./sbin/advfs/verify (DIGITAL_UNIX_V4.0D Patch 0392.00)
./sbin/bcheckrc (DIGITAL_UNIX_V4.0D Patch 0016.01)
./sbin/chfsets (DIGITAL_UNIX_V4.0D Patch 0392.00)
./sbin/chvol (DIGITAL_UNIX_V4.0D Patch 0392.00)
./sbin/cpio (DIGITAL_UNIX_V4.0D Patch 0316.00)
./sys/BINARY/advfs.mod (DIGITAL_UNIX_V4.0D Patch 0392.00)
./sys/BINARY/alphabook.mod (DIGITAL_UNIX_V4.0D Patch 0321.00)
./sys/BINARY/alphabook_mult.mod (DIGITAL_UNIX_V4.0D Patch 0321.00)
./sys/BINARY/arch_alpha.mod (DIGITAL_UNIX_V4.0D Patch 0345.01)
./sys/BINARY/arch_alphapmap.mod (DIGITAL_UNIX_V4.0D Patch 0345.01)
./sys/BINARY/atm.mod (DIGITAL_UNIX_V4.0D Patch 0117.01)
./usr/opt/TCR150/ccs/lib/libimc.a (TruCluster_V1.5 Patch 0017.00)
./usr/opt/TCR150/ccs/lib/libssn.a (TruCluster_V1.5 Patch 0023.00)
./usr/opt/TCR150/sbin/aseagent (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/asedirector (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/asehelp (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/asehsm (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/aselogger (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/asemgr (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/asesetup (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/cnxmgrd (TruCluster_V1.5 Patch 0005.00)
./usr/opt/TCR150/sbin/drdadmin (TruCluster_V1.5 Patch 0006.00)
./usr/opt/TCR150/sbin/postDevErr (TruCluster_V1.5 Patch 0033.00)
./usr/opt/TCR150/sbin/snd (TruCluster_V1.5 Patch 0022.01)
./usr/opt/TCR150/sbin/submon (TruCluster_V1.5 Patch 0033.00)
./usr/opt/TCR150/shlib/libaseapi.so (TruCluster_V1.5 Patch 0004.00)
./usr/opt/TCR150/shlib/libimc.so (TruCluster_V1.5 Patch 0017.00)
./usr/opt/TCR150/sys/ase.mod (TruCluster_V1.5 Patch 0032.00)
./usr/opt/TCR150/sys/cludebug.mod (TruCluster_V1.5 Patch 0026.00)
./usr/opt/TCR150/sys/cnxagent.mod (TruCluster_V1.5 Patch 0005.00)
./usr/opt/TCR150/sys/dlm.mod (TruCluster_V1.5 Patch 0023.00)
./usr/opt/TCR150/sys/include/sys/dlm_ssn.h (TruCluster_V1.5 Patch 0023.00)
./usr/opt/TCR150/sys/include/sys/imc.h (TruCluster_V1.5 Patch 0017.00)
./usr/opt/TCR150/sys/mcs.mod (TruCluster_V1.5 Patch 0017.00)
./usr/opt/TCR150/sys/rm.mod (TruCluster_V1.5 Patch 0026.00)
./usr/opt/TCR150/sys/rmvm.mod (TruCluster_V1.5 Patch 0026.00)
./usr/sbin/acct/acctcms (DIGITAL_UNIX_V4.0D Patch 0394.00)
./usr/sbin/adduser (DIGITAL_UNIX_V4.0D Patch 0203.00)
./usr/sbin/atmsetup (DIGITAL_UNIX_V4.0D Patch 0117.01)
./usr/sbin/automount (DIGITAL_UNIX_V4.0D Patch 0358.00)
./usr/sbin/chfile (DIGITAL_UNIX_V4.0D Patch 0392.00)
./usr/sbin/cron (DIGITAL_UNIX_V4.0D Patch 0349.00)
./usr/sbin/defragment (DIGITAL_UNIX_V4.0D Patch 0392.00)
./usr/sbin/dump (DIGITAL_UNIX_V4.0D Patch 0362.01)
./usr/sbin/edquota (DIGITAL_UNIX_V4.0D Patch 0362.01)
 
Press RETURN to get back to the Patch Tracking Menu...
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Patch Tracking Menu:
    ---------------------------
 
    1)  List installed patches
    2)  List installed patch files
    3)  List patch kit information on installed patches
 
    b)  Back to Main Menu
    q)  Quit
 
Enter your choice: q
 

4.4    Sample 4: Gathering Baseline Information

The example in this section shows how to use dupatch to perform a patch baseline analysis.

# dupatch
Tue Nov 17 14:08:48 EST 1998
DUPATCH_REV>25
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
============================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Main Menu:
    ---------------
 
    1)  Patch Installation
    2)  Patch Deletion
 
    3)  Patch Documentation
    4)  Patch Tracking
 
    5)  Patch Baseline Analysis/Adjustment
 
    h)  Help on Command Line Interface
 
    q)  Quit
 
Enter your choice: 5
 
Patch Baseline Analysis and Adjustment
======================================
 
This section of the patch management utility does not actually install
patches. It is an enabler and need only be used to baseline your
system for routine use of setld-based patch kits. It is recommended that
you read the release notes accompanying this kit, prior to continuing.
 
It is specifically designed to provide continuity from an environment with
manually installed operating system patches to one that can be managed
using the standard 'setld' installation technology.
 
This baselining is broken into phases that assess and report the state of
your operating system files. It will only make changes to your system with
your confirmation.
 
    Phase 1 - System Evaluation
 
        Where possible, this phase determines the origin of changed operating
system files and detects formally released official patches that were
manually installed.
 
    Phase 2 - Report patches with inter-product inventory conflicts
 
Some layered products ship operating system files or files delivered
by other layered products.  If you have any of these layered products
installed on your system and the patch kit happens to contain those
files with inventory conflicts, the Patch Utility will block the 
installation of the patches containing inventory conflicts since it 
may corrupt the layered product operation.
 
    Phase 3 - Create installation records for manually-installed patches
 
During this phase, you will be shown a list of patches that match
the files on your system, but are not marked as 'installed'.  You will 
be offered an opportunity to mark these patches as 'installed'.  This 
involves copying valid 'setld' database information to your system.
 
    Phase 4 - Report changed system files
 
        This phase provides information to help you make choices later in 
this process.  It reports both 'missing' and files whose origin
cannot be determined.  Some of these files may affect patch 
installation.  You will want to consider this information when you 
later make decisions in phase 5.
 
    Phase 5 - Enable patches with file applicability conflicts
 
This phase allows you to enable subsequent installation of patches 
whose inventory does not match the installed system.  This occurs 
when: 
 
1) System files changed and the origin of that 
   change cannot be determined, or 
2) The changed files can only be traced back to 
   previous manual patches, or
3) The original file to be patched is missing 
   from the system, or
4) Hard links to files about to be patched are broken
 
        It is recommended that you do not enable the installation of these 
        patches, if any, until you have tracked down the origin of the 
files that are in conflict, or you may compromise the integrity of 
your operating system.   
 
        To assist you in this effort, the file list for the entire patch 
        with the known information will be displayed. You may run through 
this phase to get the analysis without enabling the installation 
of any of the listed patches.
 
        It is recommended that you backup your operating system prior to 
the actual patch installation.
 
Do you want to proceed with the analysis and adjustment? [y/n]: y
 
    - This Patch Baseline Analysis/Adjustment session is logged in:
    //var/adm/patch/log/baseline.log
 
    - Previous baseline logs saved in baseline.log.[1-25]
 
Enter path to the top of the patch distribution, 
or enter "q" to get back to the menu : /usr/pkit/patch_kit
 
KITNAME> TCR141, OSF410
 
Phase 1 - System Evaluation
===========================
 
    This evaluation compares the contents of your patch kit to the
    state of files already installed on your system regardless of their
    origin.
 
    The amount of time needed to complete this phase can vary greatly
    depending on the size of the patch kit, the version of the Operating
    System, and the performance of the system.
 
    * system evaluation completed.
      --------------------------- 
 
    Press RETURN to proceed to the next phase...
 
Phase 2 - Report patches with inter-product inventory conflicts 
===============================================================
 
    Some layered products replace files delivered in the original Operating 
    System inventory or other layered products' inventory.  The Patch Utility 
    will block installation of those patches with inventory conflicts since 
    they could compromise the integrity of the layered products.
 
    Press RETURN to see the list of patches...
    * list of patches with inter-product inventory conflicts: 
      ------------------------------------------------------
 
 - DIGITAL_UNIX_V4.0B / Common Desktop Environment (CDE) Patches:
        Patch 0691.00 - CDE Window Manager Corrections                          
 
  - Files with inter-product inventory conflicts are:
 
      ./usr/dt/bin/dtwm is shipped by:
 
    Product: BLT Layered Product Test  
    Subset:  BLTLPCONFLICTTEST410
 
 
  - There are no other files within this patch.
 
 
Phase 3 - Create installation records for manually installed patches
====================================================================
 
    You can choose to copy valid installation records to your system for
    the following patches, if any.  This will allow future management and
    reporting for patches to your operating system.
 
    Creating installation records is intended to establish a baseline to
    which future patches might be applied.  Future patch removal may
    only ever occur to this baseline. 
 
    * no manually installed patches detected.
      -------------------------------------- 
 
    Press RETURN to proceed to the next phase...
Phase 4 - Report changed system files and missing files
=======================================================
 
    This phase provides information to help you make choices later in 
    this process.  It reports both 'missing' and files whose origin
    cannot be determined.  Some of these files may affect patch 
    installation.  You will want to consider this information when you 
    later make decisions in phase 5.
 
    Press RETURN to see the list of changed system files...
    * list of changed files with unknown origin:
      ------------------------------------------
 
  ./etc/doprc                                  OSFSYSMAN410          UNKNOWN
  ./sbin/ln                                    OSFBASE410            UNKNOWN
  ./usr/bin/man                                OSFBASE410            UNKNOWN
      MISSING HARDLINK TO ./usr/bin/apropos
  ./usr/opt/TCR141/sys/config.file             TCRCONF141            UNKNOWN
  ./usr/opt/TCR141/sys/stanza.static           TCRCONF141            UNKNOWN
  ./usr/sbin/dupatch                           OSFPAT00000012410     UNKNOWN
  ./usr/sbin/envmond                           OSFENVMON410          UNKNOWN
  ./usr/sbin/talkd                             OSFCLINET410          UNKNOWN
      MISSING HARDLINK TO ./usr/sbin/ntalkd
  ./usr/shlib/X11/lib_dec_ws.so                OSFSER410             UNKNOWN
  ./usr/sys/include/dec/binlog/crdfilter.h     OSFPAT00057401410     UNKNOWN
 
       Press RETURN to see the list of "missing" files...
    * list of "missing" files:
      --------------------------
 
  ./sbin/init.d/envmon                 OSFENVMON410     MISSING
  ./usr/bin/apropos                    OSFBASE410       MISSING
  ./usr/bin/printenv                   OSFBASE410       MISSING
  ./usr/bin/whatis                     OSFBASE410       MISSING
  ./usr/opt/TCR141/sys/am.o            TCRCOMMON141     MISSING
  ./usr/sbin/ntalkd                    OSFCLINET410     MISSING
  ./usr/sbin/route                     OSFCLINET410     MISSING
  ./usr/shlib/X11/lib_dec_ati64.so     OSFSERPC410      MISSING
  ./usr/var/kdbx/mbuf                  OSFKTOOLS410     MISSING
  ./usr/var/kdbx/socket                OSFKTOOLS410     MISSING
 
    Press RETURN to proceed to the next phase...
Phase 5 - Enable patches with file applicability conflicts
==========================================================
 
    You will be shown a list of patches, if any, and their files. 
    Patches show up during this phase when: 
 
1) System files changed and the origin of that change cannot 
   be determined, or 
2) The changed files can only be traced back to previous 
   manual patches, or
3) The file to be patched is missing from the system, or
4) Hard links to files about to be patched are broken
 
    After reviewing this section, you can elect to enable the installation
    of these patches using a standard selection menu. Enabling a patch
    means that the checks for patch file applicability, done during patch 
    installation, will be bypassed if you later choose to install that 
    patch through the installation section of dupatch.
 
    It is recommended that you understand the origin of the listed files
    before enabling a patch for installation. 
 
    Press RETURN to see the list of patches...
    * list of patches with file applicability conflicts: 
      -------------------------------------------------
 
 
 - DIGITAL_UNIX_V4.0B / I/O Device Handling Patches:
        Patch 0063.00 - ATI Mach64 Graphics Card Monitor Handling               
 
  - Changed files with unknown origin are:
 
      ./usr/shlib/X11/lib_dec_ws.so
 
  - Missing system files are:
 
      ./usr/shlib/X11/lib_dec_ati64.so
 
  - Other file(s) within this patch, with their origin (identified
    through checksum match) listed in terms of their translated 
    subset information, if any, are:
 
      ./usr/shlib/X11/libextdpms.so
    X Servers Base
 
 
 - DIGITAL_UNIX_V4.0B / Security Related Patches:
        Patch 0117.00 - talkd Correction, Security (SSRT0446U)                  
 
  - Missing system files are:
 
      ./usr/sbin/ntalkd
 
  - There are no other files within this patch.
 
 
 - DIGITAL_UNIX_V4.0B / Commands, Shells, & Utility Patches:
        Patch 0118.00 - Environmental Monitoring Daemon Correction              
 
  - Changed files with unknown origin are:
 
      ./usr/sbin/envmond
 
  - Missing system files are:
 
      ./sbin/init.d/envmon
 
  - There are no other files within this patch.
 
 
 - DIGITAL_UNIX_V4.0B / Security Related Patches:
        Patch 0410.01 - Security, (SSRT0495U)                                   
 
  - Missing system files are:
 
      ./usr/bin/apropos
      ./usr/bin/whatis
 
  - Other file(s) within this patch, with their origin (identified
    through checksum match) listed in terms of their translated 
    subset information, if any, are:
 
      ./usr/lib/nls/msg/en_US.ISO8859-1/man.cat
    Base System
 
 
 - DIGITAL_UNIX_V4.0B / Commands, Shells, & Utility Patches:
        Patch 0574.01 - New Command, filterlog on AlphaServer 8200/8400         
 
  - Changed files with unknown origin are:
 
      ./usr/sys/include/dec/binlog/crdfilter.h
 
  - Other file(s) within this patch, with their origin (identified
    through checksum match) listed in terms of their translated 
    subset information, if any, are:
 
      ./etc/.new..binlog.conf
    Base System
 
      ./sys/BINARY/kn8ae.mod
    Hardware Kernel Modules
 
      ./usr/sbin/binlogd
    Base System
 
      ./usr/sbin/filterlog
    DIGITAL_UNIX_V4.0B Patch 0574.01
 
      ./usr/sys/include/dec/binlog/binlog.h
    Kernel Header and Common Files
 
      ./usr/sys/include/dec/binlog/crdfilter.h
    DIGITAL_UNIX_V4.0B Patch 0574.01
 
      ./usr/sys/include/io/dec/lsb/tlsbreg.h
    Kernel Header and Common Files
 
 
 - DIGITAL_UNIX_V4.0B / Miscellaneous Patches:
        Patch 0645.01 - kdbx mbuf And Socket Extension Correction               
 
  - Missing system files are:
 
      ./usr/var/kdbx/mbuf
      ./usr/var/kdbx/socket
 
  - There are no other files within this patch.
 
 
 - TruCluster_V1.4A / ASE Availability Manager (AM) Patches:
        Patch 0033.00 - Kern Mem Fault And simple_lock Panic Correction         
 
  - Missing system files are:
 
      ./usr/opt/TCR141/sys/am.o
 
  - Other file(s) within this patch, with their origin (identified
    through checksum match) listed in terms of their translated 
    subset information, if any, are:
 
      ./usr/opt/TCR141/sys/am_scsi.o
    TruCluster Common Components
 
      ./usr/opt/TCR141/sys/am_tmv1.o
    TruCluster Common Components
 
      ./usr/opt/TCR141/sys/am_tmv2.o
    TruCluster Common Components
 
Do you want to enable the installation of any of these patches? [y/n]: y
 
     There may be more patches than can be presented on a single
     screen. If this is the case, you can choose patches screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any patches are enabled.
 
 - DIGITAL_UNIX_V4.0B / Commands, Shells, & Utility Patches:
     1) Patch 0118.00 - Environmental Monitoring Daemon Correction              
     2) Patch 0574.01 - New Command, filterlog on AlphaServer 8200/8400         
 
 - DIGITAL_UNIX_V4.0B / I/O Device Handling Patches:
     3) Patch 0063.00 - ATI Mach64 Graphics Card Monitor Handling               
 
 - DIGITAL_UNIX_V4.0B / Miscellaneous Patches:
     4) Patch 0645.01 - kdbx mbuf And Socket Extension Correction               
 
 - DIGITAL_UNIX_V4.0B / Security Related Patches:
     5) Patch 0117.00 - talkd Correction, Security (SSRT0446U)                  
     6) Patch 0410.01 - Security, (SSRT0495U)                                   
 
Enter your choices or press RETURN to display the next screen.
 
Choices (for example, 1 2 4-6): 1 3
 
 
 - TruCluster_V1.4A / ASE Availability Manager (AM) Patches:
     7) Patch 0033.00 - Kern Mem Fault And simple_lock Panic Correction         
 
The following choices override your previous selections:
 
     8) ALL of the above 
     9) CANCEL selections and redisplay menus
    10) EXIT without enabling any patches 
 
Add to your choices, choose an overriding action or
press RETURN to confirm previous selections.
 
Choices (for example, 1 2 4-6): 1 3 
 
You are enabling the following patches:
 
 - DIGITAL_UNIX_V4.0B / Commands, Shells, & Utility Patches:
        Patch 0118.00 - Environmental Monitoring Daemon Correction              
 
 - DIGITAL_UNIX_V4.0B / I/O Device Handling Patches:
        Patch 0063.00 - ATI Mach64 Graphics Card Monitor Handling               
 
Is this correct? (y/n): y
 
*** Installation of the following patches is enabled:
    (NOTE: You need to include these patches for installation 
           from the installation menu)
 
 
 - DIGITAL_UNIX_V4.0B / Commands, Shells, & Utility Patches:
        Patch 0118.00 - Environmental Monitoring Daemon Correction              
 
 - DIGITAL_UNIX_V4.0B / I/O Device Handling Patches:
        Patch 0063.00 - ATI Mach64 Graphics Card Monitor Handling               
 
* Baseline Analysis/Adjustment process completed.
  ==============================================
 
Press RETURN to get back to the Main Menu...
 
DIGITAL UNIX Patch Utility (Rev. 25-10)
==========================
- This dupatch session is logged in //var/adm/patch/log/session.log
 
    Main Menu:
    ---------
 
    1)  Patch Installation
    2)  Patch Deletion
 
    3)  Patch Documentation
    4)  Patch Tracking
 
    5)  Patch Baseline Analysis/Adjustment
 
    h)  Help on Command Line Interface
 
    q)  Quit
 
Enter your choice: q