Hello AIX and Tru64 Managers -
In Tru64 unix there is a command that will give an inventory of all the
subsets installed. This command is 'setld -i'. Dose anyone know what
the equivalent of this command is in AIX?
I've included the Tru64 man page on setld for the AIX people.
Thank you for your time.
setld(8)
setld(8)
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
fol-
lowing:
/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
argu-
ments. 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
sub-
set 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
dis-
tribution. 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
mes-
sage 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
--
H. Blakely Williford | Men never do evil so completely & cheerfully
Systems Programer/Administrator | as when they do it with religious conviction.
The Fuller Brush Company | - Blaise Pascal
Received on Wed May 19 1999 - 15:02:27 NZST