dupatch(8)dupatch(8)NAMEdupatch - Installs, deletes and maintains software patch updates to the
Tru64 UNIX operating system, the TruCluster software products, and (in
later kits) the Worldwide Language Support (WLS) subset.
SYNOPSIS
/usr/sbin/dupatch
/usr/sbin/dupatch -help [-data_file] [-kit kit_location] [-patch_id]
[-rev] [-product_id]
/usr/sbin/dupatch -install -kit kit_location -license-name user_name
-note user_note -patch all | patch_id [patch_id]... [-cfgfile con‐
fig_file] [-data data_file] [-noauto] [-nobackup] [-nolog] [-noroll]
[-precheck_only] [-proceed] [-root root_path] -product [all | prod‐
uct_id] [-single_user]
/usr/sbin/dupatch -delete-name user_name -note user_note -patch
all | patch_id [patch_id]... [-cfgfile config_file] [-data
data_file] [-noauto] [-nolog] [-noroll] [-proceed] [-root root_path]
[-product all | product_id] [-single_user]
/usr/sbin/dupatch -track -type [patch_level | file | kit | patch]
[-data data_file] [-kit kit_location] [-nolog] [-root root_path]
COMMAND KEYWORDS
Installs a software patch or patch kit. Removes an installed patch or
patches from the operating system. Patch deletion requires that the
patch was installed as a reversible patch. Constructs a history of
patch installations and deletions. Information can be patch-kit spe‐
cific or patch-file specific. Requests quick help on dupatch. Supply‐
ing an argument will provide help specifically on that argument.
OPTIONS
Required -install Options
Specifies the location of the patch kit from which patches will be
installed onto the system.
kit_location is a full path to the directory containing the
patch kit. Specifies that you have read and agreed to the
license required to install the patch kit. This option is
required for Version 5.1B-3 and higher. If you do not specifiy
this option when required, you will see the following message:
“Please read the license agreement (license.txt) in the top
level directory of the patch kit. To accept the license
agreement, include the -license option in the command line.”
You can also read the license in the Patch Summary and Release
Notes document that is included with your kit.
When you specify this option, the following message is dis‐
played:
“You have accepted the license agreement.” Specifies the name
to be recorded in event.log. Enclose the user_name in quotation
marks if it contains space characters. Records user-supplied
text in the event log. The user_note is a text string enclosed
in quotation marks. Required when more than one product is
installed.
Specifies the installed operating system and TruCluster software
when installing patches from an old style patch kit. Product ID
specifications are not case sensitive. Wildcards are not permit‐
ted.
When installing an inclusive patch kit, the use of all is manda‐
tory. See Specifying a Product ID with -product. Directs
dupatch to install all (all) patches or specific (patch_id)
patches from the specified patch kit.
When installing an inclusive patch kit, the use of all is manda‐
tory. See Specifying a Patch ID with -patch.
Optional -install Options
Specifies a configuration file for rebuilding the kernel. See Specify‐
ing a Configuration File. Specifies a file that contains arguments (in
the form argument = value) to the dupatch command. See Using a Data
File. Directs dupatch to not automatically rebuild the kernel if indi‐
cated by the patches installed. In addition, if running dupatch to
install the patches in single-user mode, the system will not automati‐
cally reboot after the patch process is complete. Directs dupatch to
not retain backup information during a patch installation. This will
remove the ability to back out an installed patch. Directs dupatch to
not record actions in a session.log file. Directs dupatch to install
patches on a cluster using the no-roll procedure rather than the
default rolling-upgrade procedure. Directs dupatch to perform the pre‐
installation check but to not proceed with the patch installation. If
-precheck_only is omitted, dupatch begins the installation process
after the preinstallation check has been completed, as long as no patch
failed the preinstallation check. The preinstallation check determines
whether new patches that depend on the presence of other patches or
software subsets can be installed. It does this by verifying that the
required patches or software subsets are already installed onto the
system. Directs dupatch to install any patches that passed the prein‐
stallation check, even if one or more patches failed the preinstalla‐
tion check. If -proceed is omitted, dupatch will not install any
patches if at least one patch fails the preinstallation check. The pre‐
installation check determines whether new patches that depend on the
presence of other patches or software subsets can be installed. It does
this by verifying that the required patches or software subsets are
already installed onto the system. Specifies an alternate root loca‐
tion. The default root_path is / for all operations. If the system is
presently in multiuser mode, brings the system down to single-user mode
prior to installing patches. Prints the current dupatch revision.
Required -delete Options
Specifies the name to be recorded in event.log. Enclose the user_name
in quotation marks if it contains space characters. Records user-sup‐
plied text in the event log. The user_note is a text string enclosed in
quotation marks. Mandatory when more than one product is installed.
Specifies the installed operating system and TruCluster software
when removing patches from an old sytle patch kit. Product ID
specifications are not case sensitive. Wildcards are not permit‐
ted.
When removing an inclusive patch kit, the use of all is manda‐
tory. See Specifying a Product ID with -product. Directs
dupatch to remove all (all) patches or specific (patch_id)
patches from the specified patch kit.
When removing an inclusive patch kit, the use of all is manda‐
tory. See Specifying a Patch ID with -patch.
Optional -delete Options
Specifies a file that contains arguments (in the form argument = value)
to the dupatch command. See Using a Data File. Directs dupatch to not
record actions in a session.log file. Directs dupatch to remove
patches on a cluster using the no-roll procedure rather than the
default rolling-upgrade procedure. Directs dupatch to delete any
patches that passed the predeletion check, even if one or more patches
failed the predeletion check. If -proceed is omitted, dupatch will not
delete any patches if at least one patch failed the predeletion check.
The predeletion check determines whether any installed patches have
dependencies on any of the patches listed for removal. If such depen‐
dencies exist, dupatch blocks the removal of any required patch. Spec‐
ifies an alternate root location. The default root_path is / for all
operations.
Required -track Options
Provides a single command (patch_level) that lists a full description
of the patch kits, CSPs, and ERPs installed on your system, or lists
all patched files (-file), installed patch kits (-kit), or installed
patches (-patch).
Optional -track Options
Specifies a file that contains arguments (in the form argument = value)
to the dupatch command. See Using a Data File. Identifies the loca‐
tion of the patch kit for which the reports will cover.
kit_location is a full path to the directory containing the
patch kit. Directs dupatch to not record actions in a ses‐
sion.log file. Specifies an alternate root location. The
default root_path is / for all operations.
DESCRIPTION
The dupatch utility is an interactive program used to install and
delete software patches to the Tru64 UNIX operating system and systems
running TruCluster software products.
With dupatch you can baseline your system to incorporate any system
files that may have been manually installed. You can also use dupatch
to obtain a list of installed patches or view the system history of
patch installations and deletions.
When invoked without arguments, dupatch is run interactively by provid‐
ing menus that step you through the patching procedure while prompting
you for necessary information. Alternatively, you can invoke dupatch
from the command line, whereby you supply required arguments to the
dupatch command.
Although you can install patches in either single-user or multiuser
mode, the use of single-user mode is strongly recommended. In multiuser
mode, libraries and system files that are in use by active processes
may be affected by the new patches. The patching of any active library
or system files may result in unexpected consequences.
Beginning with Version 5.1B Patch Kit 4 (base level 25), patch kits are
packaged as “inclusive patch kits,” which require all patches in the
kit to be installed or removed together. Therefore, you cannot use the
following options with an inclusive patch kit: /usr/sbin/dupatch
-install -patch patch_id
/usr/sbin/dupatch -delete -patch patch_id
Attempting to use the patch_id option will cause the command to fail.
Inclusive patch kits will also install patches for the Worldwide Lan‐
guage Support (WLS) subset if the WLS subset is installed on your sys‐
tem.
On clustered systems running TruCluster software Version 5.0A or
higher, the dupatch utility is run in conjunction with the rolling
upgrade procedure. (See the Patch Kit Installation Instructions or the
Cluster Installation manual for information about performing a rolling
upgrade.)
Using a Data File
The data_file that you specify with the -data option is a fully quali‐
fied file location and a file that contains command-line options with
the following format:
option1 = value
option2 = value
.
.
.
option3 = n
For example: kit = /mnt name = Joe note = Installing April patch
kit product = Tru64_UNIX_V5.1 patch = 27.01 63.00 74 83.01 product =
TruCluster_V5.1 # multiple patches are separated by space characters
patch = 21.01 27.01 40 precheck_only nobackup
Blank lines and comments (preceded with #) are allowed. Line continua‐
tion (\) is required if a specification spans multiple lines. Only one
data_file is permitted per command line and nested data_file specifica‐
tions are not allowed.
Specifying a Product ID with -product
When installing or removing an inclusive patch kit, you must specify
all with the -product option. For example: ./dupatch -install -product
all -patch all -name Joe -note \ "installing pk4" -kit .
For old style patch kits, the product_id you specify with -product is
one of the following:
TRU64_UNIX_V5.1B
TRU64_UNIX_V5.1A
TRU64_UNIX_V5.1
TRU64_UNIX_V5.0A
TRU64_UNIX_V5.0
TRU64_UNIX_V4.0G
TRU64__UNIX_V4.0F
DIGITAL_UNIX_V4.0D
TruCluster_V5.1B
TruCluster_V5.1A
TruCluster_V5.1
TruCluster_V5.0A
TruCluster_V1.6
TruCluster_V1.5
A product_id specification is not necessary when the system being
patched has only one product installed; for example, Tru64 UNIX Version
4.0F with no TruCluster software product. A product_id specification
only applies to the patch_id specifications that follow it and ends
when another product_id is specified. Because the purpose of the prod‐
uct_id is to clarify the patch_id specification, the product_id must
precede the patch_id. Product strings are not case sensitive. Wildcard
characters are not permitted.
The following example shows the use of a product string with an old
style patch kit: /pk3/patch_kit/dupatch -install-product DIGI‐
TAL_UNIX_V4.0F -patch 1.1 \ -product TruCluster_V1.6 -patch 35 -name
Joe -note \ "installing patch 1.1" -kit /pk3/patch_kit
Specifying a Patch ID with -patch
You must specify all with the -patch option when installing or removing
an inclusive patch kit. For example: ./dupatch -install-product all
-patch all \ -name Joe -note "installing pk4" -kit .
For old style patch kits, the patch_id you specify with the -patch
option has the following format: xxxx[.yy]
For example: 15 200.11 10.2 00111.02
Both xxxx and yy are numeric values; leading zeros can be omitted.
Patch revision (yy), when left unspecified, maps to wildcarded "??"
Multiple patch_id specifications are separated by white space. The
keyword all cannot be combined with other patch IDs. If product_id is
used, patch_id must come after it.
The following example shows the use of the -patch option with an old
style patch kit: /pk3/patch_kit/dupatch -install-product DIGI‐
TAL_UNIX_V4.0F -patch 1.1 \ -product TruCluster_V1.6 -patch 35 -name
Joe -note \ "installing patch 1.1" -kit /pk3/patch_kit
Specifying a Root Path
The root_path you specify with the -root option specifies an alterna‐
tive root for the specified operation. (The -root option is similar to
the -D option of setld.) The following list describes characteristics
of the -root option. The root path must be the root of a complete UFS
file system or AdvFS domain. The default root path is / for all opera‐
tions. If -root is the only argument on the command line, dupatch will
proceed in interactive mode; this is an exception to the command-line
rule previously mentioned. When performing an alternate root installa‐
tion, the -noauto flag is set implicitly.
Specifying a Configuration File
The -cfgfile option to the -install and -delete command options allows
you to call in the system configuration file (/usr/sys/conf/con‐
fig_file). For information about creating or modifying a config_file,
see the doconfig(8) and sizer(8) reference pages.
RESTRICTIONS
The following restrictions apply to the dupatch utility.
You must be logged in as root to run dupatch.
The system must be running in single-user mode when removing patches.
The -product option must precede the -patch option on the command line.
EXIT STATUS
Success. An error occurred.
ERRORS
See the Patch Kit Installation Instructions for a detailed list of
dupatch error messages.
EXAMPLES
The following interactive example shows how to invoke the menu-driven
interface of dupatch: # dupatch
Tru64 UNIX Patch Utility (Rev. 46-00) ========================== -
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 The following interactive example shows how to
perform a preinstallation check on patch 00183.00 contained in the kit
located at /mnt/patch_kit. This will verify that the specified patch
can be installed onto the system without actually proceeding with the
installation: # dupatch-install-kit /mnt/patch_kit -name Jessica
-note \ "Pre-Installation check only on 183.00" -patch 183.00
-precheck_only The following interactive example shows how to install
all patches in kit located at /mnt/patch_kit: # dupatch-install-kit
/mnt/patch_kit -name Jessica \ -note "install all patches" -patch all
The following interactive example shows how to identify all patches
installed on system: # dupatch-track -type patch The following inter‐
active example shows how to list all system files updated by installed
patches: # dupatch-track -type file The following interactive example
shows how to remove patch 00183.00 from the system. Note that the sys‐
tem will automatically be rebooted upon patch deletion because -noauto
was not specified: # dupatch-delete -patch 183.00 -name Joe \ -note
"delete patch 00183.00 from system" The following interactive example
shows how to obtain help on specifying patch_id usage: # dupatch-help
patch_id
ENVIRONMENT VARIABLES
The following environment variables affect the execution of dupatch:
Specifies the maximum number of session logs to be retained on the sys‐
tem. The default number is 25. If, for example, MAX_LOGS is set to 25,
the oldest session log would be named session.log.24 and the current
would be named session.log, with no number affixed. Overrides the
location of the root directory. The default value is /, the system root
directory. This value must be the top-level directory of a file system
(or an AdvFS domain). Specifies the path to the patch tools reposi‐
tory. The default value is $_ROOT/var/adm/patch.
FILES
This file captures dupatch activities. A separate session log is writ‐
ten with each dupatch session and log files from the previous sessions
are saved. The order is first in, first out, with ses‐
sion.log.$MAX_LOGS as the oldest file. This file specifies the date
when the patch tools were loaded or updated onto the system. This file
records the screen output from the baselining session. A separate
baseline log is written for each baselining session and log files from
previous sessions are saved. The order is first in, first out, with
session.log.$MAX_LOGS as the oldest file. This file captures informa‐
tion regarding patch installation and removal operations. A separate
event log is written each time patches are installed or removed. Log
files from previous sessions are saved. The order is first in, first
out, with session.log.$MAX_LOGS as the oldest file. The files in this
directory are used to restore the system to its former state if patches
are deleted. Provides brief summary of what a patch fixes. Provides
detailed discussion of what a patch fixes. Lists the subset inventory
files. Lists the subset control files. Lists the subset inventory
programs. Lists the subset installed lock files.
SEE ALSO
Commands: setld(8), clu_upgrade(8)
Documents:
Patch Kit Installation Instructions
Patch Summary and Release Notes for the patch kit to be installed
Tru64 UNIX Installation Guide
Tru64 UNIX System Administration guide
TruCluster Software Products Software Installation guide
TruCluster Software Products Cluster Administration guide
dupatch(8)