NAME

setld − system software subset utility

SYNTAX

setld [ dir ] −d subset ... 
setld [ dir ] −a loc-code subset ... 
setld [ dir ] −i [ subset ... ]
setld [ dir ] −c subset message
setld [ dir ] −l loc-code
setld −x loc-code
setld [ dir ] −v [ subset ... ]

DESCRIPTION

The setld utility enables superusers to load, unload, and inventory software subsets.

The optional dir argument may be specified to direct setld to install subsets to a file hierarchy starting somewhere other than the default hierarchy which begins at /. 

The location code, loc-code, is used by setld to determine which media device to use.  Valid location codes include the following, where ? refers to the logical unit number of the device:

/dev/rmt?hor

/dev/rmt?lmagnetic tapes

/mntra60 disk drives

hostname:for network installations

Note that location code for ra60 drives is a directory and that setld assumes that the ra60 installation media is mounted there.

OPTIONS

The following options are available with the setld utility:

−dRemoves files related to the named subset or subsets from the hierarchy.  For example, the following command removes the sccs software subset from the system hierarchy:

setld [path] -d ultsccs020

−aTransfers files related to the named subset or subsets from the installation media to the hierarchy.  The −a option requires an argument naming the input location from which the subsets are loaded.  For example, the following command loads the Pascal subset onto the hierarchy that has its root at /mnt:

setld /mnt −a /dev/rmt0h ultpascal020

The sequence of commands

fsck /dev/rra3g
mount /dev/ra3g /mnt
setld /mnt -a ultf77020 ultpascal020

will do the same from your ra60 pack mounted on logical unit number 3.

−iGives an inventory of all files in the named subset or subsets.  If no argument is given, setld Displays installed subsets in uppercase letters and uninstalled subsets in lowercase letters. For example, the following command lists all files contained in the accounting software subset:

setld -i ultacct020

−cSends the specified reconfiguration message to the named subset. 

−lLoads any subset or subsets found on the installation media currently mounted at the named location.  For example, the following command loads a layered product from the named tape device:

setld −l /dev/rmt0h

A side effect of the −l option is to initialize the subsets databases for the product found on the media. None of the other setld options will be able to recognize the subsets in the product unless an initial −l has been performed. The ULTRIX installation performs the initial −l for the supported subsets.

−xLoads media images from the specified tape device to the current working directory.  For example, the following command loads all media images found on the device into the current working directory:

setld −x /dev/rmt0h

−vExecutes the IVP (Internal Verification Program) for layered product subsets.  Not all layered products have them. 

FILES

/usr/adm/bin/ready User Readiness Confirmation Program
/usr/adm/subsets/*.ctrl Subset Control Data Files
/usr/adm/subsets/*.image Subset Image Data Files
/usr/adm/subsets/*.inv Subset Inventory Data Files
/usr/adm/subsets/*.lk Lock File Specifying Subset Dependencies
/usr/adm/subsets/*.scp Subset Control Programs

RESTRICTIONS

The setld program does not permit the installation of subsets that which cannot not fit in the available disk space.

All NFS file systems should be dismounted before using setld with the −a, −d, and −l options.