unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



hwmgr(8)							     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 subsys-
  tems 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 multi-
       ple 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 com-
  mands	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 com-
       ponents,	powering off components, and deleting components.

  You can abbreviate hwmgr commands and	parameters to the fewest unique	char-
  acters.

  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 <&lt;errno.h>&gt;.

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