NAME

swgettools − Utility for retrieving the SD product from new SD media

SYNOPSIS

swgettools -s <source_media_location> [-t <temp_dir_location>]

DESCRIPTION

The swgettools command is used to install the SW-DIST product onto an existing system from new media. 
 
The swgettools command must first be loaded in a temporary directory on the host system from the new SD media using either cp, rcp, or tar depending on the format of the new SD media.  swgettools is located on the media in the catalog/SW-DIST/pfiles directory. 
 
It is then invoked with the appropriate command line options to load the new SW-DIST product from the new SD media onto the host system.  Once the new SW-DIST product is installed, it can be used to install the other software items from the new SD media.
 
The -s option is used to identify the location of the media containing the SW-DIST product.  The type of media is determined automatically by swgettools based on the location that is specified. The -t option specifies the temporary directory to use during the swgettools process.  By default /var/tmp is used. 

Options

The swgettools command supports the following options:

-s <source_media_location>
This argument is used to specify the source media location. 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.
 
All paths used in the <source_depot_location> argument must be absolute paths.  If <source_depot_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

-t <temp_directory>
The <temp_directory> is the temporary directory to use during the swgettools process.  An absolute pathname is required. By default /var/tmp is used. The temporary directory must exist. 

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-DIST/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-DIST/pfiles/swgettools
cp /var/tmp/catalog/SW-DIST/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-DIST/pfiles/swgettools /var/tmp
/var/tmp/swgettools -s swperf:/var/spool/sw

AUTHOR

swgettools was developed by the Hewlett-Packard Company. 

SEE ALSO

sd(4), sd(5), swacl(1M), swagentd(1M), swcluster(1M), swconfig(1M), swcopy(1M), swinstall(1M), swjob(1M), swlist(1M), swmodify(1M), swpackage(1M), swpackage(4), swreg(1M), swremove(1M), swverify(1M), update(1M), and the HP OpenView Software Distributor Administrator’s Guide and Managing HP-UX Software with SD-UX manuals. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996