 |
Click this button to go to the index for this section. |
setld(8)
NAME
setld - software subset management utility
SYNOPSIS
/usr/sbin/setld [ -D root-path ] -l location [ subset... ]
/usr/sbin/setld [ -D root-path ] -d subset...
/usr/sbin/setld [ -D root-path ] -i [ subset... ]
/usr/sbin/setld [ -D root-path ] -v subset...
/usr/sbin/setld [ -D root-path ] -c subset message
/usr/sbin/setld [ -D root-path ] -x location [ subset... ]
DESCRIPTION
The setld command is an interactive program for installing and managing
software subsets. Software products are organized into subsets which may be
loaded, deleted, inventoried, and configured. The load operation reads
software from disk, tape, CD-ROM, or an Internet installation server.
The setld 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 the distribution. This
location can be the name of a directory, a device special file name, or the
name of a remote installation server. The specified location determines
the type of media to be used. Valid location specifiers include the
following:
/dev/rmt0h Magnetic tape on tape unit 0
/mnt/ALPHA/BASE Disk distribution in the /mnt/ALPHA/BASE directory
hostname: Remote distribution from server hostname
The subset argument specifies the name of a subset on which an operation is
to be performed. Subset names are strings of seven or more characters used
to uniquely identify subsets, for example, OSFXMAIL100.
The message argument specifies a string to be sent to the subset control
program for subset, to configure the subset.
FUNCTION KEYS
-l Loads software from distribution mounted on location. If no subset is
specified, a menu of optional subsets available on the distribution is
presented. Mandatory subsets found on the distribution are listed but
not offered for selection. Any subset or subsets chosen from the menu
are then loaded on the system. If a subset is specified, only that
subset is loaded.
-d Deletes each subset from the system.
Subsets can be marked during manufacture so that they cannot be
deleted. Any attempt to delete such subsets will generate an
appropriate diagnostic message.
If a subset being deleted is required by other subsets installed on
the system, those other subsets are listed and the user is asked to
confirm that the target subset is to be deleted.
-i Inventories the system or any specified subset. If no subset is
specified, the state of the system is listed on standard output in
three columns. The first column gives the subset name. The second
column lists the status of that subset: installed if the subset is
currently installed, corrupt if the subset failed to install
correctly, incomplete 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.
If subset arguments are present, the names of the files making up the
contents of each named subset are listed. Named subsets do not need
to be currently installed for this option to display their contents.
-v Checks the existence of the installed subset. Then, if the subset is
provided with an installation verification program (IVP), the IVP is
executed.
To verify the files of a specific subset, use the fverify(8) command.
The fverify(8) command reports missing files and inconsistencies in
file size, checksum, user ID, group ID, permissions, and file type.
-c Configures one subset, passing the configuration message message to
the subset control program.
-x Extracts subsets from the distribution media mounted on location. If
you specify no subset arguments, setld displays a menu of subsets on
the distribution. Subsets chosen from this menu are extracted.
If you specify subset arguments, setld extracts only the subsets
specified.
FLAGS
-D root-path
Specify root-path as the root directory for an operation. The default
root directory is / for all operations except -x. The default for -x
is the current directory. If this option is specified, setld operates
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 OSFXMAIL100 subset from tape unit 2:
# setld -l /dev/rmt2h OSFXMAIL100
Load the OSFXMAIL100 subset to an offline system rooted at /mnt from tape
unit 2:
# setld -D /mnt -l /dev/rmt2h OSFXMAIL100
Load the OSFXMAIL100 subset to an offline system rooted at /mnt from
installation server mumbly:
# setld -D /mnt -l mumbly: OSFXMAIL100
Load the OSFXMAIL100 subset to an offline system rooted at /mnt from a disk
distribution in /mnt2/ALPHA/BASE:
# setld -D /mnt -l /mnt2/ALPHA/BASE OSFXMAIL100
Delete the OSFXMAIL100 and OSFSYSV100 subsets:
# setld -d OSFXMAIL100 OSFSYSV100
Delete OSFXMAIL100 and OSFSYSV100 subsets from the offline system rooted at
/mnt:
# setld -D /mnt -d OSFXMAIL100 OSFSYSV100
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
/mnt:
% setld -D /mnt -i
Display the contents of the OSFXMAIL100 subset:
% setld -i OSFXMAIL100
Checks for the existence of the OSFCLINET100 subset on the running system:
# setld -v OSFCLINET100
Send the configuration message REPORT to the OSFXMIT100 subset:
# setld -c OSFXMIT100 REPORT
Extract subsets from the distribution on tape unit 0 into the current
directory:
# setld -x /dev/nrmt0h
Extract subsets from the disk distribution in /mnt/ALPHA/UNSUPPORTED into
/usr/bigdisk:
# setld -D /usr/bigdisk -x /mnt/ALPHA/UNSUPPORTED
RETURN VALUES
The exit status from setld is 0 if the operation requested was performed
successfully. All other cases yield exit status of 1 for failed operations
on mandatory subsets and greater than 1 for failed operations on optional
subsets.
ERRORS
-c can be used by super-user only
The setld command was entered by a non-root user with one of the root-only
function keys. The only setld function nonprivileged users can use is -i.
error in Args()
This message is displayed if setld cannot understand the command line
arguments. It is always preceded by a usage message or another diagnostic.
Temp directory /usr/tmp/stltmpXXXXXX already in use
This message is displayed if the temporary directory that setld would
create for itself already exists. Run setld again.
Cannot create directory dir
The directory dir which is needed for setld to operate correctly could not
be created. This error 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
on the system.
subset: missing control program, cannot configure.
An attempt is being made to configure subset but the program responsible
for performing the configuration 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 function key is not installed
on the system.
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.
ReadCtrlFile(): filename.ctrl is incomplete
Either the control file named in the error message is empty or it names one
or more attributes with no values specified.
setld: Sorry, You may not delete the description (subset) subset
The indicated subset, used as an argument with the -d option, was marked
during manufacture as a subset that cannot be deleted. In this case, the
subset cannot be removed from the system by setld.
subset: deletion declined by subset control program
The subset named in the error message cannot be deleted because its subset
control program has determined that the subset should not be deleted.
Depending on the individual subset control program, this message can also
be seen with a diagnostic issued directly from the subset control program.
Consult the documentation accompanying the product.
Installation declined by subset control program
description (subset) will not be loaded.
The subset named in the error message cannot be installed because its
subset control program has determined that the subset should not be loaded.
Depending on the individual subset control program, this message can also
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 setld with the -l, -u, or -x function key. 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 error can indicate a faulty
distribution. Try the operation again.
subset: extract checksum error
A checksum error was detected in the extracted copy of subset. This error
can indicate a transient tape subsystem error. Check the error log and
retry the operation.
Error contacting server hostname: error-message
An 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/nrmtnh
The named device special file either does not exist or is not a character
special file. Remake the file with MAKEDEV(8) and try the operation again.
subset: Unknown subset
A subset argument that was specified with the -i function key 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
/var/adm/smlogs/setld.log Logfile for setld transactions
The following files are relative to root-path:
usr/.smdb./*.inv Subset inventory files
usr/.smdb./*.ctrl Subset control files
usr/.smdb./*.scp Subset control programs
usr/.smdb./*.lk Subset installed lock files
usr/.smdb./*.dw Subset corrupt lock files
RELATED INFORMATION
Commands: kits(1), fitset(8), fverify(8)
File formats: stl_comp(4), stl_ctrl(4), stl_image(4), stl_inv(4),
stl_scp(4)
Guide to Preparing Product Kits