UPDATE(1M)

NAME

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

SYNOPSIS

/etc/update [−cm] [−s source] [−S series] [−P port] [−d destination] [−r kernel_gen_file] [−b partition] [−f file] [fileset...] /etc/updist [−cm] [−s source] [−S series] [−P port] [−d destination] [−f file] [fileset...]

DESCRIPTION

Update is used interactively or non-interactively, and from local media or a remote “netdist” server system, to:

• Update the HP-UX operating system and core product files,

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

• Update existing optional HP-UX application software.

Updist is similar to update, but installs or updates the HP-UX system or application files as “fileset packages” in a special directory. This allows the system to be a network file distribution (netdist) server. The network server daemon, netdistd(1M), finds the files in this special directory and supplies them to a remote update process at its request.

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. 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 media consist of simple tar(1) archives containing product files and directories 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. If an attempt is made to load multiple media non-interactively, update refuses to begin loading; updist loads the first media unit only, then terminates with a warning message.

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 superuser can run update and updist.

Options

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

−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 number, and any associated fileset flags (see update(4)). The output is usable as input to the −f option.

−m (match) Load new versions of all filesets currently installed on the system. The filesets directory is used to determine the currently loaded set. If fileset names change between HP-UX releases, update and updist use internal tables to correctly convert old names to corresponding names in the new release.

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

• Hostname of a netdist server system running the netdistd(1M) daemon

• Local block-special file representing a nine-track tape

• Local character-special file representing a cartridge tape

The default source is /dev/update.src on Series 300 systems and /dev/rmt/0m on Series 800 systems.

−S series Specify Series 300 (−S300) 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 from old S800 media that don’t contain a type designation, and if necessary when loading files from a netdist server system running the netdistd(1M) daemon.

−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 file (see FILES below).

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

−r kernel_gen_file
(Update only) Reboot after loading all requested filesets, if required, and specify the kernel generation file that reflects the currently-running kernel. With this option, if any fileset is marked as requiring a system reboot, update reboots the system after loading files and rebuilding the kernel, regardless of currently running processes. This option is required if a fileset is selected that inspects or modifies the kernel, since update must inspect or alter the generation file to succeed. On Series 300 systems, kernel_gen_file is typically /etc/conf/dfile. On Series 800 systems, it is typically /etc/conf/gen/S800. There is no default value.

−b partition (Update only; S800 only) Specify the current boot partition on the disk. The disk partition, not to be confused with a logical (fileset) partition, is the name of a special file relative to /dev/rdsk. The default is c0d0s6. The disk partition must contain a LIF volume.

When run interactively, update uses the default value. It prompts for an alternate value only if /dev/rdsk/c0d0s6 is unusable or that partition does not contain a LIF volume.

−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 #.

The −m and −f options, and naming filesets explicitly, are mutually exclusive.

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 a user 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. Likewise, interactive unselection of a fileset causes automatic unselection of its other required filesets, unless the user explicitly selected them or selected other filesets that require them.

Update creates or rewrites fileset lists in 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.

Filesets marked as requiring rebooting are always loaded first so update can rebuild the kernel after loading them. If rebuilding fails, update aborts rather than loading any other filesets, because they might include executable files that cannot run correctly on the current system version.

Updating Netdistd Server Master Files

Updist transfers filesets from factory-supplied update media to a special tree under the local file system of an update server system. Updist prepares the filesets for use by the netdistd(1M) server process. Updist differs from update in these ways:

• The default destination is /netdist.

• Fileset files are not created.

• Customize scripts are not run.

• Other 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/checklist are indeed mounted (disks must be listed in /etc/mnttab).

Update and updist break hard links caused by re-creating updated files. They also follow symbolic links and update the targets of the symbolic links. Update records in fileset files the symbolic path to updated files, not the actual path; even when traversing a symbolic link.

HP Clustered Environment

Update and updist recognize filesets as containing Series 300 or Series 800 files. When loading files for one Series onto a file system running on the other Series (that is, onto the cluster server of a mixed cluster), update creates context-dependent file (CDF) elements as required (specified by the media). Also, the fileset and system directories on a mixed cluster (see FILES below) should already be CDFs. Updist maintains separate subdirectories for each Series.

Update does not install cluster servers or convert standalone systems to cluster servers. Use sam(1M) for that purpose.

RETURN VALUE

Interactive invocation always returns 0. Command line invocation returns:

0 the update ran successfully to completion

1 an error occurred and no files were loaded

2 an error occurred and some files might have been loaded; review the log file for details (see FILES below)

DIAGNOSTICS

Messages displayed during interactive execution, and error messages resulting from invalid non-interactive invocation, are self-explanatory. 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 “NAMERICA” and “PC” on the system using the default source device and destination directory:

update NAMERICA PC

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

Update all files in filesets currently on the system (match), rebooting when done if necessary, and reading the current kernel configuration from /etc/conf/dfile.old:

update −mr −g /etc/conf/dfile.old

Extract fileset “TEXT” 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

WARNINGS

Always review the log file after an update for relevant warnings and messages.

Update can reboot the system as part of an update. Flags associated with each fileset indicate the necessity for a reboot. In interactive mode, update warns the user if such a fileset is selected. If the system is not in a quiescent state, the user can proceed, or quit update and take appropriate action to bring the system to single-user state. In command-line invocation with a rebooting fileset selected, update aborts before loading any filesets unless the −r option is specified.

If any loaded fileset is flagged for reboot, or for delayed execution of customize scripts, update reboots the system twice. The first reboot brings up the new kernel and allows customize scripts to run. The second reboot restarts the system in its normal state after all customization is complete.

If both rebooting and non-rebooting filesets are loaded, update leaves a file named /customize on the system. This is the master customize script that invokes all others and that causes the second system reboot. It can be removed without risk.

Most filesets are flagged such that update does not remove their files first (using sysrm(1M)). If a fileset is updated to a different destination than where currently installed, the old version might not be deleted. In this case, you might want to run sysrm manually before the update (before the fileset file is revised). Also, if a fileset name changes, update removes the fileset using its current name, which might be ineffective.

Sysrm does not know how to remove packages loaded by updist. To remove updist-package files, run rm −r on the package directories under the netdist source tree, and edit the central package definition file to comment out or delete the references to the package.

Fileset name translation with the −m option is limited to filesets in the core HP-UX product, and excludes optional or third-party products and software subsystems.

Run interactively, update and updist depend on the TERM environment variable to tell them 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

Networking
Update and updist refuse to update files on remote systems over NFS or RFA 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, and give warnings about remote files not loaded.

AUTHOR

Update and updist were developed by HP.

FILES

/dev/update.src default source for Series 300 systems

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

/ default destination for update

/netdist default destination for updist and source for netdistd

/etc/filesets directory where fileset file lists are stored

/system directory containing important information and customization scripts for each fileset

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

/tmp/update.procs list of unexpected processes running concurrently with update; only created if reboot is required

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

/etc/checklist list of volumes that should be mounted

/etc/mnttab list of volumes currently mounted

Museum

Related Articles