update-ux(1M)

NAME

update-ux — updates the HP-UX operating system from new HP-UX media

SYNOPSIS

update-ux [-i] [-p] [-v] -s source_location [-?] [-x option=value] [-f software_file] [sw_selections]...

DESCRIPTION

The update-ux command updates the HP-UX operating system to a newer version.

Use update-ux when updating the operating system (OS), and installing or changing operating environments (OEs). update-ux works only with source depots containing the OS and OEs such as HP-UX 11i OE DVDs. When using other non-OE media as the source (such as AR), use swinstall(1M) instead.

update-ux will always attempt to update the OS. In order to update a system successfully, an Operating Environment must exist in the source. A bundle name does not need to be specified on the command line. By default, update-ux will install the software from the source that matches and updates the software that is installed on the system. However, if a system does not contain a previous version of an OE, one must be specified on the command line or in the interactive Terminal User Interface (TUI).

If the current OS is 11.11 or 11.22 , first install update-ux onto the existing system. For example:

swinstall -s source_location Update-UX

where source_location is the path to a depot containing the 11i Update-UX product.

Options

update-ux supports these options:

-i: Perform the OE update in the interactive terminal user interface (TUI). For more information, see the swm(1M) manpage.
-p: Previews an update task by running the session through the analysis phase only.
.TP: -v Turns on verbose output to stdout. (The swm logfile is not affected by this option).
-s source_location: Specify the source location. Possible locations are a local directory, a mounted DVD containing an SD depot, or a remote machine and depot combination. If source_location is a DVD, update-ux expects to install from one DVD. If source_location is a remote machine and depot combination, the remote machine should be specified first, followed by the absolute path to the remote depot, separated by a colon with no spaces; for example: swperf:/var/spool/sw.
-?: Print the usage statement.
-x option=value: Set swm(1M) options.
-f software_file: Read the list of sw_selections from software_file instead of (or in addition to) the command line.
sw_selections: Software selections support the same syntax as the SD commands plus the syntax outlined in Software Selections below (see swinstall(1M) for details on SD's supported syntax).

Software Selections

In addition to the SD syntax, the following syntax is supported for sw_selections:

bundle[,version]
product[.subproduct][.fileset][,version]
!selection
[bundle]/[%match]
pattern-matching-expression

Where version can be:

[,r <op> revision][,a <op> arch][,v <op> vendor] 
[,c <op> category][,q=qualifier][,l=location] 
[,fr <op> revision][,fa <op> arch] 

Where op can be:

=, ==, >=, <=, <, >, or !=

The = (equals) relational operator lets you specify selections with the shell wildcard and pattern-matching-expressions:

[ ], *, ?

The syntax !selection causes that selection to be deselected even if it was listed on the command line as part of other selections.

RETURN VALUE

The update-ux command returns a value when it is not successful:

1: Error during execution; update aborted.

DIAGNOSTICS

Standard Output:

An update-ux session writes messages for significant events, including:

Begin-session and end-session messages.
Major task messages.

Logging:

Errors are recorded in: /var/adm/sw/update-ux.log and /var/adm/swm/swm.log.

EXAMPLES

To update from the OE depot on an HP-UX 11i OE DVD mounted at /dvd, enter:

/usr/sbin/update-ux -s /dvd HPUX11i-OE
The example above updates the HP-UX 11i Operating Environment (OE).

To install all bundles and products in sw_server that match and update software that is installed on the system:

/usr/sbin/update-ux -s sw_server:/depot/oes
Which is equivalent to:
/usr/sbin/update-ux -s sw_server:/depot/OEs /%match
The syntax /%match selects all software in the source that matches what is already installed on the system.

To select only software in HPUX11i-OE that matches the software on the target system:

/usr/sbin/update-ux -s sw_server:/depot/OE HPUX11i-OE/%match
The syntax bundle/%match selects only software in the specified bundle that matches what is already installed on the system.

To update to HPUX11i-OE and include the HP-UX Bastille Security Configuration bundle:

/usr/sbin/update-ux -s /dvdrom HPUX11i-OE Sec30DMZ 

To interactively select software for an update, use the -i option:

/usr/sbin/update-ux -s sw_server:/depot/OEs -i 

To update the operating environment (OE), explicitly to the MCOE:

/usr/sbin/update-ux -s sw_server:/depot/oes HPUX11i-OE 

To update all the software that is part of the OE except Mozilla:

/usr/sbin/update-ux -s /var/spool/sw !MOZILLA 

To select all of HPUX11i-OE except for Perl, which is part of HPUX11i-OE, you could specify the following:

/usr/sbin/update-ux -s /depot/OE HPUX11i-OE !Perl
The only exception to this is if the selection is in the Operating Environment's required contents list, in which case it cannot be deselected without deselecting all of the Operating Environment. Note that deselections have precedence over selections. Thus the order is not important. The example above would be the same as the following command:
/usr/sbin/update-ux -s /depot/OE !Perl HPUX11i-OE

AUTHOR

update-ux was developed by HP.

FILES

/usr/sbin/update-ux: The update-ux command.
/var/adm/swm/swm.log: The swm log file.
/var/adm/sw/update-ux.log: The update-ux log file.