Updating to HP-UX 11i v1

Updating your system using update-ux includes the following tasks:

Create a network depot so you can update other systems on the network. See “Task 1: Creating a Network Depot (Optional)”. If you are not creating a network depot, you can skip this task.
Install the latest version of the update-ux command on your system. See “Task 2: Installing the Latest Update-UX Bundle (Required)”.
Use update-ux to update your system. See “Task 3: Using update-ux (Required)”. Several examples are provided to assist you with some of the most common scenarios for using update-ux.

After updating to HP-UX 11i v1, you may need to configure OE Applications to make your system fully functional.




	CAUTION: If you are using CDs to update an HP-UX 10.20 system to the HP-UX 11i v1 (B.11.11) Operating Environments, the update-ux command will fail because HP-UX 10.20 does not support Rockridge extension. To resolve this issue, first update to the desired HP-UX 11i v1 December 2003 Operating Environments and then update to the desired HP-UX 11i v1 Operating Environments.




	NOTE: update-ux removes all HP-UX 10.x patches from the system prior to updating to HP-UX 11i v1. Any 10.x applications left on the system after the update may not be supportable if they required those patches. After migrating your system, consult the documentation for those remaining applications for HP-UX 11i v1 requirements.

Task 1: Creating a Network Depot (Optional)

If you want to update other systems on the network then you must first create a network depot before you update your system and other systems.




	NOTE: This optional step pertains to creating a network depot so you can update other systems on the network. If you already have a network depot, go to “Task 2: Installing the Latest Update-UX Bundle (Required)”.

As root, follow this procedure to create a network depot from the HP-UX 11i v1 CD or DVD onto a depot server or other system running HP-UX 11i v1 in your network:

Verify that you have at least 2 GB of free space to create the network depot on another system in your network. If this space is not available, use sam either to create a new volume group or to extend an existing volume group. For help, refer either to SAM help or Managing Systems and Workgroups: A Guide for HP-UX System Administrators.
Log in as root and mount the logical volume on a new directory named /update.
This directory will hold your network depot.
Insert the HP-UX 11i v1 CD or DVD into the drive.
Find the CD or DVD device file name:
ioscan -f -C disk | more
/dev/dsk/c1t2d0 is a typical CD device name.
Create the directory under root(/):
- CD: mkdir /cdrom
- DVD: mkdir /dvdrom
Mount the CD or DVD onto the new directory as a file system. For example:
- CD: mount /dev/dsk/c1t2d0 /cdrom
- DVD: mount /dev/dsk/c1t2d0 /dvdrom
Merge all products on the mounted CD or DVD to the target depot, for example /update/update-depot:
- CD: swcopy -s /cdrom \* @ /update/update-depot
- DVD: swcopy -s /dvdrom \* @ /update/update-depot
Unmount the CD or DVD from its directory:
- CD: umount /cdrom
- DVD: umount /dvdrom
If you are updating to HP-UX 11i v1 using CD, follow steps Step 9 - Step 10; if you are using DVD, continue to “Task 2: Installing the Latest Update-UX Bundle (Required)”.
Insert the requested HP-UX 11i v1 CD.
Repeat Steps Step 6 through Step 8 for the requested OE CDs and the Support Plus CD.

The network depot is now ready to update your system to HP-UX 11i v1. Continue with “Task 2: Installing the Latest Update-UX Bundle (Required)”.

Task 2: Installing the Latest Update-UX Bundle (Required)

This procedure describes how to install the latest version of the UPDATE-UX bundle, which includes the update-ux command.

