hwmgr, hardware - Command line interface for managing
/sbin/hwmgr [-help] command [subsystem] [parameters]
The following options are used with many of the commands.
Other options are unique to the individual commands and
are documented with the commands. 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
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 status, 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 components 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 following 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 information
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 information 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 components, 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 [Toc] [Back]
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 command line. The default value is
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
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 member 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 supported by all drivers: reload name
unconfigure name unload name
The command returns an int with an errorno from <errno.h>.
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 complete 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 component subsystem The
data file for the name subsystem The data file for the
Commands: dop(8), dsfmgr(8), hwmgr_show(8), hwmgr_get(8),
hwmgr_ops(8), hwmgr_view(8), sysman(8), sysman_station(8)
Hardware Management, Managing Online Addition and Removal
[ Back ]