Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

setld(8) [ultrix man page]

setld(8)						      System Manager's Manual							  setld(8)

Name
       setld - software subset management utility

Syntax
       /etc/setld [ -D root-path ] -l location [ subset...  ]

       /etc/setld [ -D root-path ] -d subset...
       /etc/setld [ -D root-path ] -i [ subset...  ]
       /etc/setld [ -D root-path ] -v subset...
       /etc/setld [ -D root-path ] -c subset message

       /etc/setld [ -D root-path ] -x location [ subset...  ]

Description
       The  command  is  used  for installing and managing software. Software is organized into subsets which may be loaded, deleted, inventoried,
       updated, verified and configured. The load and update operations read software from disks, tapes or from an Internet installation server.

       The command is also used to read the contents of an installation tape onto a disk so that the disk can be used as the distribution media.

       The location argument specifies the location of distribution.  This can be be either the name of a directory, a device special  file  name,
       or the name of a remote installation server. The specified location is used to determine the type of media to be used. Valid location spec-
       ifiers include the following:

	      /dev/rmt0h     Magnetic tape on tape unit 0

	      /mnt/VAX/BASE  Disk distribution in directory /mnt/VAX/BASE

	      hostname:      Remote distribution from server hostname

       The subset argument specifies the name of a subset on which an operation is to be performed. The subset names are strings of seven or  more
       characters used to uniquely identify subsets, for example,

       The message argument specifies a string to be sent to a subset control program to configure a subset.

Function Keys
       -l     Load software from distribution mounted on location.  If no optional subset is specified, a menu of subsets available on the distri-
	      bution is presented. Any subset chosen from the menu is then loaded on the system.  If an optional subset is  specified,	only  that
	      subset is loaded.

       -d     Delete  subset  from  the  system. Each subset named on the command line is removed from the system.  All files in each subset which
	      have not been modified since installation are unlinked.

	      Subsets can be marked by a vendor during manufacture so that they cannot be deleted.  Attempts to delete such subsets will  generate
	      an appropriate diagnostic.

	      If  a  subset  being deleted is required by other subsets installed to the system, these are listed and the user is asked to confirm
	      that the subset is to be deleted.

       -i     Inventory the system or any specified subset.  When no subset is specified, the state of the system is listed on standard output	in
	      three columns.  The first column gives the code for a subset known to the system. The second column lists the status of that subset.
	      The value for the status is if the subset is currently installed, if the subset failed to install correctly, if information  in  the
	      subset  control  file is incomplete, or blank if the subset is not installed.  The third column presents the textual description for
	      that subset.

	      When subset arguments are present, the names of the files which make up the contents of each subset are listed. The subset does  not
	      need to be currently installed for this option to display its contents.

       -v     Verify  each subset.  The existence of the subset is first checked. Then is used to verify the integrity of each file in the subset.
	      Verification errors and informational messages resulting from are logged to relative to root-path. If the subset is provided with an
	      installation verification program (IVP), the IVP is executed.

       -c     Configure subset, passing the configuration message message to the subset control program.

       -x     Extract  subsets from the distribution media mounted on location.  If you specify no subset arguments, displays a menu of subsets on
	      the distribution.  Subsets chosen from this menu are extracted.

       If you specify subset arguments, extracts only the subsets specified.

Options
       -D root-path
	      Specify root-path as the root directory for an operation. The default is / for all operations except -x.	The default for -x is  the
	      current directory.  If this option is specified, will operate on the software rooted at the specified directory. This option is use-
	      ful for installing software to offline systems on removable media or dual-ported disk drives.

Restrictions
       Do not attempt to install software into an NFS mounted file system.

Examples
       Load software subsets from tape unit 2:

	    # setld -l /dev/rmt2h

       Load the subset from tape unit 2:

	    # setld -l /dev/rmt2h UDTUUCP400

       Load the subset to an offline system rooted at from tape unit 2:

	    # setld -D /mnt -l /dev/rmt2h UDTUUCP400

       Load the subset to an offline system rooted at from installation server

	    # setld -D /mnt -l mumbly: UDTUUCP400

       Load the subset to an offline system rooted at from a disk distribution in

	    # setld -D /mnt -l /mnt2/RISC/BASE UDTUUCT400

       Delete the and subsets:

	    # setld -d UDTUUCP400 UDTCOMM400

       Delete and subsets from the offline system rooted at

	    # setld -D /mnt -d UDTUUCP400 UDTCOMM400

       Display the status of all subsets known to the system:

	    % setld -i

       Display the status of all subsets known to the offline system rooted at

	    % setld -D /mnt -i

       Display the contents of the subset:

	    % setld -i UDTUUCP400

       Verify the subset on the running system:

	    # setld -v ULTVAXC400

       Send the configuration message "Don't Worry, Be Happy" to the subset:

	    # setld -c UWSX11400 "Don't Worry, Be Happy"

       Extract subsets from the distribution on tape unit 0 into the current directory:

	    # setld -x /dev/nrmt0h

       Extract subsets from the disk distribution in into

	    # setld -D /usr/bigdisk -x /mnt/RISC/UNSUPPORTED

