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

hwmgr(8)


NAME

  hwmgr, hardware, hotswap, hot-swap - Command line interface for managing
  hardware components


SYNOPSIS

  /sbin/hwmgr [-help] command [subsystem] [parameters]


DESCRIPTION

  The hwmgr command enables you to manage hardware components and the
  subsystems that maintain information about them. 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. Use the hwmgr utility to manage hardware components on
  either a single system or on a cluster.

  Use this utility for managing hardware, gathering information on system
  status, and diagnosing device problems. The hwmgr utility has 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 information about
       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 hwmgr commands and parameters to the fewest unique
  characters.

  You can run some hwmgr commands using the SysMan Menu, and also monitor
  device properties and attributes using the SysMan Station.  You must be
  superuser (root) to use the hwmgr utility, however you can assign root
  privileges by using the Division of Privileges (DOP) utility.

  Options

  The following options are used with many of the commands. Other options are
  unique to the individual commands and are defined 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.

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

  Environment Variables

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

  HWMGR_DATA_FILE=pathname
      Use this variable to set the location of the main hwmgr command data
      file.

  HWMGR_DEBUG=TRUE | FALSE
      Use this variable to set debugging on or off.

  HWMGR_HEXINTS=TRUE | FALSE
      Use this variable to set the display output to hexadecimal.

  HWMGR_NOWRAP=TRUE | FALSE
      Causes the display output to be truncated at 80 columns rather than
      wrapped.

  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.

  Use the view env command option to display the current values of the
  environment variables as follows:

       # /sbin/hwmgr view env
       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 a member name the
       operation defaults to the local member. Some command options require
       that you specify a member name, but in general it is an option.

    ·  Currently the locate component -id command is only implemented only
       for SCSI disks, using the disk activity indicator light (LED).

    ·  The following operations on the name subsystem are not supported by
       all drivers:

	 --
	 The reload name operation.

	 --
	 The unconfigure name operation.

	 --
	 The unload name operation.


ERRORS

  The command returns an int with an errorno from <errno.h>.


FILES

  Do not edit any of the following files:

  /sbin/hwmgr
      The executable image

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

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

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

  /etc/hwmgr/hwm_scsi.dat
      The data file for the CAM SCSI component 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)

  System Administration, Managing Online Addition and Removal

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