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)