update(1M)

NAME

update, updist − update or install HP-UX files (software products)

SYNOPSIS

[UPDATESCRIPT=’ [filename] ’]
/usr/sbin/update [-F] [-s source] [-S series] [-P port] [-d destination] [-f file] [fileset...]
/usr/sbin/update -c [-s source] [-S series] [-P port]

[UPDISTSCRIPT=’ [filename] ’]
/usr/sbin/updist (same options as /usr/sbin/update)

DESCRIPTION

update on HP-UX 10.0* is used interactively or non-interactively to:

• Install new HP-UX application software (optional products)

• Update existing application software

Note that update on HP-UX 10.* no longer updates or installs operating system and core product files.

The updist command is similar to update, except that it installs or updates the application files as “fileset packages” in a special directory. This allows the system to be a network file distribution (netdist) server. The netdistd network server daemon finds the files in this special directory and supplies them to a remote update process on request (see netdistd(1M)).

If no options or fileset names are specified, update and updist run interactively, providing help screens to aid in selection of installation or update options. To set default values for interactive sessions, use an “update script” (see Update Scripts below). If one or more options or fileset names are specified, update and updist run non-interactively as indicated by the options and fileset names given.

update and updist load files from these types of update media:

• tar-format serial media, normally nine-track, cartridge, or DDS tapes, or an ordinary file containing an appropriate tar image

• systems configured to be netdist servers

Tape update media consist of simple tar archives containing product files and directories (see tar(1)), plus a few leading information files, and specially-crafted file paths that allow files to be grouped into filesets (see Filesets and Partitions below; also update(4)). When run non-interactively, update and updist run unattended and therefore do not allow loading from multiple media units (tapes). If an attempt is made to load from multiple media non-interactively, update refuses to begin loading; updist loads from the first media unit only, then terminates with a warning message.

When updating from a netdist server system, the update “media” consists of a collection of files in a directory hierarchy plus various information files that, together, act as a single media volume.

Before loading any filesets, update and updist calculate the additional disk space consumed by the installation or update. This prevents loading of filesets when sufficient disk space is not available.

Only the super-user can run update and updist.

Options

update and updist support the following options when used non-interactively:

-F Force non-interactive loading to proceed even if certain conditions are encountered that normally would be errors. These conditions would all be warnings if the program were run interactively. They include:

• Fileset version older on update media than already loaded on system.

• Disk space short (invades minfree) but sufficient on one or more volumes.

• Swap space insufficient or cannot be determined (S800 only).

-s source Specify a non-default source for the update. source can be:

• Absolute path name of local special file representing a nine-track, cartridge, or DDS tape.

• Absolute path name of regular file containing an update media image in tar format.

• Hostname of a netdist server system running the netdistd daemon.

The default source is /dev/rmt/0m on all systems.

-S series Specify Series 700 (-S700), or Series 800 (-S800) for the type of files you expect to extract from the source media. The default is the type of system on which update or updist is run. Use this option when:

• Loading files for the non-default system type from a netdist server system.

• Using updist to load a netdist tree using update media that is made for more than one type of system. (Beginning at HP-UX Release 8.05, media can be made for all series of HP 9000 computers. Older media for Series 800 systems can be loaded on Series 700 systems too, although in most cases this is not advisable.)

The value of the -S option is ignored except when it is needed for either of the two above purposes.

-P port Set the port number for the netdist service (applies only if the source is a netdist server). This option overrides the number in the network services database (see FILES below). It is useful when a netdist server system offers various software packages through different netdist servers at different port numbers.

-d destination Specify a non-default destination directory under which filesets are unpacked. For update, the default destination is /. Some filesets require that the destination directory be /. This option is used for updating an application that can be installed anywhere on the file system.

For updist, the default destination is /netdist. This option is used for creating alternate source trees for netdistd.

-f file Read from the specified file, rather than from the command line, the list of filesets or partitions to be loaded (see Filesets and Partitions below). Blank lines and comments in the file are ignored. Comments are remainders of lines beginning with # following whitespace or at the start of a line.

-c Produce a table of contents from the source media. update and updist write a list of partition.fileset names to standard output, one name per line (see Filesets and Partitions below). The output includes comments describing the size of each fileset, its media unit number, any associated fileset flags (see update(4)), its version number, and its description. The output is usable as input to the -f option. Comment out or delete the lines for any filesets you do not want to load.

The -f option cannot be used when naming filesets explicitly, and vice-versa.

Filesets and Partitions

update and updist load units called “filesets” that are groups of related files. One or more filesets can be further grouped into logical “partitions”. Filesets and partitions are the items that you can choose from when updating.

One or more filesets or partitions can be selected for loading. The format of partition/fileset names is:

partition.fileset

The following shorthand specifications are allowed:

partition Select all filesets in a partition.

fileset Select an individual fileset.

* Select all filesets on the media. The * must be escaped in the command line to prevent its expansion by the shell.

Any fileset might require other filesets on which it depends. The update media includes this dependency information. Thus, selection of a fileset with dependencies (interactively or from the command line) causes automatic selection of other required filesets if they are not already present on the system (or for updist, in the netdist source tree) with a version number equal to or greater than that required. (Version numbers are stored in per-fileset index files; see FILES below.) Likewise, interactive unselection of a fileset causes automatic unselection of its other required filesets, unless you explicitly selected them or selected other filesets that require them.

update creates or rewrites fileset lists in “fileset files” under the filesets directory (see FILES below). Each file in this directory has the same name as the fileset it represents. Each line in a filesets file is the full, absolute path name (actual destination) of a corresponding file loaded as part of the fileset.