Find the CD or DVD device file name:
ioscan -f -C disk | more
/dev/dsk/c1t2d0 is a typical CD device name.
Create the directory under root(/):
- CD: mkdir /cdrom
- DVD: mkdir /dvdrom
Mount the CD or DVD onto the new directory as a file system. For example:
- CD: mount /dev/dsk/c1t2d0 /cdrom
- DVD: mount /dev/dsk/c1t2d0 /dvdrom
Using ksh, Posix-sh, or Bourne shell, install update-ux on the target system; the depot example uses depot_server:/var/depots/my_depot
- CD: swinstall -r -s /cdrom Update-UX \ \@ /var/adm/sw/update-ux.root 2> /dev/null
- DVD: swinstall -r -s /dvdrom Update-UX \ \@ /var/adm/sw/update-ux.root 2> /dev/null
  swinstall -r -s depot_server:/var/depots/my_depot \ Update-UX \@ /var/adm/sw/update-ux.root 2> /dev/null
TIP: The backslash (\) at the end of the first line is not needed if you enter the complete command on one line.
The -r option writes log files to the specified alternate root (pseudo-root) location, update-ux.root. (Do not specify any other alternate root location.) Because the HP-UX 11i v1 Software Distributor tool contains many keywords that 10.20 and 11.00 SD do not recognize, installing update-ux initially at this alternate root location eliminates many unnecessary update-ux warnings.
Immediately after update-ux is installed, a script copies update-ux to /usr/sbin/. When update-ux runs for the first time, it removes the initial version at the alternate root location.

Task 3: Using update-ux (Required)

After you have installed the Update-UX bundle on the target system and, optionally, created an update depot containing all software to be installed, you can now proceed to update your target system.

The Update-UX product includes a default selections file, update-ux.selections, which is installed in /usr/lib/sw. This file provides a list of bundles that are selected for install during an OS update.

Update-UX provides support for the -f selection_file option on the update-ux command line. With this option you can create your own selections file and specify that your file be used in place of the default selections file. This provides you with the flexibility to deselect any bundles listed in the update-ux.selections file by providing your own file, which does not contain these bundles.

To do this, you must first install the March 2004 version or later version of the Update-UX product onto your target system, then copy and edit the /usr/lib/sw/update-ux.selections file as desired. When executing Update-UX, your custom selections file can be specified on the update-ux command line via the -f selection_file option.

Use the following syntax to run the update-ux command:

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

where:

-s source_location

Specifies the source containing the new software depot. Possible locations are a local directory, a mounted DVD containing a depot, or a remote system-and-depot combination. All paths used in the source_location must be absolute paths. If source_location is a remote system and depot combination, specify the remote system first, followed by the absolute path to the remote depot, separated by a colon with no spaces; for example: swperf:/var/spool/sw

?

Prints the usage statement.

n|y

Specifies whether or not update-ux issues a message and waits for your response to continue whenever something unexpected is encountered. Specify -n first (or omit this option) to have update-ux “not continue” when an error is issued. When you have reviewed or resolved all errors, use y instead of n to have update-ux ignore all messages that would otherwise cause update-ux to wait for a user response.

i

Specifies the swinstall interactive user interface to select software products from a depot or bundle during the update. For more information, refer to the swinstall(1M) manpage.

f selection_file

Reads the list of software selections from selection_file instead of (or in addition to) the command line. This option enables you to select and update optional software or to deselect default-installed software.

To do this, you must first install the March 2004 or later version of the Update-UX product onto your target system, then copy and edit the /usr/lib/sw/update-ux.selections file as desired. When executing Update-UX, your custom selections file can be specified on the update-ux command line via the -f selection_file option.

x option=value

Specifies swinstall -x options to be applied during the update. For a typical update, no swinstall options are required. swinstall p (preview) is not supported. For information on swinstall options, refer to the swinstall(1M) manpage or the Software Distributor Administration Guide.

sw_spec

Specifies one or more software bundles to be updated, such as an Operating Environment (OE) bundle name, an application bundle, or a network-driver. If an OE bundle name is not included on the command line, only the core OS will be updated. For more information, see Appendix C “HP-UX 11i v1 Software Bundles”.

For more about update-ux, refer to the update-ux(1M) manpage.

Examples: Using update-ux to Update Your System

