install-sd(1M)

NAME

install-sd — utility used to install the Software Distributor (SD) product

SYNOPSIS

install-sd -s source_depot_location

DESCRIPTION

The install-sd command installs the SD product onto a workstation or server. You may need to install SD if the SD currently on your system is unusable, or if you want to install a newer version of SD. This command also installs any SD patches that exist in the source depot.

Prerequisites

The install-sd command and an accompanying swagent.Z file require at least 2 MB of free space in the /var/tmp directory. If there is not enough space in the temporary directory install-sd will fail.

Options

The install-sd command supports the following option:

-s source_depot_location

Specifies the source media location, where source_depot_location is an absolute path. Possible media locations are:

A local directory.
A CD-ROM mount point that has an SD media CD-ROM loaded.
A remote machine (or host) and depot combination.

If source_depot_location is a remote machine and depot combination, specify the machine name, a colon, then the absolute path to the remote depot. The syntax is:

[machine_name][:][/depot_path]

For example:

swtest:/var/spool/sw

Replacing an Unusable Version of SD

If the SD on the target system is unusable, you must first load the install-sd utility and an accompanying swagent.Z file onto your system into /var/tmp, then use install-sd to re-install SD.

The install-sd utility ships in the catalog/SW-DIST/pfiles directory. Use cp or rcp (depending on whether the new software is on CD or a remote system in a software depot) to load install-sd onto your system.

For example, to load install-sd from a local CD-ROM mounted at /SD_CDROM into /var/tmp:

1) Copy install-sd onto your system from the CD-ROM:

cp /SD_CDROM/catalog/SW-DIST/pfiles/install-sd /var/tmp 

2) Copy the swagent.Z file from the CD-ROM:

cp /SD_CDROM/catalog/SW-DIST/pfiles/swagent.Z /var/tmp 

3) Make install-sd executable:

chmod +x /var/tmp/install-sd 

4) Execute install-sd:

/var/tmp/install-sd -s /SD_CDROM 

The SW-DIST product will then install itself onto your system from the CD-ROM.

Getting a Newer Version of SD

If you want to install a newer version of SD on your system and /usr/sbin/install-sd is not yet on your system, use this procedure:

1) Type on the command line:

/usr/sbin/swinstall -r -s  source_depot_location \
     SW-DIST.SD-UPDATE > \@/var/adm/sw/install-sd.root 2>/dev/null 

2) Install the newer SD:

/usr/sbin/install-sd -s source_depot_location
where source_depot_location is the absolute path to the depot or media containing the newer version of SD.

RETURN VALUES

The install-sd command returns:

0: Successful completion
1: Error during execution

DIAGNOSTICS

Standard Output

An install-sd session writes messages for significant events. These include:

Begin session and end session messages.
Major task messages.

Standard Error

An install-sd session writes messages for all WARNING and ERROR conditions to stderr.

Logging

An install-sd session logs detailed events to the install-sd log file located at:

/var/adm/sw/install-sd.log

EXAMPLES

To load install-sd from a local CD-ROM mounted at /SD_CDROM into /var/tmp:

cp /SD_CDROM/catalog/SW-DIST/pfiles/install-sd /var/tmp 
cp /SD_CDROM/catalog/SW-DIST/pfiles/swagent.Z /var/tmp 
chmod +x /var/tmp/install-sd 
/var/tmp/install-sd -s /SD_CDROM 

To install a newer version of SD onto your system from the /var/spool/sw depot on swtest (when /usr/sbin/install-sd is not yet on your system):

/usr/sbin/swinstall -r -s swtest:/var/spool/sw \ 
     SW-DIST.SD-UPDATE > \@/var/adm/sw/install-sd.root 2>/dev/null 
/usr/sbin/install-sd -s swtest:/var/spool/sw 

AUTHOR

install-sd was developed by the Hewlett-Packard Company.

FILES

/usr/sbin/install-sd: Location of the install-sd command.
/var/adm/sw/install-sd.log: Location of the install-sd log file.