Monitor Description | Configuration Files
The SAS Mass Storage Adapter Monitor, dm_sas_adapter, monitors the HP Serial-Attached SCSI (SAS) Mass Storage Adapter on Itanium-based systems.
The dm_sas_adapter monitor employs the asynchronous event detection mode. If an error occurs on the HP SAS Mass Storage Adapter, the error details are passed to the monitor for an immediate analysis. If an error that warrants notification has occurred, the monitor generates an event and reports it to the Event Monitoring Service (EMS) framework. Depending on the event monitoring requests, the EMS framework alerts you about the event. Events include a description of the problem, its causes, and the recommended solution.
The monitor launches automatically when the system starts, ensuring that all supported SAS mass adapters are protected from undetected hardware failure.
Release HistoryThe dm_sas_adapter monitor is introduced in the HP-UX 11i v2 June 2006 release on Itanium-based systems only.
The dm_sas_adapter monitor supports the following:
Supported Products
The dm_sas_adapter monitor monitors the SAS_399490-001 HP SAS Mass Storage Adapter.
Special Requirements
None
Resource Path
The resource path for event monitoring is:
/adapters/events/sas_adapter
The resource path for status monitoring is:
/adapters/status/TL_adapter
Monitor Name
/usr/sbin/stm/uut/bin/tools/monitor/dm_sas_adapter
PSM State Control
You must use the set_fixed utility to change the state of the hardware resource to the UP state. The monitor does not support automatic state control. For information on the set_fixed utility, see the EMS Hardware Monitors User's Guide at:
http://docs.hp.com/en/diag/
Following sections describe the configuration files:
Startup Configuration FileThe name of the startup configuration file (.sapcfg) is:
/var/stm/config/tools/monitor/dm_sas_adapter.sapcfg
The monitor uses standard default monitor request entries.
Monitor Configuration FileThe name of the monitor configuration file (.cfg) is:
/var/stm/config/tools/monitor/dm_sas_adapter.cfg
The following table describes the default settings of the monitor configuration file:
| Event Qualification Entry | Settings |
| POLL_INTERVAL | Not applicable. This monitor employs the asynchronous event detection mode. |
| REPEAT_FREQUENCY | Not applicable. |
| SEVERITY_ACTION | Notify for all levels. |
As a Multiple-View (Predictive-enabled) hardware monitor, the REPEAT_FREQUENCY and SEVERITY_ACTION are no longer set in the .cfg file. Instead, they are now set in the .clcfg file, as described in the following section.
Default Client Configuration File
The name of the client configuration file (.clcfg) is:
/var/stm/config/tools/monitor/default_dm_sas_adapter.clcfg
Monitors containing the .clcfg are Multiple-View enabled monitors. The default_dm_sas_adapter.clcfg file applies to messages sent to all targets. You can use the monitor-specific .clcfg files to control the text sent to specific targets.
The HOST_ID tags in the .clcfg files control the system information reported as "Additional System Data" in the event messages. If you enable the HOST_ID tag in the .clcfg file, the corresponding information appears in the event message.
You can enable the HOST_ID tag for all the monitors. For information on the HOST_ID tag, see the Generic Monitor Data Sheet at:
http://www.docs.hp.com/en/diag/ems/emd_generic.htm
The DEV_ID tags in the .clcfg files control the monitor-specific information, that is reported in the "Component Data" field of the event messages. If a DEV_ID tag is enabled in the .clcfg file, the corresponding information appears in the event message.
The following table describes the DEV_ID tags available for this monitor:
| DEV_ID tag | Default | Text label |
| dev_pdev | On | Physical Device Path |
| dev_inq_vendor | On | Inquiry Vendor ID |
| dev_serial_num | On | Serial Number |
PSM Configuration File
The name of the PSM configuration file (.psmcfg) is:
/var/stm/config/tools/monitor/dm_sas_adapter.psmcfg
The following table describes the default settings of the PSM configuration file:
| Setting Name | Details |
|---|---|
| MONITOR_RESOURCE_NAME | /adapters/events/sas_adapter |
| PSM_RESOURCE_NAME | /adapters/status/TL_adapter |
| MONITOR_STATE_HANDLING | You must use the set_fixed utility to change the state of the hardware resource to the UP state. |
| DOWN_SEVERITY_THRESHOLD | Serious and Critical maps to DOWN. |