hwmgr(8)hwmgr(8)NAME
hwmgr, hardware - Command line interface for managing hardware compo‐
nents
SYNOPSIS
/sbin/hwmgr [-help] command [subsystem] [parameters]
OPTIONS
The following options are used with many of the commands. Other options
are unique to the individual commands and are documented with the com‐
mands. Perform the operation on every member of the cluster. This
option is valid only when the system is a cluster member. Perform the
operation on the specified cluster member. This option is valid only
when the system is a cluster member. Display extended details where
they are provided. Causes the command output to be truncated at 80
columns. See ENVIRONMENT VARIABLES for a description of the
HWMGR_NOWRAP variable. Provide detailed information about the return
status of this command. You must not abbreviate the -verbose option.
To make the verbose operation default, define the environment variable
HWMGR_VERBOSE = TRUE as described in ENVIRONMENT VARIABLES.
DESCRIPTION
The hwmgr command enables you to manage hardware components and the
software subsystems that maintain information about the components. A
hardware component can be a storage peripheral, such as a disk or tape,
or a system component such as a CPU or a bus.
You can use the hwmgr command on either an individual system or on
clustered systems to manage hardware, gather information on system sta‐
tus, and diagnose problems. The hwmgr command provides the following
features: Provides a wide range of hardware management functions under
a single command. Enables you to manage (to a small extent) hardware
components that are not currently connected to your system but were
seen on a previous system boot. Enables you to manage hardware compo‐
nents that are connected to multiple systems in the cluster. Enables
you to propagate a management request to multiple members of a cluster.
The hwmgr command enables you to manage hardware components. The hwmgr
commands are organized into related groups and documented in the fol‐
lowing reference pages: hwmgr(8) - The hwmgr command overview. It also
describes options for configuring the environment variable settings for
the hwmgr command. hwmgr_get(8) - Commands that enable you to display
and set information about the system and its hardware components and
their attributes (or properties), such as the capacity of a hard disk
or the speed of a CPU. hwmgr_view(8) - Commands that display informa‐
tion about the status of the system and its hardware components. The
display output from each command organizes the data into a specific
format. hwmgr_show(8) - Commands that enable you to display informa‐
tion from specific hardware subsystems. hwmgr_ops(8) - Commands that
enable you to perform administrative tasks on hardware components, such
as scanning buses, locating components, powering off components, and
deleting components.
You can abbreviate some hwmgr command options and parameters to the
fewest unique characters.
For information on using the hwmgr command to hot-swap certain compo‐
nents, see olar_intro(5) and the Managing Online Addition and Removal
manual.
You can run some hwmgr commands using the SysMan Menu, and also monitor
component properties and attributes using the SysMan Station. You must
be superuser (root) to use the hwmgr command; however, you can assign
root privileges by using the Division of Privileges (DOP) command.
ENVIRONMENT VARIABLES
The hwmgr command provides a set of environment variable settings,
which you can set in your preferred environment configuration file such
as your file as follows: Use this variable to set the location of the
main hwmgr command data file. The default path name is
/etc/hwmgr/hwmgr.dat. Use this variable to set debugging on or off.
The default value is FALSE (off). Use this variable to set the display
output to hexadecimal. The default value is FALSE (off). Causes the
command output to be truncated at 80 columns rather than wrapped. (See
the -nowrap option described in the in OPTIONS section.) Use this
variable to set the hwmgr command to display verbose output by default.
This option can also be specified using the -verbose option on the com‐
mand line. The default value is FALSE (off).
Use the hwmgr view environment command option to display the current
values of the environment variables as follows: # /sbin/hwmgr view
environment HWMGR_DATA_FILE = "/etc/hwmgr/hwmgr.dat" HWMGR_DEBUG =
FALSE HWMGR_HEXINTS = FALSE HWMGR_NOWRAP = FALSE HWMGR_VERBOSE = FALSE
RESTRICTIONS
The following notes and restrictions apply: When working on a cluster,
if you do not specify an optional member name the operation defaults to
the local member. (Some command options require that you specify a mem‐
ber name.) Currently the locate component -id command is implemented
only for some SCSI disks, using the disk's activity indicator light
(LED). The following operations on the name subsystem are not sup‐
ported by all drivers: reload name unconfigure name unload name
ERRORS
The command returns an int with an errorno from <errno.h>.
FILES
The format of the hardware management data files is undocumented. You
must never manually change the content of the data files or the system
might not boot. Such problems might be unrecoverable, requiring a com‐
plete rebuild of the system and of all application databases that rely
on device naming (such as the Logical Storage Manager). The executable
image The main data file The data file for the Fibre Channel subsystem
The data file for the hot-swap subsystem The data file for the compo‐
nent subsystem The data file for the name subsystem The data file for
the SCSI subsystem
SEE ALSO
Commands: dop(8), dsfmgr(8), hwmgr_show(8), hwmgr_get(8), hwmgr_ops(8),
hwmgr_view(8), sysman(8), sysman_station(8)
Files: olar_config(4)
Misc: olar_intro(5)
Hardware Management, Managing Online Addition and Removal
hwmgr(8)