Your system configuration and your planning determine how you use update-ux. This section provides some scenarios and examples of how you might use update-ux to update your system:

“Updating to HP-UX 11i v1 OS (OE Installed)” explains how to update to HP-UX 11i v1 with an Operating Environment.
“Updating to HP-UX 11i v1 OS (No OE Installed)” describes how to update the HP-UX 11i v1 OS without an Operating Environment.
“Adding or Upgrading an OE” explains how to update your system by either adding or upgrading the Operating Environment on your system.
“Downgrading an OE” explains how to move your system from an advanced Operating Environment to a smaller Operating Environment.
“Updating from a Network Depot” explains how to update your system from a server on the network.
“Updating Selectable Software” explains how to update your system with selectable software bundles.
“Updating Using Interactive Software Selection” explains how to use the interactive option to manually select the software you want to update.
“Updating to a 64-bit OS” shows you how to move a 32-bit system to a 64-bit OS.
“Update Using match_target” explains how to update your system using the match_target option.

Recommended Update

Updating to HP-UX 11i v1 OS (OE Installed). To update to HP-UX 11i v1 and include an HP-UX 11i v1 Operating Environment, you need to specify the OE bundle name in the update-ux command. The OE bundle names are:

HPUX11i-OE: HP-UX 11i v1 Foundation OE
HPUX11i-OE-Ent: HP-UX 11i v1 Enterprise OE
HPUX11i-OE-MC: HP-UX 11i v1 Mission Critical OE
HPUX11i-MTOE: HP-UX 11i v1 Minimal Technical OE
HPUX11i-TCOE: HP-UX 11i v1 Technical Computing OE

For example, to update to HP-UX 11i v1 and install the HP-UX 11i v1 Foundation OE, insert the HP-UX 11i v1 DVD in the local drive mounted at /dvdrom. As root, enter:

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

Alternately, if you want to update to HP-UX 11i v1 and install the Enterprise OE (from a supported update path), enter:

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




	NOTE: Make sure to read “Supported Update Paths to HP-UX 11i v1” to ensure that you are updating your system from a supported update path.Make sure that you install all of the selectable OE bundles that you want at the same time that you do your update. “Updating Selectable Software” for more information. For details on what is included in each of the Operating Environments, see Appendix C “HP-UX 11i v1 Software Bundles”.

Updating to HP-UX 11i v1 OS (No OE Installed).




	IMPORTANT: If you already have an Operating Environment installed on your system, you cannot use this scenario. Instead, use “Updating to HP-UX 11i v1 OS (OE Installed)”. Attempting this scenario when you already have an Operating Environment installed will cause update-ux to fail.




	NOTE: HP strongly recommends that you update your system with an Operating Environment to provide you with an integrated and tested set of supporting software and applications.

If you do not specify an OE bundle, update-ux only installs the OS, networking, diagnostic, and CDE bundles listed in Appendix C “HP-UX 11i v1 Software Bundles”. Any additional software bundles associated with an OE are not installed.

For example, to update the HP-UX 11i v1 OS, insert the HP-UX 11i v1 DVD in the local mounted drive and enter the following command:

/usr/sbin/update-ux -s /dvdrom

Adding or Upgrading an OE. To install an OE on an HP-UX 11i v1 system not containing an OE, or to upgrade HP-UX 11i v1 to higher-level OE (for example, HP-UX 11i v1 Foundation OE to HP-UX 11i v1 Enterprise OE), insert the HP-UX 11i v1 DVD and specify the new OE using the update-ux command.

For example, to add the HP-UX 11i v1 Enterprise OE, enter:

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

When the update is complete, the original OE bundle wrapper (if one existed) is removed and replaced with the new bundle wrapper.

Downgrading an OE. If you want to downgrade your system from a higher-level OE, say, from Mission Critical OE to Foundation OE, first use update-ux to install the lower level OE from the latest set of HP-UX 11i v1 media, then use swremove to remove the unwanted OE bundle and its software. For example, to move from the 64-bit Mission Critical OE to the 64-bit default HP-UX 11i v1 OE:

