unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 install-sd(1M)						      install-sd(1M)
			   Hewlett-Packard Company



 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.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 install-sd(1M)						      install-sd(1M)
			   Hewlett-Packard Company



      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 >&gt&gt> \@/var/adm/sw/install-sd.root 2>&gt&gt>/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.




 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 install-sd(1M)						      install-sd(1M)
			   Hewlett-Packard Company



	   +	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 >&gt&gt> \@/var/adm/sw/install-sd.root 2>&gt&gt>/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.

 SEE ALSO
      sd(4), sd(5), update-ux(1M),

      Software Distributor Administration Guide, available at
      http://docs.hp.com.










 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000