swgettools(1M)

NAME

swgettools — Utility for retrieving the SD product from new SD media in preparation for an OS update.

SYNOPSIS

swgettools [-s source] [-t temp_directory_path]

DESCRIPTION

The swgettools command updates or reinstalls the latest SD commands (SW-DIST product) to your system from media or a depot. The new SD commands are needed to install updated releases of HP-UX.

Prerequisites

The swgettools script needs a temporary directory with at least 2 MB of free space. If there is not enough space in the temporary directory, swgettools will fail.
By default, swgettools uses the /var/tmp directory. Use the bdf /var/tmp command to determine if /var/tmp has adequate space.
If you do not have 2 MB free in /var/tmp, use the -t temp_dir_location option to specify a different temporary directory.
The SW-GETTOOLS product loaded by swgettools requires enough space to install the following files:
/var/adm/sw/lbin (1 MB)
/var/adm/sw/sbin (3 MB)
/var/adm/sw/lib (6 MB)
/usr/lbin/sw/bin (5 MB)
These files are automatically removed when you reboot.
Your system needs at least 32 MB of RAM to successfully update to HP-UX version 10.30 or greater.

Procedure

To update SD, you must first load the swgettools command onto your system. You can then run swgettools to get the new SW-DIST product, which contains the new SD-UX commands.

swgettools is shipped in the catalog/SW-GETTOOLS/pfiles directory. Depending on whether the HP-UX software is on CD, tape, or a remote system in a software depot, use cp, tar, or rcp to load swgettools onto your system. (HP recommends that you use the default directory, /var/tmp.)
Run swgettools. This creates the SW-GETTOOLS product, which updates SW-DIST.
Use the new version of swinstall to update the rest of the operating system. See swinstall(1M) for more information.
CAUTION: You MUST use the latest version of swinstall to update your system to the latest version of HP-UX. If you use a previous version of swinstall, the update will fail.
Reboot the system.

For complete instructions regarding updating HP-UX, see Installing HP-UX 11.0 and Updating HP-UX 10.x to 11.0.

CAUTION: Ensure that the booted kernel is /stand/vmunix before you install any kernel software. The swinstall process assumes that the system has booted using the kernel at /stand/vmunix. Installing kernel software or performing an operating system update with any other kernel might result in loss of data or other errors.

Options

The swgettools command supports the following options:

-s source

Specifies the path for the source media. Possible locations are: a local directory that is an SD depot, a character-special tape device file connected to a tape drive that has an SD media tape loaded, a CD-ROM mount point that has an SD media CD-ROM loaded, or a remote machine and depot combination. The default source type is directory. The syntax is:

[host][:][/directory]

The remote host can be specified by its host name, domain name, or Internet address. The absolute path to the remote depot follows, separated by a colon with no spaces. The colon is required when both a host and directory are specified. The directory path must be absolute. For example, to specify a remote machine and depot combination:

swperf:/var/spool/sw

-t temp_directory_path

Specifies a temporary directory to use during the swgettools process. An absolute pathname is required. By default /var/tmp is used. The temporary directory must exist and must have at least 2 MB of free disk space for swgettools to succeed. (You can use the bdf temp_directory_path command to determine if the directory has adequate space.)

RETURN VALUES

The swgettools command returns:

0: Successful completion
1: Usage incorrect
2: Error during execution

EXAMPLES

To install the new SW-DIST product from CD-ROM media at /mnt/cdrom_depot:

cp /mnt/cdrom_depot/catalog/SW-GETTOOLS/pfiles/swgettools /var/tmp 
/var/tmp/swgettools -s /mnt/cdrom_depot 

To install the new SW-DIST product from tape media at /dev/rmt/0m:

cd /var/tmp 
tar -xvf /dev/rmt/0m catalog/SW-GETTOOLS/pfiles/swgettools 
cp /var/tmp/catalog/SW-GETTOOLS/pfiles/swgettools /var/tmp/swgettools 
rm -rf /var/tmp/catalog 
/var/tmp/swgettools -s /dev/rmt/0m 

To install the new SW-DIST from a remote depot on swperf at /var/spool/sw:

rcp swperf:/var/spool/sw/catalog/SW-GETTOOLS/pfiles/swgettools /var/tmp 
/var/tmp/swgettools -s swperf:/var/spool/sw 

AUTHOR

swgettools was developed by the Hewlett-Packard Company.

FILES

The swgettools command installs the following supporting files into four directories. These files are removed when the system is rebooted after the installation or update is complete.

/var/adm/sw/lbin: ~ 1 MB
/var/adm/sw/sbin: ~ 3 MB
/var/adm/sw/lib: ~ 6 MB
/usr/lbin/sw/bin: ~ 5 MB