setld(8)setld(8)Namesetld - 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 speci‐
fiers 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 opera‐
tion 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
distribution 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 infor‐
mation 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 sub‐
set 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 useful 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 "Do Not Worry, Be Happy" to the subset:
# setld-c UWSX11400 "Do Not 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 suc‐
cessfully. All other cases yield exit status of 1 for failed operations
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 argu‐
ments. 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 responsi‐
ble 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 manufacture
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 diag‐
nostic 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 pro‐
gram 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 sub‐
set. 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-mes‐
sage 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 corre‐
spond 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.
There is a sizing problem for subset subset. See error message from
fitset
Please refer to the error message produced by the utility on the stan‐
dard output. The subset named may require more disk space or inodes
than are available.
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 Alsokits(1), fitset(8), fverify(8)
Guide to Preparing Software for Distribution on ULTRIX Systems
setld(8)