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