Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #446
Difficulty: Medium
The Large Hadron Collider experiments at CERN run on Scientific Linux.
True or False?
Linux & Unix Commands - Search Man Pages

setld(8) [osf1 man page]

setld(8)						      System Manager's Manual							  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
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. 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 diagnos- tic 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. 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: The subset is currently installed. The subset failed to install cor- rectly. Information in the subset control file is incomplete. 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 con- tents whether they are installed or not. You cannot use the -i option to list subsets extracted with the -x option. Verifies the existence of the installed subset. The -v option also executes any V phase processing included in the subset control program, except during installation. 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. Configures one subset, passing the message to the subset control program. 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. Forces the continuation of a delete operation despite receiv- ing errors from a subset control program (SCP). Displays usage statements. 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 conjunc- tion with the -m operand, and is used for disaster recovery purposes only. 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
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. 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: Magnetic tape on tape unit 0 Disk distribution in the /mnt/ALPHA/BASE directory 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
The requested operation was successful. The requested operation failed on a mandatory subset. 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 but can also accompany messages generated by commands that are called by the setld command. 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 pro- gram, 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 dis- tribution. 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 sub- set 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
Logfile for setld transactions Subset inventory files Subset control files Subset control programs Subset installed lock files Subset sta- tus file used by the cluster rolling upgrade process SEE ALSO
kits(1), fitset(8), fverify(8), dsfmgr(8) depord(4), stl_comp(4), stl_ctrl(4), stl_image(4), stl_inv(4), stl_scp(4) Guide to Preparing Product Kits, Installation Guide setld(8)

Featured Tech Videos