Index Index for
Section 8
Index Alphabetical
listing for H
Bottom of page Bottom of
page		 

hwmgr(8)


NAME

  hwmgr, hardware - Command line interface for managing hardware components


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 commands.

  -cluster
      Perform the operation on every member of the cluster. This option is
      valid only when the system is a cluster member.

  -member host_name
      Perform the operation on the specified cluster member. This option is
      valid only when the system is a cluster member.

  -full
      Display extended details where they are provided.

  -nowrap
      Causes the command output to be truncated at 80 columns. See
      ENVIRONMENT VARIABLES for a description of the HWMGR_NOWRAP variable.

  -verbose
      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 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

  The hwmgr command provides a set of environment variable settings, which
  you can set in your preferred environment configuration file such as your
  .profile file as follows:

  HWMGR_DATA_FILE=pathname
      Use this variable to set the location of the main hwmgr command data
      file. The default path name is /etc/hwmgr/hwmgr.dat.

  HWMGR_DEBUG=TRUE | FALSE
      Use this variable to set debugging on or off. The default value is
      FALSE (off).

  HWMGR_HEXINTS=TRUE | FALSE
      Use this variable to set the display output to hexadecimal. The default
      value is FALSE (off).

  HWMGR_NOWRAP=TRUE | FALSE
      Causes the command output to be truncated at 80 columns rather than
      wrapped.	(See the -nowrap option described in the in OPTIONS section.)

  HWMGR_VERBOSE=TRUE | FALSE
      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 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 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


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 complete rebuild of
  the system and of all application databases that rely on device naming
  (such as the Logical Storage Manager).

  /sbin/hwmgr
      The executable image

  /etc/hwmgr/hwmgr.dat
      The main data file

  /etc/hwmgr/hwm_fibre.dat
      The data file for the Fibre Channel subsystem

  /etc/hwmgr/hwm_hotswap.dat
      The data file for the hot-swap subsystem

  /etc/hwmgr/hwm_hwc.dat
      The data file for the component subsystem

  /etc/hwmgr/hwm_name.dat
      The data file for the name subsystem

  /etc/hwmgr/hwm_scsi.dat
      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

Index Index for
Section 8
Index Alphabetical
listing for H
Top of page Top of
page