Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > S

swgettools(1M)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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

SEE ALSO

swinstall(1M), sd(5).

Managing HP-UX Software with SD-UX, Installing HP-UX 11.0 and Updating HP-UX 10.x to 11.0.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.