 |
Index for
Section 8 |
|
 |
Alphabetical
listing for H |
|
 |
Bottom of
page |
|
hwmgr_view(8)
NAME
hwmgr_view - Displays information about the status of the system and its
hardware components
SYNOPSIS
/sbin/hwmgr view cluster
/sbin/hwmgr view devices [-dsf device-special-filename] [-category
hardware-category] [-member cluster-member-name] [-cluster]
/sbin/hwmgr view environment
/sbin/hwmgr view hierarchy [-id hardware-component-id [-instance
component-instance]] [-member cluster-member-name]
/sbin/hwmgr view timestamps [-reverse] [-a timestamp-attribute...] [-a
timestamp-attribute=time] [-id hardware-component-id] [-category hardware-
category] [-member cluster-member-name] [-cluster]
/sbin/hwmgr view transaction [-member cluster-member-name] [-cluster]
OPTIONS
The following options are available:
view cluster
Displays information on the state of each cluster member. This command
is useful only in a cluster environment.
view devices
Displays all devices. All devices on the local host are returned by
default, unless you also specify one of the following options:
-category hardware-category
Specifies a hardware category, such as disk or tape on which to
perform the operation. Use the hwmgr get catergory command option
to display a list of available devices.
-dsf device-special-filename
Specifies the device special file for a particular device. You can
obtain the device special file name by using the hwmgr show comp
-full command option (see the DSF GROUP) or the hwmgr show scsi
command option.
-cluster
Specifies that the operation be performed cluster-wide. If this
option is not specified, data for the local host is returned.
-member cluster-member-name
Specifies the host name of a cluster member on which to perform the
operation.
For the purpose of this command, a device is considered to be any item
of hardware that has the dev_base_name attribute.
view env
Displays the internal Hardware Manager (hwmgr) environment variable
settings, which you can set in your environment configuration file such
as your .profile file. Refer to hwmgr(8) for information.
view hierarchy
Displays the current hardware component hierarchy. If no cluster member
name is specified this operation defaults to the local system.
-id hardware-component-ID
Displays the hierarchy from the specified component downwards.
Specify a hardware identifier (HWID).
-inst component-instance
Specifies an instance of a hardware component. Some components
might be in the hierarchy in more than one place. For example,
SCSI disks on a shared bus might be seen in the hierarchy under two
buses. Each entry for the component in the hierarchy is considered
a different instance.
-member cluster-member-name
Specifies the host name of a cluster member on which to perform the
operation.
The display hierarchy command displays the currently registered
hardware components which have been placed in the system hierarchy.
Components that have a flagged status are identified in the command
output by the following codes:
·
(!) warning
·
(X) critical
·
(-) inactive
Refer to the description of the hwmgr status component command option
for an explanation of these codes.
view timestamp
Displays time stamp attributes for a component, such as its
registration time or the time that the most recent event was posted.
You can specify the following additional options:
-reverse
Specifies that you want to display the data in reverse
chronological order
-a timestamp attribute=
Specifies that you want to display only timestamps that have the
stated attribute. Valid attributes are: registration_time,
start_stop_time, last_event_time, and access_state_change.
-atimestamp attribute=time
Specifies that you want to find a specific attribute and value
pair. Valid attributes are: registration_time, start_stop_time,
last_event_time, and access_state_change.
-id Specifies that you want to display timestamps for a particular
component. You must supply a HWID for the component, which you can
obtain by using the hwmgr show comp command
-categoryhardware-category
Specifies that you want to display timestamps for a particular
category of component. You can obtain a list of categories that are
available on the system by using the hwmgr get category command
-membercluster-member-name
Specifies the cluster member on which you want to perform the
operation.
-cluster
Specifies that you want to perform the operation on all members of
the cluster
view transaction
Displays information on the transactions that the hardware management
kernel code uses to perform some requests, including the status of:
·
The current hardware management transactions, if any
·
The last hardware management transaction that was completed
DESCRIPTION
The commands described in this reference page are a subset of the command
options available from the hwmgr utility. See hwmgr(8) for an overview of
the commands.
Use the hwmgr view command option to display information about the status
of the system and its hardware components. Refer to the following pages for
information on related commands:
· hwmgr_show(8) - Describes commands that enable you to display
information from hardware subsystems.
· hwmgr_get(8) - Describes commands that enable you to display (get) or
configure (set) component attributes and identify component category
names.
· hwmgr_ops(8) - Describes commands that enable you to perform
administrative tasks on hardware components, such as scanning buses,
locating components, powering off components, and deleting components.
See the System Administration manual for more information on component
names and device special files and a definitive list of the supported
device names. You can run some hwmgr commands directly from the SysMan
Menu. You can also monitor many properties and attributes of components by
using the the SysMan Station GUI.
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 might require
that you specify a member name, but in general it is an option.
ERRORS
The command returns an int with an errorno from <errno.h>.
EXAMPLES
These examples have been reformatted for ease of reference. The actual
formatted output from commands might be slightly different.
1. If your system is a member of a cluster, use the hwmgr utility to send
hardware management requests to any node in the cluster. Use the
following command to determine the current state of each member of the
cluster:
# /sbin/hwmgr view cluster
Member ID State Member HostName
--------- ----- ---------------
1 UP rene (localhost)
31 UP witt
24 UP freu
10 UP rogr
2. The following example displays devices on the system:
# /sbin/hwmgr view devices
HWID: Device Name Mfg Model Location
-------------------------------------------------------------------
4: /dev/kevm
29: /dev/disk/floppy0c 3.5in floppy fdi0-unit-0
32: /dev/disk/dsk1c DEC RZ26L (C) DEC bus-0-targ-1-lun-0
36: /dev/disk/dsk4c DEC RZ1DF-CB (C) DEC bus-0-targ-11-lun-0
45: /dev/disk/dsk3c COMPAQ HB00931B93 bus-0-targ-6-lun-0
46: /dev/disk/cdrom1c DEC RRD47 (C) DEC bus-0-targ-4-lun-0
64: /dev/dmapi/dmapi
66: /dev/disk/dsk16c COMPAQ HB00931B93 bus-0-targ-3-lun-0
The information shown in the output is as follows:
HWID
The cluster-wide unique hardware identifier (integer) assigned to
the device
Device Name
The device special file name for the device
Mfg The manufacturer of the device, if provided
Model
The vendor's model number, as shown on the device or its enclosure
Location
The physical location of the device as defined by the operating
system
In the preceding example, no tape device is present and the following
command returns no data:
# /sbin/hwmgr view devices -cat tape
3. The following example displays all devices on a cluster:
# /sbin/hwmgr view devices -cluster
HWID: Device Name Mfg Model Host Location
--------------------------------------------------------
3: /dev/kevm jully
28: /dev/disk/floppy0c 3.5in floppy jully fdi0-unit-0
40: /dev/disk/dsk0c DEC RZ28M (C)DEC jully bus-0-targ-0-lun-0
41: /dev/disk/dsk1c DEC RZ28L-AS (C)DEC jully bus-0-targ-1-lun-0
42: /dev/disk/dsk2c DEC RZ28 (C)DEC jully bus-0-targ-2-lun-0
43: /dev/disk/cdrom0c DEC RRD46 (C)DEC jully bus-0-targ-6-lun-0
44: /dev/disk/dsk3c DEC RZ28M (C)DEC phoey bus-1-targ-1-lun-0
45: /dev/disk/dsk4c DEC RZ28L-AS (C)DEC jully bus-1-targ-2-lun-0
45: /dev/disk/dsk4c DEC RZ28L-AS (C)DEC phoey bus-1-targ-2-lun-0
46: /dev/disk/dsk5c DEC RZ29B (C)DEC jully bus-1-targ-3-lun-0
46: /dev/disk/dsk5c DEC RZ29B (C)DEC phoey bus-1-targ-3-lun-0
47: /dev/disk/dsk6c DEC RZ28D (C)DEC jully bus-1-targ-4-lun-0
47: /dev/disk/dsk6c DEC RZ28D (C)DEC phoey bus-1-targ-4-lun-0
48: /dev/disk/dsk7c DEC RZ28L-AS (C)DEC jully bus-1-targ-5-lun-0
48: /dev/disk/dsk7c DEC RZ28L-AS (C)DEC phoey bus-1-targ-5-lun-0
49: /dev/disk/dsk8c DEC RZ1CF-CF (C)DEC jully bus-1-targ-8-lun-0
49: /dev/disk/dsk8c DEC RZ1CF-CF (C)DEC phoey bus-1-targ-8-lun-0
50: /dev/disk/dsk9c DEC RZ1CB-CS (C)DEC jully bus-1-targ-9-lun-0
.
.
.
4. The following command enables you to display device information about
a particular component by specifying its device special file:
# /sbin/hwmgr view devices -dsf /dev/disk/cdrom0
HWID: DSF Name Mfg Model Location
--------------------------------------------------------
31: /dev/disk/cdrom0c DEC RRD47(C)DEC bus-0-targ-4-lun-0
5. The following example command displays the component hierarchy:
# /sbin/hwmgr view hierarchy
HWID: Hardware component hierarchy
----------------------------------------------
1: platform AlphaServer 800 5/500
2: cpu CPU0
4: bus pci0
5: scsi_adapter isp0
6: scsi_bus scsi0
18: disk bus-0-targ-0-lun-0 dsk0
19: disk bus-0-targ-4-lun-0 cdrom0
20: graphics_controller trio0
8: bus eisa0
9: serial_port tty00
10: serial_port tty01
11: parallel_port lp0
12: keyboard PCXAL
13: pointer PCXAS
14: fdi_controller fdi0
15: disk fdi0-unit-0 floppy0
16: network tu0
17: network tu1
If a component has a status other than good, a status code appears
next to its entry in the command output, and the following code
definition string is appended to the header: (!) warning (X) critical
(-) inactive (see -status).
6. The following example displays the hwmgr command environment variable
settings:
# /sbin/hwmgr view env
HWMGR_DATA_FILE = "/etc/hwmgr/hwmgr.dat"
HWMGR_DEBUG = FALSE
HWMGR_HEXINTS = FALSE
HWMGR_NOWRAP = FALSE
HWMGR_VERBOSE = FALSE
7. The following example displays all timestamps for all hardware
components registered on a small standalone system:
# hwmgr view timestamps
HWID: Component Attribute Name Hostname Time occurred
------------------------------------------------------------
1: AlphaServer 80 registration_time cy1.k3. time
2: CPU0 registration_time cy1.k3. time
3: kevm registration_time cy1.k3. time
4: pci0 registration_time cy1.k3. time
5: pci0slot5 registration_time cy1.k3. time
7: pci0slot6 registration_time cy1.k3. time
9: pci0slot7 registration_time cy1.k3. time
(truncated)
In the preceding output, the time is displayed as weekday month date
HH:MM:SS year. For example: Sat May 15 14:42:18 1999.
8. The following example displays the transaction information for the
local host:
# /sbin/hwmgr view trans
hardware management transaction status
-----------------------------------------------------------
there is no active transaction on this system
the last transaction initiated from this system was:
transaction = general tx lock
proposal = 3835
sequence = 0
status = 0
the last transaction processed by this system was:
transaction = general tx lock
proposal = 3835
sequence = 0
status = 0
proposal last status success fail
---------------------------- ----------- ------- -------
Lock member/ 3847 0 85 0
Modify CDB/ 3838 0 4 0
Read CDB/ 3834 0 1 0
No operation/ 3835 0 89 0
Change name - lock/ 3836 0 0 0
Change name - commit/ 3837 0 0 0
Locate/ 3832 0 0 0
Scan/ 3801 0 0 0
Unconfigure - confirm/ 3933 0 0 0
Unconfigure - commit/ 3934 0 0 0
Delete - confirm/ 3925 0 0 0
Delete - commit/ 3926 0 0 0
Redirect - confirm/ 3928 0 0 0
Redirect - commit1/ 3929 0 0 0
Redirect - commit2/ 3930 0 0 0
Refresh - lock/ 3937 0 0 0
Change basename/ 3938 0 10 0
Unindict/ 3841 0 0 0
Indict/ 3840 0 0 0
FILES
See hwmgr(8) for more information.
SEE ALSO
Commands: dop(8), dsfmgr(8), hwmgr_show(8), hwmgr_get(8), hwmgr_ops(8),
sysman(8), sysman_station(8)
Files: olar_config(4).
Misc: olar_intro(5).
System Administration, Managing Online Addition and Removal
|
Index for
Section 8 |
|
|
Alphabetical
listing for H |
|
 |
Top of
page |
|