Return Values
       The exit status from is 0 if the operation requested was performed successfully. All other cases yield exit status of 1 for  failed  opera-
       tions on mandatory subsets and greater than 1 for failed operations on optional subsets.

Diagnostics
       -c can be used by super-user only
       The command was entered by a non-root user with one of the root-only function keys. The only function which will perform for non-privileged
       users is -i.

       error in Args()
       This message is displayed if cannot understand the command line arguments. It will always be preceded by a usage message or  another  diag-
       nostic.

       Temp directory /usr/tmp/stltmpXXXXXX already in use
       This message is displayed if the temporary directory that would create for itself already exists. Run again.

       Cannot create directory dir
       The directory dir which is needed for to operate correctly could not be created. This can happen if parts of the system are NFS-mounted but
       not root-mapped.

       error in Dirs()
       This message always accompanies the preceding two messages.

       subset: not currently installed, cannot configure.
       Occurs when subset is used as an argument to -c but subset is not installed to the system.

       subset: missing control program, cannot configure.
       An attempt is being made to configure subset but the program responsible for doing this is missing. Delete the subset and install it  again
       before retrying the operation.

       subset: not currently installed, cannot delete
       A subset specified as an argument with the -d switch is not installed on the system, it cannot be deleted.

       ReadCtrlFile(): cannot find filename.ctrl
       The control file named in the error message is not where it is expected to be.

       ReadCtrlFile(): cannot read filename.ctrl
       The control file named in the error message exists but cannot be read.

       setld: Sorry, You may not delete the description (subset) subset
       The subset in the error message which was used as an argument with the -d switch is a subset which was marked by its vendor during manufac-
       ture as a subset that cannot be deleted.  In this case, the subset cannot be removed from the system by

       subset: deletion declined by subset control program
       The subset named in the error message cannot be deleted because of the return status of the subset control program. This indicates that the
       subset  control	program  provided  with  this subset has determined that the subset should not be deleted. This message may be seen with a
       diagnostic issued directly from the subset control program.  Consult the documentation accompanying the product.

       Tape Positioning Error
       An error was detected while positioning the tape for a read operation while using with either the -l, -u, or -x switches. This can indicate
       a faulty tape or a transient tape subsystem error. Check the error log and try the operation again.

       Error Extracting subset
       An unrecoverable error has occurred when trying to extract a subset from the distribution.

       Control Info Error on subset
       An attempt to access a control or inventory file or subset control program has failed while extracting subsets.	This may indicate a faulty
       distribution. Try the operation again.

       subset: extract checksum error
       A checksum error was detected in the extracted copy of the subset subset. This may indicate a transient tape subsystem  error.	Check  the
       error log and retry the extract.

       Error contacting server hostname: error-message
       Attempt to contact installation server hostname failed. The error-message provides more information.

       Device location not supported for installations.
       The location specified on the command line was not recognized as a valid input location for a -l, -u, or -x operation.

       Cannot access /dev/nrmt?h
       The  device  special file /dev/nrmt?  either does not exist or is not a character special file.	Remake the file with and try the operation
       again.

       subset: Unknown subset
       A subset argument that was specified with the -i switch does not correspond to any subset known to the system. Check the command  line  for
       spelling errors.

       location/instctrl: no such file or directory
       The  disk  distribution	location  specified  on the command line does not point to a valid directory.  Check the command line for spelling
       errors.

Files
       Logfile for		   transactions

       Following files are relative to root-path:

       Subset inventory files
       Subset control files
       Subset control programs
       Subset installed lock files
       Subset corrupt lock files
       Update archive directory
       Update reference directory
See Also
       kits(1), fitset(8), frm(8), fverify(8), sysupd(8)
       Guide to Preparing Software for Distribution on ULTRIX Systems

																	  setld(8)
Man Page

Featured Tech Videos