Content-type: text/html
Man page of setld
setld
Section: Maintenance Commands (8)
Index
Return to Main Contents
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
delim off
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- FUNCTION KEYS
-
- FLAGS
-
- RESTRICTIONS
-
- EXAMPLES
-
- RETURN VALUES
-
- ERRORS
-
- FILES
-
- RELATED INFORMATION
-
This document was created by
man2html,
using the manual pages.
Time: 02:40:43 GMT, October 02, 2010