Monitor Description | Configuration Files
The Emulex PCI-e Fibre Channel Adapter monitor, dm_fclp_adapter, monitors the fibre channel ports of the following Fibre Channel Emulex adapters on HP-UX systems:
The monitor employs asynchronous event detection. If an error occurs on any of the adapters, the error details are passed to the monitor for 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 Fibre Channel Emulex adapters are protected from undetected hardware failure.
Release History
The dm_fclp_adapter monitor is introduced in HP-UX 11i v2 June 2007 release on Itanium-based systems only.
Starting with the HP-UX 11i v3 release, the dm_fclp_adapter monitor supports the following on HP-UX 11i v3 systems:
Special Requirements
The following web sites contain the latest information on the driver and the Support Tools Manager (STM) versions required for the Fibre Channel host bus adapters:
For product support information:
http://itrc.hp.com
For documentation:
http://docs.hp.com
Resource Path
The resource path for event monitoring is:
/adapters/events/fclp_adapter
The resource path for status monitoring is:
/adapters/status/fclp_adapter
Monitor Name
/usr/sbin/stm/uut/bin/tools/monitor/dm_fclp_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 File
The name of the startup configuration file (.sapcfg) is:
/var/stm/config/tools/monitor/dm_fclp_adapter.sapcfg
The monitor uses the standard default monitor request entries.
Monitor Configuration FileThe 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 default client configuration file (.clcfg) file, as described in the following section.
Default Client Configuration File
The name of the default client configuration file is:
/var/stm/config/tools/monitor/default_dm_fclp_adapter.clcfg
Monitors containing the .clcfg are Multiple-View enabled monitors. The default_dm_core_hw.clcfg applies to messages sent to all targets. You can use the monitor-specific .clcfg files, such as, predictive_dm_core_hw.clcfg 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 monitors. For more 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 is: /var/stm/config/tools/monitor/dm_fclp_adapter.psmcfg
The following table describes the default settings of the PSM configuration file:
| Setting Name | Details |
|---|---|
| MONITOR_RESOURCE_NAME | /adapters/events/fclp_adapter |
| PSM_RESOURCE_NAME | /adapters/state/events/FC_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 map to DOWN |