Updating Netdist Server Master Files

updist transfers filesets from update media to a special tree under the local file system of an update server system and prepares the filesets for use by the netdistd server process. updist differs from update as follows:

• The default destination is /netdist.

• Fileset files are not created.

• Customize scripts are not run.

• Other information files are prepared under the special tree.

Mounted Volumes and Links

update and updist avoid loading files under directories that are on read-only file systems or those normally used as NFS mount points. Both commands begin by executing mount -a with errors ignored. They then check and require that all disks listed in /etc/fstab are indeed mounted (the disks must be listed in /etc/mnttab).

update and updist break hard links when re-creating updated files. They also follow symbolic links and update the targets of the symbolic links. update records in fileset files the absolute path of updated files, after resolving any symbolic links.

Update Scripts

An update script is a shell script that captures the program status of an interactive session. This is helpful if you want to run update or updist non-interactively later (for example, via remsh on a different system, or possibly repeated on the same system). Saved values from a previous interactive session also provide an optional set of default values for the next time you run update or updist interactively, as described below. The update script also serves as an added audit trail.

The update script is created or rewritten just before confirmation is requested to begin loading, each time that that point is reached (if confirmation is denied). update writes to the /var/tmp/update.script file and updist writes to /var/tmp/updist.script.

Note: some conditions that cause warnings when running interactively cause errors when running non-interactively. Also, the update script is not guaranteed to run successfully on a remote system where the context is different, especially if it is of a different Series type.

If the UPDATESCRIPT (for updist, UPDISTSCRIPT) environment variable is set, update or updist attempts to read the file named in the variable as an update script (shell script) in a specific format emitted by an earlier invocation of the same program. For example:

UPDATESCRIPT=’/var/tmp/update.script’ /usr/sbin/update

If the variable value is null, the program reads the appropriate default update script name. For example, the following causes updist to read /tmp/updist.script:

UPDISTSCRIPT=” /etc/updist

In the unlikely event you want to create an update script by hand, the update script format is documented in update(4).

If the program is able to “read back” the update script correctly, it uses the values found there as default values for selected environment variables, the update source and destination and related values, the target Series type, kernel building information, and selected fileset names.

If the previous invocation of update or updist involved the “Select Only Filesets Currently on your System” choice, and no changes were then made to the auto-selected filesets, the update script file contains the -m option and no fileset names. If on the other hand the update script does contain a list of fileset names, they are automatically pre-selected after readback. However, this only occurs if and when the first selection option chosen on the main screen is Select/View Partitions and Filesets. Also, only listed filesets found on the current update media are selected this way.

DIAGNOSTICS

Messages are displayed during interactive execution, and error messages result from invalid non-interactive invocation. For information about any failures encountered while loading filesets in either mode, inspect the log file (see FILES below).

EXAMPLES

Update or install the filesets DATA1 and DATA2 on the system using the default source device and destination directory:

update DATA1 DATA2

Update or install all filesets on the media in the default source device under the directory /tmp:

update -d /tmp ’*’

Print the contents of the update media accessed through special file /dev/rmt:

update -c -s /dev/rmt

Extract fileset TEXT-FMT from the default source device and make it available to other systems via netdistd. In this example, /pseudoroot is the directory from which netdistd draws its files:

updist -d /pseudoroot TEXT-FMT

WARNINGS

Always review the log file /var/tmp/update.log after an update for relevant errors, warnings, and other messages.

If any loaded fileset is flagged for reboot, that flag is ignored.

The rmfn command cannot be used to remove packages loaded by updist.

When run interactively, update and updist depend on the TERM environment variable to determine the display type. If the variable is absent or has the wrong value, the display might behave oddly.

Interactive update and updist use special function keys (SFKs) extensively. They do not save or restore user function-key definitions after the update is complete.

DEPENDENCIES

NFS

update and updist refuse to update files on remote systems over NFS network connections. They pre-mount all normally mounted volumes, including NFS mounts, to ensure that such files are detected and that unwanted files are not deposited under the mount point on the local disk. update and updist complete loading all local files, give warnings about remote files not loaded, and return 0 if no other problems are detected.

Networking

To load files from a netdist server system, networking services must be configured into the local kernel and turned on.

AUTHOR

update and updist were developed by HP.

FILES

/dev/rmt/0m default source for Series 700 and 800 systems

/ default destination for update

/netdist default destination for updist and source for netdistd

/var/adm/rupdate/filesets
directory where fileset files are stored

/var/adm/rupdate/system directory containing important information about and customize scripts for each fileset

/var/adm/rupdate/system/fileset/index
provides information about the fileset, in particular, its version (update uses the version to decide if a dependee fileset is already current on the system and need not be reloaded)

/var/adm/rupdate/system/fileset/update_dest
names the destination directory under which a fileset was loaded, if other than /.

/var/tmp/update.log log file describing the events that occurred during the update process, including errors, warnings, and notes

/var/tmp/update.cleanup list of files logged as non-removable, usually due to “text file busy”

/var/tmp/update.script file written during interactive invocation for later non-interactive invocation and for readback of default values

/var/tmp/updist.script same, but emitted by updist

/var/tmp/update.kernbld used by cluster nodes to rebuild their kernels at the next reboot

/usr/lib/rupdate/jam directory containing JAM user interface information

/usr/lib/rupdate/update directory containing files used by update and updist when run interactively

/etc/services networking services database, file describing networking services, including the netdist service

/etc/fstab list of volumes that should be mounted

/etc/mnttab list of volumes currently mounted

Museum

Related Articles