 |
Index for
Section 8 |
|
 |
Alphabetical
listing for S |
|
 |
Bottom of
page |
|
setld(8)
NAME
setld - Software subset management utility
SYNOPSIS
/usr/sbin/setld [-D root-path] -l location [subset...]
/usr/sbin/setld [-D root-path] [-f] -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...]
/usr/sbin/setld [-D root-path] -h
/usr/sbin/setld [-D root-path] [-m member_ID] -C subset [subset...]
/usr/sbin/setld [-D root-path] [-m member_ID] -Z subset [subset...]
OPTIONS
-l location [subset...]
Loads software from distribution media mounted on location.
·
If you specify subset arguments, only those subsets are loaded.
·
If you do not specify subset arguments, a menu is displayed that
lists the optional subsets available on the distribution; mandatory
subsets are listed but cannot be selected. Selected subsets are
loaded onto the system.
-d subset...
Deletes each subset from the system.
Subsets can be marked during manufacture so that they cannot be
deleted. If you try to delete such subsets, an appropriate diagnostic
message is generated.
If a subset being deleted is required by other subsets installed on the
system, those subsets are listed and you must confirm that the target
subset is to be deleted.
You cannot use the -d option to delete subsets extracted with the -x
option.
-i [subset...]
Displays the inventory status of the system or any specified subset. If
you do not specify a subset, the system state is listed on standard
output in three columns: Subset, Status, and Description. Subset
status may be one of the following:
installed
The subset is currently installed.
corrupt
The subset failed to install correctly.
incomplete
Information in the subset control file is incomplete.
blank
The subset is not currently installed.
If you specify subset arguments, the names of the files in each named
subset are listed. Named subsets are listed with their contents whether
they are installed or not.
You cannot use the -i option to list subsets extracted with the -x
option.
-v subset...
Verifies the existence of the installed subset. If the subset exists,
the setld utility verifies the size and checksum information for each
file in the subset.
This option also executes any V phase processing included in the subset
control program, except during the installation process.
Use the fverify command to verify the files of a specific subset. The
fverify command reports missing files and inconsistencies in file size,
checksum, user ID, group ID, permissions, and file type.
You cannot use the -v option to check the existence of subsets
extracted with the -x option.
-c subset message
Configures one subset, passing the message to the subset control
program.
-x location [subset...]
Extracts subsets from the distribution media mounted on location.
Subsets extracted with this option are not loaded onto your system but
are copied in their exact format, compressed or not, from the
distribution media. If you specify the optional -D root-path operand,
the subsets are copied to root-path. Otherwise, the subsets are copied
to the current directory.
Because these subsets are not installed, you cannot use the -d, -i, or
-v options to delete, inventory, or check the existence of extracted
subsets in the directory to which they are copied.
The -x option is used primarily by the Remote Installation Services
utility to set up RIS areas.
·
If you specify subset arguments, only the specified subsets are
extracted.
·
If you do not specify subset arguments, a menu is displayed that
lists the subsets on the distribution media. Subsets chosen from this
menu are then extracted.
-f Forces the continuation of a delete operation despite receiving errors
from a subset control program (SCP).
-h Displays usage statements.
-C Runs the C_INSTALL (configure install) phase of the named software
subset's software subset control program (SCP) on the specified cluster
member. This option must be used in conjunction with the -m operand,
and is used for disaster recovery purposes only.
-Z Runs the C_DELETE (configure delete) phase of the named software
subset's SCP on the specified cluster member. This option must be used
in conjunction with the -m operand, and is used for disaster recovery
purposes only.
OPERANDS
[-D root-path]
Specifies root-path as the root directory for an operation.
·
If you specify the -D root-path operand, the setld command operates
on the software rooted at the specified directory (root-path).
·
If you do not specify the -D root-path operand, the default is root
( / ) for all operations except -x, when the default is the current
directory ( . ).
This optional operand is useful for installing software to offline
systems on removable media or dual-ported disk drives.
[-m member_ID]
Sets the cluster member ID for disaster recovery when a load or delete
operation fails on one or more members in a cluster. This option is
only valid with the -C and -Z options. If a member_ID is not
specified, the operation defaults to the current system. This operand
is not valid on nonclustered systems.
This operand is to be used for disaster recovery purposes only. It is
not the intended nor the supported method to remove or install software
on a cluster.
DESCRIPTION
The setld command is an interactive program for installing and managing
software subsets. Software products are organized into subsets that may be
loaded, configured, inventoried, and deleted. The load operation reads
software from disk, tape, CD-ROM, or a remote installation server.
The setld command is used to load and remove software subsets from single
systems or clustered systems; there is no difference in command syntax. The
setld command can be invoked from any member of a cluster to install or
remove software across the entire cluster.
The setld command also is used to extract the contents of installation
media onto a disk so that the disk can be used as the distribution media.
Extracted subsets are not loaded onto the system and you cannot use the -d,
-i, or -v options to delete, inventory, or check the existence of
extracted subsets in the directory to which they are copied.
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 can be similar to the
following examples:
/dev/tape/tape0h
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.
RESTRICTIONS
Do not try to install software into an NFS mounted file system.
You cannot use the -d option to delete subsets extracted with the -x
option.
You cannot use the -i option to list subsets extracted with the -x option.
You cannot use the -v option to check the existence of subsets extracted
with the -x option.
EXIT STATUS
0 The requested operation was successful.
1 The requested operation failed on a mandatory subset.
>1 The requested operation failed on an optional subset.
ERRORS
-x can be used by super-user only
You do not have root privileges and you tried to use the setld command with
the -x option, one of the root-only options. The -i option is the only
setld function available to non-privileged users.
error in Args()
The setld command cannot understand the command line arguments. This
message is always preceded by a usage message or another diagnostic.
Temp directory /usr/tmp/stltmpXXXXXX already in use
The temporary directory that setld creates for itself already exists. Run
setld again.
Cannot create directory dir
The setld command could not create the required directory dir. 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.
The subset argument to the -c option refers to a subset not installed on
the system.
subset: missing control program, cannot configure.
The setld command tried to configure subset, but the program needed to
performing the configuration is missing. Delete the subset and install it
again before trying the operation again.
subset: not currently installed, cannot delete
The subset argument to the -d option refers to a subset not installed on
the system.
ReadCtrlFile(): cannot find filename.ctrl
The setld command cannot read the control file filename.ctrl.
ReadCtrlFile(): filename.ctrl is incomplete
The control file filename.ctrl either is empty or it names attributes with
no values specified.
setld: Sorry, You may not delete the description
(subset) subset
The subset was marked during manufacture as a subset that cannot be
deleted; it cannot be removed from the system by the setld command.
subset: deletion declined by subset control program
The subset control program subset has determined that the subset should not
be deleted. Depending on the individual subset control program, this
message also can be seen with a diagnostic issued directly from the subset
control program. Consult the product's documentation.
Installation declined by subset control program
description (subset) will not be loaded.
The subset control program for subset has determined that the subset should
not be loaded. Depending on the individual subset control program, this
message also can be seen with a diagnostic issued directly from the subset
control program. Consult the product's documentation.
Tape Positioning Error
The setld command detected an error while positioning the tape for a read
operation with the -l or -x option. 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 while trying to extract subset from the
distribution.
Control Info Error on subset
The setld failed to access a control or inventory file or subset control
program while extracting subsets. This can indicate a faulty distribution.
Try the operation again.
subset: extract checksum error
The extracted copy of subset has a checksum error. This can indicate a
transient tape subsystem error. Check the error log and retry the
operation.
Error contacting server hostname: message
The setld command could not contact installation server hostname. The error
message provides more information.
Device location not supported for installations.
The setld command did not recognize the location specified on the command
line as a valid input location for a load (-l) or extract (-x) operation.
Cannot access /dev/ntape/tapeNh
The device special file /dev/ntapeNh either does not exist or is not a
character special file. Remake the file with the dsfmgr command and try the
operation again.
subset: Unknown subset
A subset argument to the -i option 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.
EXAMPLES
To load software subsets from tape unit 2:
setld -l /dev/tape/tape2h
To load the OSFXMAIL100 subset from tape unit 2:
setld -l /dev/tape/tape2h OSFXMAIL100
To load the OSFXMAIL100 subset from tape unit 2 to an offline system rooted
at /mnt:
setld -D /mnt -l /dev/tape/tape2h OSFXMAIL100
To load the OSFXMAIL100 subset from installation server houston to an
offline system rooted at /mnt:
setld -D /mnt -l houston: OSFXMAIL100
To load the OSFXMAIL100 subset from a disk distribution in /mnt2/ALPHA/BASE
to an offline system rooted at /mnt:
setld -D /mnt -l /mnt2/ALPHA/BASE OSFXMAIL100
To recover from the failure of a subset delete operation of the OSFXMAIL100
subset on member1 of a three member cluster and delete the subset on that
member:
setld -m member1 -Z OSFXMAIL100
To recover from the failure of a subset load operation of the OSFXMAIL100
subset on member1 of a three member cluster and load the subset on that
member:
setld -m member1 -C OSFXMAIL100
To delete the OSFXMAIL100 and OSFSYSV100 subsets from a single system:
setld -d OSFXMAIL100 OSFSYSV100
To delete OSFXMAIL100 and OSFSYSV100 subsets from the offline system rooted
at /mnt:
setld -D /mnt -d OSFXMAIL100 OSFSYSV100
To display the status of all subsets known to the system:
setld -i
To display the status of all subsets known to the offline system rooted at
/mnt:
setld -D /mnt -i
To display the contents of the OSFXMAIL100 subset:
setld -i OSFXMAIL100
To check for the existence of the OSFCLINET100 subset on the running
system:
setld -v OSFCLINET100
To send the configuration message REPORT to the OSFXMIT100 subset:
setld -c OSFXMIT100 REPORT
To extract subsets from the distribution on tape unit 0 into the current
directory:
setld -x /dev/ntape/tape0h
To extract subsets from the disk distribution in /mnt/ALPHA/stuff into
/usr/bigdisk:
setld -D /usr/bigdisk -x /mnt/ALPHA/stuff
FILES
/var/adm/smlogs/setld.log
Logfile for setld transactions
root-path/usr/.smdb./*.inv
Subset inventory files
root-path/usr/.smdb./*.ctrl
Subset control files
root-path/usr/.smdb./*.scp
Subset control programs
root-path/usr/.smdb./*.lk
Subset installed lock files
root-path/usr/.smdb./*.dw
Subset corrupt lock files
SEE ALSO
Commands:
kits(1), fitset(8), fverify(8), dsfmgr(8)
Files:
depord(4), stl_comp(4), stl_ctrl(4), stl_image(4), stl_inv(4),
stl_scp(4)
Documents:
Guide to Preparing Product Kits, Installation Guide
|
Index for
Section 8 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|