As root, add default HP-UX 11i v1 OE:
- CD: /usr/sbin/update-ux -s /cdrom -y HPUX11i-OE
- DVD: /usr/sbin/update-ux -s /dvdrom -y HPUX11i-OE
The -y option causes update-ux to ignore warning messages and complete the update.
Remove the Mission Critical software:
/usr/sbin/swremove HPUX11i-OE-MC
This command removes the IPD entries and software for the additional (superset) software in the Mission Critical OE, leaving the default HP-UX 11i v1 OE software intact.

Updating from a Network Depot. To update from a network depot on a remote system named netdepot, include the path to the depot in the update-ux command. The following example does an update to the HP-UX 11i v1 Enterprise OE:

/usr/sbin/update-ux -s netdepot:/update/update_depot \
HPUX11i-OE-Ent

Updating Selectable Software. To update to HP-UX 11i v1 and specify additional selectable bundles such as Software Package Builder on the command line, follow these steps:

If you want to install the HP-UX 11i v1 Foundation Operating Environment bundles listed in Appendix C “HP-UX 11i v1 Software Bundles”, plus the SwPkgBuilder Software Package Builder bundle, enter from the DVD media as root:
/usr/sbin/update-ux -s /dvdrom HPUX11-OE SwPkgBuilder
If you want only to update your system with a selectable software bundle, enter:
/usr/sbin/update-ux -s /dvdrom SwPkgBuilder
Complete any configuration for HP software explained in the HP-UX 11i v1 Release Notes available on the Instant Information CD and at: http://docs.hp.com/hpux/os/11iv1

Updating Using Interactive Software Selection. To interactively select software for an update, use the -i option. For example:

/usr/sbin/update-ux -s /cdrom -i

update-ux displays swinstall’s interactive user interface with software already selected to match the default update. Now you can change software selections. For example, you can select a non-default network driver or a web browser before performing the update. Because update-ux selects OS, networking, language, and diagnostic bundles by default, the interactive user interface provides a way to deselect the default software.




	CAUTION: Do not combine -i and -x options in the same update-ux command.

For help using swinstall in interactive mode, refer to the swinstall(1M) manpage or the Software Distributor Administration Guide.

Updating to a 64-bit OS. Make sure that your system can support the 64-bit OS before running this command. If you have decided to update an HP-UX 11i v1 32-bit system to a 64-bit OS, use the following command:

CD: /usr/sbin/update-ux -s /cdrom -a 64
DVD: /usr/sbin/update-ux -s /dvdrom -a 64

Update Using match_target. The following command using the match_target option installs the entire HPUX11i-OE bundle, including all OS, networking, CDE, and diagnostic bundles described in the previous example and any software selected by match_target. The software you want to install might not come from a bundle.

CD: /usr/sbin/update-ux -s /cdrom \ -x match_target=true HPUX11i-OE
DVD: /usr/sbin/update-ux -s /dvdrom -x match_target=true HPUX11i-OE

Updating Existing OE Components Only

The following command updates the same OE (HPUX11i-OE) and installs the OS, networking, CDE, and diagnostics bundles.

CD: /usr/sbin/update-ux -s /cdrom -x match_target=true HPUX11i-OE.
DVD: /usr/sbin/update-ux -s /dvdrom -x match_target=true HPUX11i-OE.

The difference from the previous example is that the dot (.) following the OE bundle name installs the OE bundle wrapper, not the entire OE. With this variation, only those OE components that are already installed on your system get updated. Any new OE components and products are not installed.

If no argument is specified, then only the OS and its components are updated. However, HP does not recommend using match_target to update your system to an OE without specifying an argument because:

If software arguments are not specified, match_target only installs filesets matching those already on your system. Filesets containing any new HP-UX 11i v1 functionality introduced are not selected.
Some software that is installed does not include bundle wrappers, making identification of software on the system more difficult.