update-ux(1M)

NAME

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

SYNOPSIS

update-ux -s source_location [-?] [-n|-y] [-i] [-x option=value] [-f software_file] [sw_spec]

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 media as source, use swinstall instead.

update-ux will always attempt to update the OS. The following bundles are always installed from HP-UX 11i OE DVDs:

HPUXBaseOS
HPUXBaseAux
B9073BA
B8465BA
WBEMP-LAN-00
NPar
Base-VXVM
OnlineDiag
SysMgmtBase
FDDI-00
FibrChanl-00
FibrChanl-01
IEther-00
GigEther-00
GigEther-01
USB-00
scsiU320-00
CDE language bundle based on installed CDE.
Other bundles based on the OE version.
Other network drivers based on installed software.

In order to install an Operating Environment, the corresponding OE bundle must be specified on the command line (see sw_spec, below).

HPUX11i-OE
HPUX11i-OE-Ent
HPUX11i-OE-MC

To list all product bundles available on the DVD mounted at /dvd, enter:

/usr/sbin/swlist -s /dvd 

If you are changing OEs within the same OS version, update-ux will attempt to update the OS. However, only software that has not yet been installed will be installed. Software already on the target system will be deselected during the analysis phase.

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 full path to a depot containing the 11i Update-UX product.

Options

update-ux supports these options:

-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. All paths used in the source_location must be absolute paths. 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.
-n|-y: By default, update-ux pauses when an error is detected to ask if it should continue. Specify "no" (-n) or "yes" (-y) to tell update-ux whether to continue when a error message is issued. Use -n (or omit this option) at first to have update-ux abort when an error is encountered. Then review the error logged in /var/adm/sw/swagent.log. When you have reviewed/resolved the errors, use -y to have update-ux ignore any remaining errors.
-i: Start the swinstall interactive interface. For more information, see the swinstall(1M) manpage.
-x option=value: Set swinstall options. swinstall -p (preview) is not supported. For more information, see the swinstall(1M) manpage.
-f software_file: Read the list of default installed bundles from software_file instead of the /usr/lib/sw/update-ux.selections file.
sw_spec: Specify optional software selection such as an OE or network-driver bundle name.

RETURN VALUES

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

1: Error during execution; update aborted.
2: Update aborted per user request (-n option) or from keyboard.

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/sw/swagent.log.

EXAMPLES

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

/usr/sbin/update-ux -s /dvd HPUX11i-OE 

That example updates the OS and installs the HP-UX 11i Operating Environment (OE).

To update the OS from /dvd, but not install an OE and ignore any error messages, enter:

/usr/sbin/update-ux -s /dvd -y 

To update the OS and also update any software on the target system with new versions found in the source depot at /dvd, enter:

/usr/sbin/update-ux -s /dvd -x match_target=true 

AUTHOR

update-ux was developed by HP.

FILES

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