Sentry Software KM for PATROL Hardware Sentry User documentation

MS_HW_CONNECTOR application class and all of the objects and parameters monitored through this

as well as for reporting the PowerConsumption parameter value.

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Ma nua lly e nte r a de v ice powe r consum ption

One interesting way to exploit this information is to compare the PowerConsumption parameters of many different servers and see which ones (which brand) are the most energy wise. Knowing which type of servers consumes less energy can be an important decision factor when purchasing new servers.

W hile much attention has been paid to obtain the best accuracy possible in the power consumption estimation done by the KM, comparing an actual v alue (read from an electricity sensor) and an estimated v alue may lead to unex pected results.

In order to better understand the electricity bill, Hardware Sentry provides an Energy Usage report in kWh. Right-click the main hardware icon grouping the hardware components of a given server > KM

Commands > Reporting >

Energy Usage Report…

. Select a “daily” report for a several day period of time. The graph displayed in the PATROL Console shows the electricity that has been consumed by the device for each day. If you know the price of the kWh in your region, you can easily calculate the energy price for the server.

PowerC onsumption is ex pressed in W atts. It’s an instantaneous v alue, v ery much like a speed or a rate (megaby tes/ sec, e.g.). It represents how quickly the serv er is burning energy for its operation. The “Energy Usage” report is ex pressed in kW h (kilo W att hour). It represents the amount of energy consumed by the serv er in the specified interv al (hour or day ). The Energy Usage report in kW h is to the power consumption what distance is to speed:

Energy = Power x Time.

When it comes to lower the electricity bill, the very first step is to measure the current energy consumption. As Lord Kelvin put it: “If you cannot measure it, you cannot improve it." Then it is very interesting to observe what can have an impact on the power consumption of a given server. You can use the data collected by Hardware Sentry to correlate them with other KMs or external data. You may realize that the deployment of a specific application can have a significant impact of the electricity

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

consumption, because of its activity (an anti-virus program, for example).

Predicting Hardware Failures

Even though end-users expect the IT environment they rely on to be flawless, it is common knowledge that hardware components are inherently prone to failure. In most cases, electronic components work as expected or fail completely and it is rare to be able to observe such components degrade slowly over time. That’s why Hardware Sentry KM only reports the overall status for most object classes as simply

“okay” or “failed”.

However, some components are able to report their own degradation and warn the administrator of an imminent failure. Such components include: the processors (the more computation errors they detect and correct automatically, the more likely they will fail soon) the memory modules (an increasing number of fixed ECC errors means the module is nearing its end of life) the hard disks (many internal metrics are constantly analyzed by the disk itself to assess its own health and predict an imminent failure – this technology is standard and is called S.M.A.R.T.)

When such information is properly reported by the component, the instrumentation layer of the system itself, Hardware Sentry KM will trigger an event to warn the administrators that an imminent failure of a processor, a memory module or a physical disk is predicted.

In the console, double-click the PredictedFailure parameter of the processor, memory module or physical disk you are interested in. Their application classes are respectively

MS_HW_CPU ,

MS_HW_MEMORY or

MS_HW_PHYSICALDISK .

Se le cting the Pre dicte dFa ilure pa ra m e te r

A graph is displayed in the graph pane. If this parameter is equal to 1 and goes into alarm, the faulty hardware should be replaced.

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Recognizing Instrumentation Failures

Hardware Sentry KM does not “talk” directly to the hardware to assess its health. An instrumentation layer bridges the physical components and the software solution. The instrumentation layer can be a driver, a firmware, an API, an SNMP agent, a WBEM or WMI provider or an out-of-band management card with its own IP address. In 99% of the cases, the instrumentation layer is provided by the manufacturer along with the server.

Failures in the instrumentation layer itself do happen and it is important to discriminate these problems from actual hardware failures. System administrators will not take the same actions for an actual disk failure and for an SNMP agent crash, which in itself does not impact the availability and performance of the system.

Monitoring Connectors

The connection to each instrumentation layer is represented by an instance of the

MS_HW_CONNECTOR

class. The availability of the underlying technology is constantly verified and represented with the

Status parameter. When an instrumentation failure occurs, an alarm is triggered by the

instrumentation layer are taken OFFLINE. This alarm reveals a monitoring issue only, which must be handled by PATROL administrators.

The TestReport parameter can give further information as it indicates whether the test completed successfully or not.

Example

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Hardware Sentry is running on an HP Proliant server with HP Insight Management Agent.

Upon start up, Hardware Sentry detects the HP Insight Management Agent, and starts using the corresponding connector to discover the server hardware configuration and monitor the discovered devices.

Additionally, Hardware Sentry creates an icon in the PATROL Console representing the HP Insight

Management Agent - Server connector.

Every 2 minutes, its Status parameter is updated.

If, for some reason, the HP agent stops working, an alarm is raised on the Status parameter and the devices that were discovered through to this connector are taken offline.

Conne ctor Monitoring

This connector monitoring mechanism helps PATROL administrators detect hardware agent failures. It also provides a high monitoring accuracy by not confusing errors that are actually encountered by devices with errors stemming from a monitoring-tool failure.

When connectors are: automatically detected by Hardware Sentry, the connectors are grouped under an instance labeled

Detected Connectors.

manually selected – as for remotely monitored objects, the connectors are grouped under an instance labeled Selected Connectors.

To change the settings of connectors, right-click on Hardware > KM Commands > This System’s

Settings > Connection, Credentials and Connectors…

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Reporting

This section deals with the various ways Hardware Sentry KM for PATROL enables you to create and schedule reports on the data collected from monitored devices.

Hardware Inventory Reports

IT administrators often need complete information about the hardware health of the managed system.

Hardware Sentry can generate an instant hardware inventory report that lists all the hardware components monitored on the system/remote device. This list details the monitored objects, their parameters, thresholds, etc., and describes errors or problems encountered, the possible consequences, and the actions recommended to solve the issues, if any.

Administrators can for instance:

generate hardware inventory

schedule hardware inventory report

Instant Hardware Inventory Report

Because IT and virtualization technologies become more and more complex, administrators are now struggling to get a real hardware inventory and know exactly what is present on the machine they are working on. This information is however often required by the technical support of any hardware manufacturer.

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

To generate an hardware inventory report with Hardware Sentry:

1. right-click the Hardware icon > KM Commands > Reporting > Hardware Inventory. The following pane is displayed:

Ha rdwa re Inv e ntory Re port for a n e ntire sy ste m /de v ice

You can also generate a schedule hardware inventory report.

Scheduling Hardware Inventory Reports

Administrators can schedule automated generation of hardware inventory reports for the localhost and/ or any or all remote hosts monitored through it. The information retrieved as a text file can then be used by inventory tools. Because the information is up-to-date, administrators can easily find out if problems exist.

To schedule a hardware inventory report:.

User Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Right-click the Hardware icon > KM Commands > Reporting > Schedule Hardware

Inventory. The Hardware Inventory Scheduling wizard appears:

Sche dule Ha rdwa re Inv e ntory Re ports — W e lcom e

User Guide

100

Hardware Sentry KM for PATROL

Version 1.8.01

The next panel asks you to select the hosts and to schedule the report:

Sche dule Ha rdwa re Inv e ntory Re ports — Se le ction

Depending on the schedule selected, the following panels will appear:

Every hour: No additional settings required. The wizard displays the panel for macros and

destination folder (see step 4 .).

Every day at a specific time: Indicate the time at which the report is to be generated and click Next.

User Guide

101

Hardware Sentry KM for PATROL

Version 1.8.01

Sche dule Ha rdwa re Inv e ntory Re ports — Ev e ry da y

Every week at a specific time and day: Specify the time and the days you want the report generated and click Next.

Sche dule Ha rdwa re Inv e ntory Re ports — Ev e ry W e e k

Every month at a specific time and day: Indicate the day of each month and the time at which the report is to be generated and click Next.

User Guide

Sche dule Ha rdwa re Inv e ntory Re ports — Ev e ry m onth

102

Hardware Sentry KM for PATROL

Version 1.8.01

Indicate where the report is to be saved and specify its filename:

Sche dule Ha rdwa re Inv e ntory Re ports — Ma cros a nd Re port de stina tion folde r

User Guide

103

Hardware Sentry KM for PATROL

Version 1.8.01

Save the Hardware Inventory in the following folder: Enter the file path

Use the following template for the Hardware Inventory filename: Indicate the path and folder where the report is to be saved and its filename. Available macros are listed in the

Alert

Actions Macro Variables section. Using the given macros will enable you to have reports that are

properly named with the hostname and time the reports are generated.

A confirmation is finally displayed:

Sche dule Ha rdwa re Inv e ntory Re ports — Va lida tion

Click Finish. The report will be automatically generated as per the specifications indicated.

You can also generate an

Instant Hardware Inventory report at any time for the whole managed system

or for any individual component.

Generating Capacity Reports

Administrators can create custom PATROL queries to generate detailed reports of the capacity of the monitored systems. These reports can for instance indicate the number of physical CPUs, the amount of memory, the overall size of disks and volumes, the number of connected ports, etc.

To generate these custom PATROL queries:

User Guide

104

Hardware Sentry KM for PATROL

Version 1.8.01

In the main menu bar of the PATROL Console, click Actions > New Query... to create a PATROL query

PA T ROL Que ry - Ge ne ra l ta b

User Guide

105

Hardware Sentry KM for PATROL

Version 1.8.01

In the General tab:

Enter the Query name and description

In the Query Results Filter section, select Show Selected Objects and check the Parameters box

In the Additional filtering section, select the Enable Parameter level filtering option

Open the Parameter tab

PA T ROL Que ry - Pa ra m e te r ta b

In the Pattern Matching section, select Like and type:

CPUCount for a CPU report

MemorySize for a memory size report

ConnectedPorts for a connected ports report

PhysicalDiskSize for a physical disk size report

Click OK.

Reporting Energy Usage

Energy consumption has emerged as important concerns in systems and services management. In order to provide accurate and helpful information on the energy consumed by hardware components,

Hardware Sentry provides an energy usage report that can be customized to show how the power is being consumed.

To generate an Energy Usage Report, right-click Hardware icon > KM Commands > Reporting >

Energy Usage Report.

User Guide

106

Hardware Sentry KM for PATROL

Version 1.8.01

Define the report settings:

Ene rgy Usa ge Re port — Se ttings De finition

Select the data you wish to generate a report for: energy usage or power consumption traffic

Select the period that you wish the report to cover: number of days or hours

Select the interval to apply to the report data: hourly or daily

Click the Show Reports button to display the graph.

Ene rgy Usa ge Re port — Gra ph

Reporting Ethernet/Fiber Port Traffic

Hardware Sentry enables you to generate a report showing usage statistics returned by a specific

Ethernet/fiber port. The reports shows the total number of received and transmitted bytes for the selected port. It can easily be customized to show the data that administrators can use to optimize network traffic.

User Guide

107

Hardware Sentry KM for PATROL

Version 1.8.01

To generate an Ethernet/Fiber Port Traffic Report, right-click the Hardware icon > KM Commands >

Reporting > Ethernet/Fiber Port Traffic Report.

Define the report settings

Ethe rne t/Fibe r Port T ra ffic Re port — Se ttings De finition

Select the data you wish to generate a report for: bytes or packet traffic

Select the period that you wish the report to cover: number of days or hours

Select the interval to apply to the report data: hourly or daily

Select the Ethernet/Fiber port you wish to generate a report for: Click the Ethernet/Fiber Port

Selection button to display a list of available ports.

User Guide

108

Hardware Sentry KM for PATROL

Version 1.8.01

Select an Ethernet/Fiber port

Ethe rne t/Fibe r Port T ra ffic Re port – De v ice Se le ction

Click on the port's name to select it. You can select up to 32 ports to be displayed on the same report.

Click Accept to validate you selection.

Generate a usage report

User Guide

Ethe rne t/Fibe r Port T ra ffic Re port – Gra ph

Click the Show Reports button to display the graph.

109

Hardware Sentry KM for PATROL

Version 1.8.01

Administrative Tasks

This section deals with information on basic configuration and administrative tasks such as:

Set connection, credentials and connectors on the local host

Trigger a KM discovery

Customize the discovery cycle

Customize the polling interval

Pause / Resume the monitoring of an object

Reinitialize the KM

Terminate the monitoring of a device

Restore the monitoring of a device after removal

Show an instant Hardware Health report

Display labels in the UNIX Console mode

Deactivate device class

Detect missing device

Automatically reset ErrorCount parameters

Java Settings

Disable localhost monitoring

The Reference Guide has a section on C onfiguration Variables which contains list of global and host-specific configuration v ariables as well as macros. This information is also av ailable in an online format in the Hardware Sentry

Online Technical Library , as well as in the online help of the KM.

User Guide

110

Hardware Sentry KM for PATROL

Version 1.8.01

Hardware Sentry Menu Commands

Hardware is the main Hardware Sentry icon for each managed system. The menu commands available from this icon apply to the entire managed system.

Right-click the Hardware icon > KM Commands and then on one of the commands below:

KM Settings : Displays all the menu command options for different monitoring settings.

This System's Settings : Allows you to set system properties and credentials to be used for

monitoring.

Add a Remote System or an External Device : Enables you to monitor another system or an external

device remotely either SNMP, WMI, SSH/Telnet or WBEM.

Remove this system : Enables you to remove a system from the console.

Reporting : Provides various reports and enables you to schedule automated generation of hardware

health reports for all hardware components monitored.

Pause Monitoring : Enables you to pause the monitoring of the system

Resume Monitoring : Enables you to resume the monitoring that’s been paused

Reinitialize KM : Enables you to trigger a complete re-initialization of Hardware Sentry.

About: States basic product information and BMC Software support contact information

Reinitializing the KM

If ever Hardware Sentry does not function properly: displays devices as missing that you know are present, or does not detect several devices as it should etc., it is possible to reinitialize the configuration and let Hardware Sentry re-start monitoring from scratch.

The above cases of malfunction could occur after a configuration change or especially after a software/ hardware upgrade etc.

In such a case, you can reinitialize the KM, and Hardware Sentry will then run a full discovery and will re-detect the managed system, detect the appropriate connectors and re-start the monitoring of existing

& new devices. Thresholds will be set to default so all previously manually set thresholds will be lost, unless specified otherwise in the Reinitialize KM wizard shown below.

User Guide

111

Hardware Sentry KM for PATROL

Version 1.8.01

To reinitialize Hardware Sentry: Right-click the Hardware icon > KM Commands > Reinitialize

KM:

User Guide

Re initia lize KM

112

Hardware Sentry KM for PATROL

Version 1.8.01

Select the options as per your specific needs:

Alert thresholds and actions

Remove manually customized alert thresholds: Selection removes all customized thresholds.

Reset the threshold mechanism mode to default: Selection makes the KM revert to the default mode i.e. Hardware Sentry selects the mechanism is best suited to the system.

Reset Alert Actions: Selection removes all manually set Alert Actions and reverts to basic default actions i.e. Trigger a PATROL event and Annotate a parameter graph.

Reset other alert and threshold settings: Selection reverts any manually done configuration changes to default Hardware Sentry values.

Misc. options

Deactivate the debug mode: Selection deactivates the debug mode if manually enabled.

Restore and resume paused/removed objects: Selection restores all paused or removed objects.

Remove Hardware Health Report Schedule settings: Selection clears the report schedule.

Remove Java Settings: Selection removes the custom Java Settings (path and credentials).

The KM will try to automatically find a suitable JRE.

Monitoring settings for local host only

Force localhost monitoring: Selection restores the monitoring of the localhost when it has previously been removed with the

Remove this System command

Remove the security settings: Selection clears all the security settings entered.

Unload connectors and perform a platform detection: Selection restarts the detection process.

Save reinitialize settings

Save reinitialize setting: Selection saves the defined settings that will then be considered as default.

In cases where configurations hav e been manually set in the PA TROL A gent, there will be an additional section called

Internal KM engine options display ing the used configuration v ariables and the option to remov e them.

Click Reinitialize.

KM Commands for the Managed System's Settings

The KM commands for the managed system's settings are accessible by right-clicking the Hardware

icon > KM Commands > This System's Settings:

Connection, Credentials and Connectors to access security settings and connector selection

features.

Network Link Alerts to configure alerts that must be triggered when a break in the network link is

detected.

Default Power Wattage to provide the system with the electricity consumption for a given device.

Trigger a discovery to trigger a forced discovery and re-discover & detect the hardware

components.

User Guide

113

Hardware Sentry KM for PATROL

Version 1.8.01

Connection Credentials and Connectors on Local Host

In order to access

security settings and

connector selection features, right-click the local host’s

Hardware icon > KM Commands > This System’s Settings > Connection, Credentials and

Connectors.

This wizard begins with

security settings

and is then followed by the connector selection step.

Security Settings

Conne ction Cre de ntia ls a nd Conne ctors on Loca l Host — Se curity Se ttings

User Guide

114

Hardware Sentry KM for PATROL

Version 1.8.01

SNMP Community

Hardware Sentry allows you to set or modify the SNMP community that will be used for SNMP queries.

Enter the custom SNMP community string in the first field or leave this field blank if you want Hardware

Sentry to automatically detect the SNMP community (public). Using an alternate SNMP community can be required in secured network environments where all the SNMP agents are configured in a customized community.

The KM on supports SNMP v 1.

Alternate User Account

Enter the user credentials of the alternate account to execute external commands, or leave blank to consider the default PATROL account.

Using an alternate account, i.e. an account different from the default PATROL account to execute external commands is required in some secured systems where the default PATROL account does not have all the privileges required in order to perform commands on certain hardware devices.

Restart the PA TROL agent in order to ensure that the modified settings take effect.

Sudo Options (UNIX/Linux)

Depending on the targeted platform, Hardware Sentry may use some external system utilities to gather hardware information. Sometimes the PATROL Agent default account does not have sufficient privileges to execute these commands and it is not possible in your environment to give super-user rights to the

PATROL Agent (as described above). In such case Hardware Sentry can use the "sudo" utility to execute external commands as "root". The "sudo" utility helps UNIX system administrators secure their environment by authorizing some users to execute only certain commands specified as another user account (typically root). If this applies to you, the "sudo" options feature could be a good workaround.

User Guide

115

Hardware Sentry KM for PATROL

Version 1.8.01

Conne ction Cre de ntia ls a nd Conne ctors on Loca l Host — Sudo Options

Commands: Select the commands Hardware Sentry should execute using the "sudo" utility.

Command line to execute the sudo utility: Enter the command line, or, leave the field blank to use the default /usr/local/bin/sudo path.

Ensure that the sudo utility is installed on the sy stem, and that the "/etc/sudoers" file is configured to allow the

PA TROL A gent to ex ecute the selected commands as root.

Here is the procedure to configure Hardware Sentry to use "sudo":

Identify the commands run by Hardware Sentry that require advanced privileges.

Configure "sudo" to allow the PATROL Agent default account to execute the needed commands as root (modify the /etc/sudoers file). Configuring "sudo" requires root privileges.

Check that the PATROL Agent default account is properly authorized to execute the needed commands through the "sudo" utility.

Access the Hardware Sentry Security Settings panel: Hardware icon > This Systems’s Setting

> Connection, Credentials and Connectors > Sudo options.

Check the boxes corresponding to the commands that have been configured in "sudo".

For more information about using 'sudo" in Hardware Sentry KM, please refer to the KB article #1080 av ailable on the

Sentry W eb site.

User Guide

116

Hardware Sentry KM for PATROL

Version 1.8.01

The next panel asks for WBEM credentials:

WBEM

Conne ction Cre de ntia ls a nd Conne ctors on Loca l Host — W BEM Cre de ntia ls

Enter the WBEM credentials or leave blank if using default PATROL account credentials and click Next.

The next panel allows you to decide which mode is to be used for selecting connectors.

Connector Selection

Two choices are possible:

Let Hardware Sentry detect which connectors to use: In this mode, Hardware Sentry will run tests at each discovery and select the connectors that best match the managed system.

Manually choose the connectors: Selecting this option lets you decide which connectors

Hardware Sentry should use to monitor the system Hardware.

W hen the panel comes up, the selected option is the one that is currently in use.

The first option: Let Hardware Sentry detect which connectors to use is recommended and is used by default when Hardware Sentry is loaded on a PATROL Agent.

The detection process is very efficient and accurate, and generally, does not use the computer’s

User Guide

117

Hardware Sentry KM for PATROL

Version 1.8.01

resources extensively. Clicking on the Next button will bring up a panel with a message stating that

Hardware Sentry needs to be reinitialized to run the detection process again.

If manual selection is chosen (essential for remote monitoring), the next panel displays a list of connectors to choose from. It is possible to select several connectors from the list by simply clicking on them. De-selecting a connector is also performed by clicking on the item on the list.

A t the end of the selection wizard, Hardware Sentry runs a full discov ery . A ll dev ices and sensors are re-detected. If the connector list differs from what Hardware Sentry was using prev iously , new dev ices monitored may appear in the

PA TROL C onsole and old ones may be remov ed. If this is the case, pay close attention to the PA TROL Sy stem Output

W indow for error messages. A poor selection of connectors may remov e all dev ices and sensors and may prev ent

Hardware Sentry from being able to monitor the sy stem’s hardware!

Final Step

Clicking the Next button brings up a panel with a message stating that Hardware Sentry needs to delete the host instance in the PATROL Console and perform a new discovery of the host.

Conne ction Cre de ntia ls a nd Conne ctors on Loca l Host — Pe rform a Ne w Host Discov e ry

Click Finish.

User Guide

118

Hardware Sentry KM for PATROL

Version 1.8.01

Connection, Credentials and Connectors for Remote Hosts

In order to access

security settings and

connector selection features, right-click the remote system's

Hardware icon > KM Commands > This System’s Settings > Connection, Credentials and

Connectors.

Right click the remote system's Hardware icon > KM Commands > Add a Remote System or

an External Device...

Monitor a Re m ote Sy ste m or a n Ex te rna l De v ice — Lice nse A gre e m e nt

User Guide

119

Hardware Sentry KM for PATROL

Version 1.8.01

Read the license agreement, accept it and click Next to continue.

Identify the system or device you want to monitor remotely and click Next.

Monitor A nothe r Sy ste m Re m ote ly — Sy ste m Ide ntifica tion

User Guide

120

Hardware Sentry KM for PATROL

Version 1.8.01

System or Device name: Enter the name of the system or device you wish to monitor

IP address or fully qualified name: Leave this field blank if you specify the host name above

System or Device type: Select a platform from the drop down list to specify the system or device type.

Select the Automatic option and at least one of the proposed protocols to let the KM automatically detect the suitable connectors for the monitored system/device; or select the Manual option and click Next to manually select a connector.

Based on the specified system type, the KM lists the available protocols to monitor the remote system/device.

Monitor A nothe r Sy ste m Re m ote ly — Conne ctor Se le ction Mode

User Guide

121

Hardware Sentry KM for PATROL

Version 1.8.01

The KM allows you to select the connectors for Hardware Sentry to use to monitor the remote system/device. The list of displayed connectors depends on the monitored system/device. Select the appropriate connectors and click Next.

User Guide

Monitor A nothe r Sy ste m Re m ote ly — Conne ctors Se le ction

The following steps depend on the sy stem/dev ice ty pe of the remote element and the protocols used to connect to

it. For information about which connectors are suitable for each sy stem/dev ice, please refer to the C onnectors and

Platforms

in the Reference Guide.

122

Hardware Sentry KM for PATROL

Version 1.8.01

If the connectors selected use SNMP, this panel appears:

Monitor A nothe r Sy ste m Re m ote ly — SNMP Com m unity String

SNMP community string: Enter the SNMP community string and click Next.

The KM only supports SNMP v 1.

If the connectors selected use WMI or WBEM these panels appear asking for connection

credentials:

User Guide

123

Hardware Sentry KM for PATROL

Version 1.8.01

Monitor A nothe r Sy ste m Re m ote ly — W MI Que rie s Cre de ntia ls

Monitor A nothe r Sy ste m Re m ote ly — W BEM Que rie s Cre de ntia ls

WMI/WBEM credentials: Enter the WMI/WBEM credentials and click Next.

Click on the Advanced Options button to access specific settings related to the WBEM connection:

User Guide

124

Hardware Sentry KM for PATROL

Version 1.8.01

Monitor A nothe r Sy ste m Re m ote ly — W BEM Cre de ntia ls — A dv a nce d Options

Enter the IP address/Host-name of the Multi-tier Authentication Server (This option mostly is used for VMware servers).

Click Accept to validate your changes.

If the connectors selected require Telnet or SSH to connect to the remote element, the following panel appears:

Monitor A nothe r Sy ste m Re m ote ly — Scripts Cre de ntia ls

User Guide

125

Hardware Sentry KM for PATROL

Version 1.8.01

Connect to [System/Device] using the following protocol: Select either Telnet or SSH and enter the credentials required to execute the protocols and click Next.

Login and Password: Enter the login and password that Hardware Sentry is required to use to connect to the system/device to monitor.

Sudo options: On UNIX/Linux platforms, you have the option of permitting Hardware Sentry to use the Sudo utility to execute external commands using root.

Monitor A nothe r Sy ste m Re m ote ly — Sudo Options

User Guide

126

Hardware Sentry KM for PATROL

Version 1.8.01

If the connectors selected use the IPMI protocol, the following panel appears:

Monitor A nothe r Sy ste m Re m ote ly — IPMi Protocol

Username: credentials to connect to the IPMI chip out-of-band (IPMI-over-LAN)

Password: password associated to the specified username

If the connectors selected use the Cisco UCS XML API protocol, the following panel appears:

User Guide

127

Hardware Sentry KM for PATROL

Version 1.8.01

Monitor A nothe r Sy ste m Re m ote ly — Cisco UCS XML A PI Protocol

Encrypt data: Select this option to encrypt the communication between the KM and Cisco UCS

Manager using SSL (HTTPS)

Username: credentials valid on the specified Cisco UCS Manager

Password: password associated to the specified username

Final Step in the remote monitoring wizard is common to all platforms/systems. Click Finish and

Hardware Sentry will perform a new full discovery to detect this new remote system.

The Hardware icon for the local host will change to Hardware on localhost and an icon labeled

Hardware on <remotehostname> will appear. This represents the system/device you are now monitoring remotely, along with icons for all of the detected parameters of this remote system/device.

Triggering a Discovery

Hardware Sentry automatically executes a discovery every hour of all hardware objects for the monitored system. This enables discovering and then monitoring any new objects added or removed on the monitored environment.

You can force a discovery manually by right-clicking on the Hardware icon > KM Commands > This

System's Settings > Trigger a Discovery. This forces a discovery for the selected host only.

W ith a v iew to optimization, the discov ery process is as paralleled as possible. A ll independent objects are processed at the same time.

Disabling Localhost Monitoring

Disabling the monitoring of the localhost maybe useful when you need to monitor exclusively remote systems, such as blade chassis for example.

To disable the localhost monitoring click the localhost icon > KM Commands > Remove this

System.

To re-add the localhost monitoring, you need to perform a Reinitialize KM.. Command and select the

Force localhost monitoring option.

User Guide

128

Hardware Sentry KM for PATROL

Version 1.8.01

Re -a dding the m onitoring of the loca lhost

Localhost monitoring will be automatically re-added if there is no host to monitor.

User Guide

129

Hardware Sentry KM for PATROL

Version 1.8.01

KM Commands for KM Settings

KM Settings

Alert Actions: Enables you to select the

Alert Actions i.e. different notification methods to be

executed by Hardware Sentry when a parameter breaches its threshold.

Deactivate Device Class: Allows you to set aside

device classes from the monitoring process

and, therefore, discard the performance metrics for those specific devices to be taken into account by the KM.

Missing Device Detection: Allows you to disable the

missing device detection feature. By default,

Hardware Sentry detects "missing devices" i.e. devices previously monitored but which have disappeared during the monitoring or after a reboot or due to some other cause

Intrusion Detection Alerts: Allows you to decide when an

intrusion detection alert

for the enclosure/ systems chassis should be raised

The IntrusionStatus parameter of each enclosure object discovered by Hardware Sentry reports whether or not the chassis has been opened, and triggers an alarm as per user settings.

Automatic ErrorCount Parameters Reset...: Enables you to

reset the ErrorCount parameters

of a specific device

Discovery Interval: Enables you to customize the

discovery cycle

. By default, discovery is performed every hour

Polling Interval: Enables you to customize the polling cycle

. By default, the polling interval is done every two minutes.

Java Settings...: Defines which Java instance is to be used by Hardware Sentry.

Debug...: Activates or deactivates the

Debug mode .

Additional Settings

Additional Settings allow you to:

Select the threshold mechanism to be used:

Automatic (by default): Hardware Sentry determines the mode of threshold management to apply to the system, that is the Event Management method will be used if the Event Management

KM is in the list of preloaded KMs on the agent, otherwise, the Tuning method will apply.

Tuning: Hardware Sentry uses the internal PATROL mechanism to set thresholds

Event Management: Hardware Sentry automatically sets thresholds through Event

Management

No Thresholds: Hardware Sentry does not set any thresholds and lets you specify them manually

Unknown Status Management: Allows you to select the actions

to be performed if Hardware

Sentry returns an "Unknown" status when it is unable to detect a device or sensor.

Internal KM Issues Notification: Allows you to enable/disable and select the type of information messages displayed by Hardware Sentry in the system output window of the PATROL Console.

User Guide

130

Hardware Sentry KM for PATROL

Version 1.8.01

Restore Device or Sensor Monitoring: Brings up the Restore Device or Sensor Monitoring

wizard to restore one or several objects after their monitoring has been stopped (if removed).

Display Settings for UNIX Consoles: Gives you the option to turn on the UNIX console mode and

modify all object labels to fit the PATROL UNIX Console label size.

Enabling the Debug Mode

By default, Hardware Sentry sends only the most critical information, warning and error messages to the System Output Window of the PATROL Consoles. Most often, this information is accurate enough to ensure that Hardware Sentry is working properly.

If you encounter an issue and wish to report it to Sentry Software, you will be asked to enable the

Debug Mode and provide the debug output to the Sentry Software support team.

To enable the debug mode:

Right-click the main KM icon > KM Commands > KM Settings > Debug...

Ena bling the De bug Mode

Check the Enable Debug Mode option

Indicate the time when the debug mode will be disabled. The required format is: mm/dd/yyyy hh: mm:ss) based on a 24 hour-day.

By default, the debug mode is set to stop automatically after one hour.

Click OK. The debug files will automatically be saved in $PATROL_HOME/log.

User Guide

131

Hardware Sentry KM for PATROL

Version 1.8.01

Customizing the Discovery Cycle

Hardware Sentry performs discoveries to detect new hardware components or detect those that have gone missing.

By default, the Hardware Sentry runs a discovery every hour, but you can customize this interval by right-clicking on the Hardware icon > KM Commands > KM Settings > Discovery Interval.

Custom izing Discov e ry Cy cle

Customizing the Polling Interval

Hardware Sentry polls the managed systems to collect hardware health data. By default, the polling interval for this "data-collect" is set to every 2 minutes.

To change the polling interval for the managed system, right-click on the Hardware icon > KM

Commands > KM Settings > Polling Interval…

User Guide

132

Hardware Sentry KM for PATROL

Version 1.8.01

Custom izing Polling Inte rv a l

In addition to the polling interv al that is a global setting, i.e. it is applicable to the whole managed sy stem, y ou can also manually trigger a poll at any time on indiv idual instances to refresh parameter v alues. Right-click on the instance icon > Refresh Parameters.

Java Settings

The Java Settings wizard enables you to define which Java instance is to be used by Hardware Sentry.

You can either use the automatic detection, select a pre-detected java path or enter manually the path leading to the Java executable directory to be used.

Performing Telnet, SSH or W BEM-based collection (i.e. for most remote Linux and UNIX sy stems, and most storage sy stems) require Jav a Runtime Env ironment (JRE) v ersion 1.5 or higher.

A pa che J RE is not supporte d.

To access the Java Settings wizard, right-click the main Hardware icon > KM commands > KM

Settings > Java Settings.

User Guide

133

Hardware Sentry KM for PATROL

Version 1.8.01

J a v a Se ttings W iza rd — W e lcom e Pa ge

Select the Java executable detection method: Select one of the three following options:

Automatic

: Select this option if you wish Hardware Sentry KM to try and detect the Java

executable directory by itself upon each discovery.

User Selection

: Select this option if you wish to select a Java executable directory within a list of

pre-detected executables on the managed system.

Manual

: Select this option if you wish to manually enter the Java executable directory path.

Click Next to continue.

User Guide

134

Hardware Sentry KM for PATROL

Version 1.8.01

Automatic

If you have selected the automatic detection at the previous step of the wizard, Hardware Sentry KM displays the path of the Java executable directory that will be used when performing commands requiring Java features.

J a v a Se ttings W iza rd — A utom a tic De te ction

You can use a specific account to run Java on the managed system or leave the field blank for using the current valid PATROL account.

Click Finish to save your settings.

User Guide

135

Hardware Sentry KM for PATROL

Version 1.8.01

User Selection

If you have selected the user selection option at the previous step of the wizard, Hardware Sentry KM displays a list of all the Java executable directories found on your machine.

J a v a Se ttings W iza rd — Use r Se le ction

Select the Java executable directory you wish Hardware Sentry KM to use when performing commands requiring Java features. You can use a specific account to run Java on the managed system or leave the field blank for using the current valid PATROL account.

Click Finish to save your settings.

User Guide

136

Hardware Sentry KM for PATROL

Version 1.8.01

Manual

J a v a Se ttings W iza rd — Ma nua l J a v a pa th ide ntifica tion

If you have selected the Manual option at the previous step of the wizard, Hardware Sentry KM let you enter the path to the Java executable directory you wish Hardware Sentry KM to use when performing commands requiring Java features. You can use a specific account to run Java on the managed system or leave the field blank for using the current valid PATROL account.

Click Finish to save your settings.

Once you have modified the Java setting, you must restart the PATROL Agent in order to make your changes effective.

User Guide

137

Hardware Sentry KM for PATROL

Version 1.8.01

J a v a Se ttings W iza rd — Re sta rt the PA T ROL A ge nt

Click OK and restart the PATROL Agent.

User Guide

138

Hardware Sentry KM for PATROL

Version 1.8.01

Deactivating Device Class

Hardware Sentry KM for PATROL allows you to set aside device classes from the monitoring process and, therefore, discard the metrics and performance data for those specific devices to be taken into account by the KM.

The KM will not trigger any alarm if a failure on a discarded device were to occur.

To deactivate a device class:

1. Right-click Hardware Sentry KM icon > KM Commands > KM Settings > Deactivate Device

Class...

2. Select the device class(es) you wish to discard from the monitoring process:

De a ctiv a te De v ice Cla ss

3. Click OK to confirm.

To reintegrate a previously discarded device class, simply uncheck the corresponding option in the

Deactivate Device Class window.

User Guide

139

Hardware Sentry KM for PATROL

Version 1.8.01

Missing Device Detection Mechanism

The missing device detection mechanism of Hardware Sentry alerts operators when a device that was previously detected in the system is no longer found.

This mechanism is very useful when, for example, a non-redundant physical disk does not restart during a system reboot and therefore is no longer seen by the operating system and the monitoring software.

When a device is no longer discovered, its Missing parameter goes into alarm. The missing device detection feature is enabled by default. You can however deactivate the feature by right-clicking the

Hardware icon > KM Commands > KM Settings > Missing Device Detection.

Missing De v ice De te ction

Disabling this option when some missing dev ices hav e already been detected will trigger a remov al of these dev ices from the monitoring env ironment.

User Guide

140

Hardware Sentry KM for PATROL

Version 1.8.01

Automatic ErrorCount Parameters Reset

ErrorCount parameter (as in the physical disk and memory classes) keep increasing as new errors are encountered. When no error occurs, the ErrorCount parameter remains at zero. When one error occurs, the ErrorCount parameter is increased to 1 (one), and retains this value until it is acknowledged by an operator. When another error occurs, the ErrorCount parameter is automatically increased to 2 (two), and again, it retains this value until it is acknowledged by an operator.

The DeviceNotReadyErrorCount, MediaErrorCount, NoDeviceErrorCount, HardErrorCount,

IllegalRequestErrorCount, RecoverableErrorCount, and TransportErrorCount parameters provide detailed information about the type of errors encountered on the physical disks.

To reset the ErrorCount parameters of a specific device, an operator must manually activate the

Acknowledge ErrorCount Alerts and Reset command via the console menu (right-click the device icon> KM Commands > KM Settings > Acknowledge ErrorCount Alerts and Reset).This

mechanism makes sure that an operator or an administrator is aware of the encountered error.

However, since the manual acknowledgment of each error can rapidly become time consuming,

Hardware Sentry KM can be configured to automatically acknowledge an alert on the ErrorCount parameters and reset it to zero after a specified period of time.

To set the automatic ErrorCount parameters reset for a specific device, right-click the Hardware icon

> KM Commands > KM Settings > Automatic ErrorCount Reset:

A utom a tic ErrorCount Re se t

Select the period of time after which you want the KM to automatically reset the ErrorCount parameter and click OK.

User Guide

141

Hardware Sentry KM for PATROL

Version 1.8.01

In many cases, a hardware error that does not reoccur after a certain amount of time can be safely ignored.

A utomatically resetting ErrorC ount parameters to zero after a few hours is often considered as a good practice.

Restoring Device Monitoring

It is possible to restore device monitoring with Hardware Sentry after it has been removed from monitoring through the Remove option.

To see the list of the removed objects or to restore a device monitoring:

Right-click the Hardware Sentry main icon > KM commands > KM Settings > Additional

settings > Restore Device or Sensor Monitoring.

Restore Dev ice Monitoring — Selecting all

Select:

<All> if you want to restore the monitoring of all the devices that had been previously removed, in the PATROL Console

One or more objects if you only want to restore specific devices (press down the Ctrl-key to allow multiple selection)

Click Restore.

User Guide

142

Hardware Sentry KM for PATROL

Version 1.8.01

UNIX Console Mode

The PATROL UNIX Console has a label size limitation. This could mean that at times, object labels do not display in their entirety. You can opt for turning on the UNIX Console Mode that modifies all labels to fit the PATROL UNIX Console size limitation.

To access the UNIX Console mode settings, right-click the Hardware icon > KM Commands > KM

Settings > Additional Settings > Display Settings for UNIX Console:

UNIX Console Mode Se ttings

Turning on the UNIX Console mode will affect the labels of ALL PATROL consoles including the

Windows Consoles for the given PATROL Agent. If you have a mix of UNIX and Windows, it is recommended to leave this feature disabled.

User Guide

143

Hardware Sentry KM for PATROL

Version 1.8.01

KM Commands for the Monitored Devices

The KM commands that are offered by right-clicking on a monitored hardware component/device are:

Instant Hardware Health Report

: Displays an instant report about the health of a device.

Pause Monitoring : Enables you to pause the monitoring of the hardware component

Resume Monitoring : Enables you to resume the monitoring that had previously been paused

Remove : Allows you to remove the object from the monitoring environment

Refresh Parameters : Allows you to refresh the parameters of the monitored object

Acknowledge "X" Alert/Acknowledge Error Count Alerts and Reset etc.

: Depending on the

component/device monitored and the type of system it is monitored on, there may be certain additional commands to acknowledge alerts, or acknowledge alerts and reset the error count etc.

For instance, in the case of Network Interfaces there is an additional command: Acknowledge

LinkStatus Alert

Device-container KM commands

Hardware Sentry creates "containers" for each device. For instance, an icon is created for Network

Interfaces under which all actual network interfaces discovered will be grouped.

Each "device container" has commands such as: Pause Monitoring; Resume Monitoring; Remove;

Refresh Parameters whose actions are applicable to all objects under it.

The Reference Guide lists all the menu commands for each application class along with parameter details.

Showing Instant Hardware Health Report

The Show Instant Hardware Health Report KM command enables you to generate an instant report on the hardware health of the selected hardware component.

You can view the hardware health report of a specific monitored hardware component by right-clicking on the component icon > KM Commands > Instant Hardware Health Report.

User Guide

144

Hardware Sentry KM for PATROL

Version 1.8.01

Insta nt Ha rdwa re He a lth Re port for a spe cific ha rdwa re com pone nt

This health report gives information about the monitored object (parameters, thresholds, connectors etc.) as well as a description of the problems encountered, the possible consequences, and actions recommended to solve the issues, if any.

Refreshing Parameters

To manually refresh parameters of the Hardware Sentry KM for PATROL, without waiting for an automatic polling cycle, right-click the instance icon > Refresh Parameters.

Pausing/Resuming Monitoring

In order to perform certain tasks - maintenance for example, it is often useful to pause the monitoring of an object or even of the whole system by Hardware Sentry.

Right-click the component/system icon > Knowledge Module Commands > Pause Monitoring

When in paused state, the object/system is still displayed in the PATROL Console but in an OFFLINE status and no collect for that particular object is executed.

To restart the monitoring of the object/system click Resume Monitoring in the menu.

User Guide

145

Hardware Sentry KM for PATROL

Version 1.8.01

Terminating the Monitoring of a Device

It may happen that information about a device is received by Hardware Sentry through two different sources. In such a (rare) case, the monitoring of the device is performed twice and the icon of the device in question will also appear twice in the PATROL Console.

In order to avoid such redundancy, or, if you wish to simply stop monitoring a device, there is a simple way to terminate the monitoring of the device (or a redundant device) in the PATROL Console:

Right-click the component/device icon > KM Commands > Remove.

The device is now removed from monitoring, which means collection for this particular device will no longer be performed, and the redundant icon representing the device will disappear from the PATROL

Console.

User Guide

146

Hardware Sentry KM for PATROL

Version 1.8.01

Managing Thresholds, Alerts and Notifications

Several mechanisms exist to manage thresholds in Hardware Sentry:

The Tuning method: Hardware Sentry will manage its thresholds through the standard internal

PATROL mechanism (Override parameters). Thresholds are stored in the PATROL Agent configuration under the /___tuning___ tree.

The Event Management method: The KM will manage its thresholds through the Event

Management mechanism. Thresholds are stored in the PATROL Agent configuration under the /AS tree. This option requires that you set up the PATROL for Event Management KM on your PATROL

Agent. PATROL for Event Management has to be enabled and preloaded.

No threshold: Hardware Sentry does not set any thresholds and lets you set them manually.

Since version 1.8.01, when Hardware Sentry KM for PATROL runs for the first time, alert thresholds are automatically set according to the selected threshold mechanism. Alert thresholds can however be customized by the administrators later on, if required, using the standard BMC PATROL administration tools (refer to BMC PATROL documentation for further details on BMC PATROL administration tools).

Additionally, administrators can set alerts actions to specify which actions will be executed when a hardware failure is detected (see

Alert Actions ).

Selecting the Threshold Mechanism

By default, Hardware Sentry automatically determines which mechanism (Tuning or Event Management) is best suited to the managed system when it first runs. This threshold mechanism selection can however be modified later on through the Threshold Mechanism Selection KM Command:

Right-click the main Hardware Sentry/local host icon > KM Commands > KM Settings >

Additional Settings > Threshold Mechanism Selection...

T hre shold Me cha nism Se le ction

1. Select one of the following options:

User Guide

147

Hardware Sentry KM for PATROL

Version 1.8.01

Tuning: If selected, Hardware Sentry will manage its thresholds through the standard internal

PATROL mechanism (Override parameters). Thresholds are stored in the PATROL Agent configuration under the /___tuning___ tree.

Event Management: If this option is selected, the KM will manage its thresholds through the

Event Management mechanism. Thresholds are stored in the PATROL Agent configuration under the

/AS tree. This option requires that you set up the PATROL for Event Management KM on your

PATROL Agent. PATROL for Event Management has to be enabled and preloaded.

No Thresholds: Hardware Sentry will not set any thresholds on the monitored objects. You are required to set them manually.

In order to avoid side effects and unpredictable behavior, if you change the thresholds management option from one method to another, Hardware Sentry will automatically migrate the instance specific thresholds to the other mode and will reset the ANYINST/ALL_INSTANCES thresholds with default values. Note that a backup of the Hardware Sentry thresholds configuration is made prior to the migration.

Modifying Alert Thresholds

Since version 1.8.01 of Hardware Sentry KM for PATROL, all thresholds can be customized using the standard BMC administration tools.

For further details, please refer to the BMC PA TROL documentation.

Alert Actions

Alert Actions enables the PATROL administrator to choose specific actions to be executed when a hardware failure is detected. With Alert Actions, it is possible to either:

Customize the way a hardware problem notification is performed, or

Specify a recovery action to be run when a problem occurs.

Hardware Sentry can be configured to run one, several, or all types of Alert Actions when an alert is triggered regarding the monitored hardware.

By default, upon hardware failure, Hardware Sentry triggers a PATROL event and annotates the parameter’s graph with a comprehensive report of the problem, giving details about the failure, the possible consequences and the recommended action to solve the problem.

The Alert Actions that can be performed by Hardware Sentry are:

User Guide

148

Hardware Sentry KM for PATROL

Version 1.8.01

Trigger a PATROL event

Annotate the parameter's graph

Execute an OS command

Execute a PSL command

Send a pop-up to the PATROL consoles

Write a line to a LOG file

Send a basic SNMP trap (using the PATROL MIB)

Send a custom SNMP trap

Send an E-mail

Alert Actions are highly customizable. One can customize the string that is sent through SNMP, set the username/password that is used to execute the OS Command, define the content of the PATROL event sent by Hardware Sentry, etc.

Additional information regarding the alert, such as the parameter name or its value, is available through

the Alert Actions macros . This information can be used to further customize the Alert Action triggered

by Hardware Sentry and provide more details about the problem that occurs.

User Guide

149

Hardware Sentry KM for PATROL

Version 1.8.01

Edit Alert Actions

To modify the Alert Actions executed by Hardware Sentry upon a hardware failure, right-click on the main Hardware icon > KM Commands > KM Settings > Edit Alert Actions…

Select the Alert Actions to be executed

Check the boxes corresponding to the actions you would like executed upon a hardware failure.

By default, Hardware Sentry triggers a PATROL event and annotates the parameter that raises the alert, but there are all the actions that can be triggered:

Editing A le rt A ctions — Se le cting Pa ra m e te rs

User Guide

150

Hardware Sentry KM for PATROL

Version 1.8.01

Trigger a PATROL event

Annotate the parameter's graph

Execute an OS command

Execute a PSL command

Send a pop-up to the PATROL consoles

Write a line to a LOG file

Send a basic SNMP trap (using the PATROL MIB)

Send a custom SNMP trap

Send an Email

Trigger a PATROL event

If you select Trigger a PATROL Event, you need to enter the string that will be displayed with the event.

Editing A le rt A ctions — A le rt A ction: T rigge r a PA T ROL Ev e nt

A PATROL Event can be viewed from:

Standard PATROL Consoles (Classic Console, PATROL Central)

PATROL Enterprise Manager

BMC Impact Manager

Other third-party products that interface with PATROL.

The PA TROL ev ent that is triggered is the ‘41’ ev ent from the standard PA TROL catalog. You can use macros that will

be replaced at runtime. The A lert A ctions Macro Variables *A lert_A ctions_Macro_Variabsection states the list of

av ailable macrosA lert_A ctions_.

User Guide

151

Hardware Sentry KM for PATROL

Version 1.8.01

Annotate the parameter’s graph

If you select the Annotate the parameter’s graph action, you need to enter the string that will be displayed within the annotation point.

Editing A le rt A ctions — A le rt A ction: A nnota te Pa ra m e te r's Gra ph

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

*A lert_A ctions_Macro_Variabsection states the list of av ailable macrosA lert_A ctions_.

User Guide

152

Hardware Sentry KM for PATROL

Version 1.8.01

Execute an OS command

If you select the Execute an OS command action:

Editing A le rt A ctions — A le rt A ction: Ex e cute a n OS Com m a nd

Enter a command line to be executed

Enter the username and password used to run the command.

The command can be a program utility or a script shell, and can have arguments.

The command must be non-interactive (no window, no user input)

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

*A lert_A ctions_Macro_Variabsection states the list of av ailable macrosA lert_A ctions_A lert_A ctions_.

User Guide

153

Hardware Sentry KM for PATROL

Version 1.8.01

Execute a PSL command

If you select the Execute a PSL command action, you need to enter the PSL statement to be executed by the PATROL Agent. Although only a single line is permitted, it can have several PSL instructions.

Editing A le rt A ctions — A le rt A ction: Ex e cute a PSL Com m a nd

The PSL command is recommended for advanced user of PATROL.

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

*A lert_A ctions_Macro_Variabsection states the list of av ailable macrosA lert_A ctions_.

User Guide

154

Hardware Sentry KM for PATROL

Version 1.8.01

Send a pop-up to the PATROL Consoles

If you select the Send a pop-up to the PATROL Consoles action, you need to enter the message that will be displayed in the pop-up as well as the title of the pop-up window.

Editing A le rt A ctions — A le rt A ction: Se nd a Pop-up to the PA T ROL Console s

Too many pop-ups could annoy the operators.

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

*A lert_A ctions_Macro_Variabsection states the list of av ailable macrosA lert_A ctions_.

User Guide

155

Hardware Sentry KM for PATROL

Version 1.8.01

Write a line to a LOG file

If you select the Write a line to a LOG file action:

Editing A le rt A ctions — A le rt A ction: W rite a Line to a LOG File

Enter the LOG file path and the content of the line.

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

*A lert_A ctions_Macro_Variabsection states the list of av ailable macrosA lert_A ctions_.

User Guide

156

Hardware Sentry KM for PATROL

Version 1.8.01

Send a basic SNMP trap

If you select the Send a basic SNMP trap action:

Editing A le rt A ctions — A le rt A ction: Se nd a Ba sic SNMP T ra p

Enter the following:

IP address or hostname of the SNMP trap destination

SNMP port and community string

Text that will be sent in the SNMP trap

Upon a hardware failure, Hardware Sentry will send the trap that is defined in the PA TROL MIB (Trap number 11,

Enterprise ID: 1.3.6.1.4.1.1031.1.1.2, the tex t is stored in the 1.3.6.1.4.1.1031.1.1.2.1 OID). You can use macros

that will be replaced at runtime. The A lert A ctions Macro Variables *A lert_A ctions_Macro_Variabsection states the list

of av ailable macrosA lert_A ctions_.

User Guide

157

Hardware Sentry KM for PATROL

Version 1.8.01

Send a custom SNMP trap (advanced)

If you select the Send a custom SNMP trap action, you need to enter the following:

Editing A le rt A ctions — A le rt A ction: Se nd a Custom SNMP T ra p

Enter the following:

User Guide

158

Hardware Sentry KM for PATROL

Version 1.8.01

IP address or hostname of the SNMP trap destination

SNMP port and community string

All the characteristics of the trap: Enterprise ID, trap number and up to 4 varbinds.

Send an E-mail

If you select the Send an E-mail action, you need to complete the following panel:

A le rt A ctions: Se nd a n E-m a il

Enter the sender and the recipient email addresses in respectively the From and To fields, and type the

SMTP server name. Finally, enter the email Subject and type the Body of the message you wish to send.

User Guide

159

Hardware Sentry KM for PATROL

Version 1.8.01

Changes Validation

After selecting and defining Alert Actions, you need to validate your changes by clicking the Finish button.

Editing A le rt A ctions — Va lida tion

You can use macros that will be replaced at runtime. The A lert A ctions Macro Variables

section states the list of av ailable macrosA lert_A ctions_.

User Guide

160

Hardware Sentry KM for PATROL

Version 1.8.01

Alert Actions Macro Variables

Macro variables can be used in the Alert Actions to customize a string with information related to the encountered hardware failure (display name of the faulty object, value of the parameter, description of the problem, etc.).

Example

You can configure Hardware Sentry to trigger a PATROL event containing the display name of the faulty object by entering something like "Hardware problem with %{OBJECT_NAME}" in the "Trigger a

PATROL Event" dialog box.

You can use sev eral macros at one time.

The table below recapitulates the available macros for the Alert Actions.

Macro

%{/variable_name}

%{ALARM_TYPE}

%{ASCTIME:…}

%{CONSEQUENCE}

%{DATE}

%{FULLREPORT}

%{HOSTNAME}

%{NEWLINE}, %{\n}

%{OBJECT_CLASS}

%{OBJECT_DEVICEID}

%{OBJECT_ID}

Description

Value of the variable_name instance variable

Example: %{/worstParam} will give the name of the "worst parameter" of the instance that triggered the alert.

This feature is recommended for advanced users only!

Alarm type (INFORMATION, WARNING or ALARM)

Example: ALARM

Current date and time formatted as specified in the macro

Example: %{ASCTIME:%m %d %T %Y} will produce Jun 6 11:14:53 2005

The available formats for the %{ASCTIME:…} macro are listed in the asctime() description of the PSL Reference Guide (Book 2).

Description of the possible consequence of the detected problem

Example: The temperature of the chip, component or device that was cooled by this fan should grow quickly. This can lead to severe hardware damage and system crashes.

Current date in the YYYY-MM-dd format

Example: 2005-6-23

Full hardware health report about the instance that triggered the alert

Example: see the output of the "Instant Hardware Health Report" Menu command

Name of the computer monitored with the PATROL Agent

Example: SENTRYTEST003

Linefeed.

This is useful to produce multi-line information.

Class of the instance that triggered the alert

Example: MS_HW_FAN

Hardware Sentry internal device ID of the instance that triggered the alert

Example: 1.1

PATROL internal ID of the instance that triggered the alert

Example: MS_HW_DellOpenManagehdf_11

User Guide

161

Hardware Sentry KM for PATROL

Version 1.8.01

Macro

%{OBJECT_LABEL}

%{OBJECT_TYPE}

%{PARAMETER_NAME}

%{PARENT_CLASS}

%{PARENT_DEVICEID}

%{PARENT_ID}

%{PARENT_LABEL}

%{PARENT_TYPE}

%{PROBLEM}

%{RAW_VALUE}

%{RECOMMENDED_ACTION}

%{TIME}

%{VALUE}

Description

Display name of the instance that triggered the alert

Example: Fan: 1.1 (CPU 1)

Type of the device that triggered the alert

Example: Fan

Name of the parameter that triggered the alert

Example: PredictedFailure

Class of the object that the faulty instance is attached to

Example: MS_HW_ENCLOSURE

Hardware Sentry internal device ID of the object that the faulty instance is attached to

Example: 1

PATROL internal ID of the object that the faulty instance is attached to

Example: MS_HW_DellOpenManagehdf_1

Display name of the object that the faulty instance is attached to

Example: Computer: Dell PowerEdge 1600SC

Type of the object that the faulty instance is attached to

Example: Computer enclosure

Description of the problem encountered by the monitored device

Example: The speed of this fan is critically low (1503 rpm).

Raw value of the parameter that triggered the alert

Example: 67.30000

Format Symbols for %{ASCTIME:...} Macros

The following table recapitulates all of the time formats available in the %{TIME:…}, %{ASCTIME:…} and %{LASTTIME:…} macros.

Format

Description

This symbol allows you to use a percent sign (%) in the format of a date string

Locale's abbreviated name of the day of week

Locale's full name of the day of week

Locale's abbreviated name of the month

Locale's full name of the month

User Guide

162

Hardware Sentry KM for PATROL

Version 1.8.01

%EC

%Ex

%EX

Format

Description

Locale's appropriate date and time representation

Data and time as %c

Day of month [1,31]; single digits are preceded by 0

Date as %m/%d/%y

Day of month [1,31]; single digits are preceded by a space

Locale's abbreviated name of the month

Hour (24-hour clock) [0,23]; single digits are preceded by 0

Hour (12-hour clock) [1,12]; single digits are preceded by 0

Day of year [1,366]; single digits are preceded by 0

Hour (24-hour clock) [0,23]; single digits are preceded by a space

Hour (12-hour clock) [1,12]; single digits are preceded by a space

Month as a decimal number [1,12]; single digits are preceded by 0

Minute [0,59]; leading zero is permitted but not required

Insert a new line

Locale's equivalent of either a.m. Or p.m.

Appropriate time representation in 12-hour clock format with %p

Time as %H:%M

Seconds [0,61]

Insert a tab

Time as %H:%M:%S

Day of week as a decimal number [1,7], with 1 representing Monday

Week of the year as a decimal number [0,53], with Sunday as the first day of week 1

Week of the year as a decimal number [01,53], with Monday as the first day of the week.

If the week containing 1 January has four or more days in the new year, then it is considered week 1; otherwise, it is week 53 of the previous year, and the next week, is, week 1.

Day of week as a decimal number [0,6], with 0 representing Sunday

Week of the year as a decimal number [0,53], with Monday as the first day of week 1

Locale's appropriate date representation

Locale's appropriate time representation

Year within century [0,99]

Year, including the century (for example 1993)

Abbreviated or full name of time zone, or no bytes if no information of the time zone exists

Locale's alternative appropriate date and time representation

Name of the base year (period) in the locale's alternative representation

Locale's alternative date representation

Locale's alternative time representation

User Guide

163

Hardware Sentry KM for PATROL

Version 1.8.01

Format

%EC

%OD

%OE

%OH

%OI

%Om

%OM

%OS

%OD

%Ow

%OW

%OD

Description

Offset from %EC (year only) in the locale's alternative representation

Alternative representation of the year in full

Day of the month using the locale's alternative numeric symbols

Same as %OD

Hour (24-hour clock) using the locale's alternative numeric symbols

Hour (12-hour clock) using the locale's alternative numeric symbols

Month using the locale's alternative numeric symbols

Minutes using the locale's alternative numeric symbols

Seconds using the locale's alternative numeric symbols

Week of the year (Sunday as the first day of the week) using the locale's alternative numeric symbols

Day of week (Sunday=0) using the locale's alternative numeric symbols

Week of the year (Monday as the first day of the week) using the locale's alternative numeric symbols

Year (offset from %C) in the locale's alternative representation and using the locale's alternative numeric symbols

Alert after N Times

Hardware Sentry KM for PATROL offers a global advanced alert setting in order to prevent false alerts.

You can now set/modify the number of times thresholds can be breached before triggering an alert on the Missing parameter.

This advanced alert setting, commonly known as Alert after N times is accessible by right-clicking the main Hardware icon > KM Commands > This System’s Settings > Alert after N Times…

User Guide

164

Hardware Sentry KM for PATROL

Version 1.8.01

A le rts A fte r n T im e s Pa ra m e te rs

This setting applies to the parameters of all the monitored devices of the system.

Intrusion Detection Alerts

Hardware Sentry triggers alerts if the enclosure/chassis of your managed system has been opened. An unexpectedly opened chassis could imply that the system is physically accessed by an unauthorized person. The Intrusion Detection Alert feature enables you to select the alert conditions.

Right-click the Hardware icon > KM Commands > KM Settings > Intrusion Detection Alerts:

User Guide

165

Hardware Sentry KM for PATROL

Version 1.8.01

Intrusion De te ction Se ttings

By default, Hardware Sentry triggers an alert ONLY upon the opening or breach of a closed chassis.

Network Link Alerts

Hardware Sentry triggers alerts when a break in the network link is detected for the parameters detailed below. By default, this alert is raised ONLY if a previously detected network link is broken.

LinkStatus

The LinkStatus parameter shows the current status of the network interface to the network (i.e.

DuplexMode

Monitoring network cards communication performance may be critical to ensure that they run at the expected speed in order to avoid network congestion or any other performance issues.

Most Ethernet cables allow communication in both directions simultaneous between two connected cards, this feature is commonly named "full duplex". However, a defective cable or a simple internal malfunction within the cards can prevent them from communicating both ways simultaneously. In that case, once a party begins receiving a signal, it must wait for the transmitter to stop transmitting, before replying. This communication mode is typically called "half-duplex" and can generate network congestion.

User Guide

166

Hardware Sentry KM for PATROL

Version 1.8.01

The DuplexMode parameter's value is set to 0 when the network adapter is running in "half-duplex" mode and 1 when in "full-duplex" mode. By default, the DuplexMode parameter triggers a WARNING when an adapter that was running in "full-duplex" suddenly starts communicating in "half-duplex".

LinkSpeed

The LinkSpeed parameter reports the speed that the network adapter and its remote counterpart currently use to communicate with each other. Note that the unit of this parameter is Mbits/sec.

To change the default setting and select when these alerts should be raised, right-click on the

Hardware icon > KM Commands > This System's Settings > Network Link Alerts:

Ne twork Link A le rts

User Guide

167

Hardware Sentry KM for PATROL

Version 1.8.01

Notifying Internal KM Issues

Internal KM Issues Notification was previously known as the KM command Internal Message Notification and prior to that as Show/Hide Information Messages.

This notification feature enables Hardware Sentry to inform you of any internal problems that may occur or any special operations it may perform. The objective of this notification is to help resolve an issue (if any), other than hardware problems – which are reported through the regular system of warnings and alerts. This feature is useful to find out more about any anomalies that may occur.

By right clicking on Hardware icon > KM Commands > KM Settings > Additional Settings >

Internal KM Issues Notification, you can set the kind of messages you would like to be notified about:

All internal messages

Only internal problems

No internal message

Inte rna l KM Issue s Notifica tion

User Guide

168

Hardware Sentry KM for PATROL

Version 1.8.01

By default, all internal messages are sent to the System Output Window and are also registered as

PATROL events (event ID "HardwareSentryInternal" of the MS_HW_MAIN event catalog).

Internal errors are registered as ev ents ty pe "ERROR" (they appear in orange in PA TROL Ev ent Manager).

Internal warnings are registered as "W A RNING"

Informational messages are registered as "INFORMA TION".

Managing Unknown Status

At times, although rare, Hardware Sentry is unable to detect the status of a monitored device, and it returns the poll with "Unknown Status".

If this occurs, you can configure Hardware Sentry to perform certain actions:

Set the Status parameter to OK (default)

Ignore value and do not feed parameter

Trigger a WARNING on the Status parameter

Trigger an ALARM on the Status parameter

To access this feature, right-click the Hardware icon > KM Commands > KM Settings >

Additional Settings > Unknown Status Management:

Unknown Sta tus Ma na ge m e nt

In addition to the selected actions, if you select the option to Trigger an Internal KM Issue

Notification, an error message is displayed in the System Output Window of the PATROL console.

User Guide

169

Hardware Sentry KM for PATROL

Version 1.8.01

Reference Guide

This manual provides the following detailed chapters:

Classes and Parameters

: Parameters, info boxes and menu commands for each application class

Connectors and Platforms

: supported platforms, instrumentation agents or system tools they require as well as the connectors that are used to monitor them. Details are given for each connector and show all the components discovered and monitored through them.

Configuration Variables

: global and host-specific variables that can be used.

Classes and Parameters

This section lists the application classes of Hardware Sentry. It gives you details on the icons that represent the class, Infobox, parameters and the menu commands available for each application class.

There are 23 main application classes and 18 “container” classes. The container classes have no parameters.

Parameters discov ered depend on the ty pe of managed element. To see which parameters are discov ered on y our managed sy stems, please refer to the C onnectors and Platforms Reference Table and then the corresponding topic in the C onnectors and Platform-specific Details section to learn about the parameters discov ered for each serv er.

Baselines and Key Performance Indicators

Some parameters are identified by default as Key Performance Indicators (KPIs) and therefore automatically included in the base lining calculation. To learn more about auto baselining and KPIs,

please refer to the Managing Baselines and Key Performance Indicators chapter.

In this guide, parameters flagged as KPIs and included by default in the baseline calculation process are respectively identified by the following icons:

Baselining

KPI

Reference Guide

170

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_BATTERY

MS_HW_BATTERY can be a children of MS_HW_ENCLOSURE and MS_HW_DISKCONTROLLER.

Icon

Parameters

Parameter

Charge

Status

Missing (*)

StatusInformation

Description

Percentage of the battery charge.

When the battery is no longer discovered, the parameter goes into alarm.

Battery Status.

Additional (textual) information about the current status of the battery.

Unit Default

Alert

Thresholds

Type

% Warning ≤ 50

Alarm ≤ 30

Statistics

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

Availability {0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a

None

For detailed information about B a se lining and K P I, see

Managing Baselines and Key Performance Indicators .

(*) The “Missing” parameter is dy namically activ ated only when the monitored component goes missing. A s long as the monitored component is properly discov ered and monitored, the “Missing” parameter cannot be display ed in the console. W hen the “Missing” parameter is activ ated, its v alue is alway s ‘1’, which triggers an alarm; unless y ou

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

Battery Information

Manufacturer

Model

Type

Description

The device's PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

Name of the battery manufacturer

Details about the model of the battery

Details about the type of battery

Chemistry

Device ID

Chemistry type contained in the battery

ID of the monitored object as communicated by the instrumentation layer

Reference Guide

171

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the device

PATROL ID of the connector currently used to monitor the device

File name of the connector currently used to monitor the device

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored blade (properties of the object, its parameters, thresholds, etc.)

Pauses the Blade monitoring

Resumes the Blade monitoring after it has been paused

Removes the Blade from the monitoring environment

Refreshes all parameters of the application class

MS_HW_BATTERY_CONT

Icon

Parameters

None

InfoBox

None

Menu Commands

Function Description

Pause Monitoring

Resume Monitoring

Remove

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Reference Guide

172

Hardware Sentry KM for PATROL

Version 1.8.01

Function

Description

Refreshes all parameters of the application class

MS_HW_BLADE

Each instance of the MS_HW_BLADE class represents a blade server inside a blade enclosure.

Icon

Parameters

Parameter

Missing (*)

Status

StatusInformation

Description

When the blade is no longer discovered, the parameter goes into alarm

Blade Status.

Value set by bladeColl every 2 minutes.

Additional (textual) information about the current status of the battery.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

Blade Information

Name

Model

Device ID

Connector Information

Connector Display Name

Description

The blade’s PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

Name of the blade

Blade model

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the blade

Reference Guide

173

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL ID of the connector currently used to monitor the blade

File name of the connector currently used to monitor the blade

Version number of the connector

Connector build date

Menu Commands

Function

Managing Baselines and Key Performance Indicators .

Description

Displays a text box recapitulating miscellaneous information regarding the monitored blade (properties of the object, its parameters, thresholds, etc.)

Pauses the Blade monitoring

Resumes the Blade monitoring after it has been paused

Removes the Blade from the monitoring environment

Refreshes all parameters of the MS_HW_BLADE application class

MS_HW_BLADE_CONT

Icon

Parameters

None

InfoBox

None

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of the application class

Reference Guide

174

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CAPACITYREPORT

Icon

Parameters

Parameter

CPUCount

Description

Host total number of physical processors (CPU)

Unit

CPUs

Type

Statistics

ConnectedPorts

DegreesBelowWarning

LogicalDiskSize

MemorySize

PhysicalDiskSize

PowerConsumption

UnallocatedDiskSpace

Number of connected ports.

Number of degrees before reaching the closest warning threshold.

Host total logical disk size

Host total memory (RAM)

Host total physical disk size

Power consumed by the host ports degrees

Celsius

Watts

Statistics

Host Total available disk space that is not allocated to any volume Gigabyte

(GB)

Statistics

For detailed information about B a se lining and K P I, see

InfoBox

None.

Menu Commands

Function

Description

Refreshes all parameters of the application class

Reference Guide

175

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CONNECTOR

Each instance of the MS_HW_CONNECTOR class represents a connector currently being used by

Hardware Sentry in order to discover and monitor the hardware components of the server.

Connectors are continuously monitored to ensure that the underlying technology being used by

Hardware Sentry to discover and monitor the hardware is always available.

If something goes wrong with the hardware instrumentation layer (but not with the hardware itself), an alert is raised by the Status parameter of the corresponding MS_HW_CONNECTOR instance. In such case, hardware components that were discovered and monitored through this connector are no longer monitored. Check the TestReport parameter to have more details about the connector failure.

Icon

Parameters

Parameter

Status

TestReport

Description

Connector Status.

Value set by connectorColl every 2 minutes

Text describing the tests that have been performed to evaluate the status of the connector.

Value set by connectorColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a n/a

Collection

Status

InfoBox

Name

PATROL ID

Connector Display Name

Connector ID

Connector File Name@r by

<remote hostname"e name followed byt

Connector File Path

Connector Version

Connector Date

Description

PATROL internal identifier for the connector. This ID is used for PATROL event reporting etc.

Connector name as displayed in the console

PATROL ID of the connector

Name of the connector file i.e. the full HDF filename

Path to the connector file (*.HDF)

Version number of the connector

Connector build date

Reference Guide

176

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector Description

Description

Description of the connector, what it does and how…

Menu Commands

Name

Description

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring. May mean that the connector will not be used anymore to monitor the computer.

Refreshes all instance parameters of the application class

Reference Guide

177

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CONNECTOR_CONT

This class is simply used to create a container for Connector for display purposes. It does not contain a parameter or infobox but provides an easy way to interact with all Connectors at the same time.

Icon

W hen the connectors hav e been manually "pre-selected", the icon is labeled "Pre-selected connectors" instead of

"Detected connectors".

Parameters

None

InfoBox

None

Menu Commands

Name Description

Pause

Resume Monitoring

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Refreshes all the device Container dependencies

Reference Guide

178

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CPU

Each instance of the MS_HW_CPU class represents a physical processor of the server. On highest-range servers, the Status parameter will raise an alert "on the fly" as soon as a processor fails. On most servers however, a failed processor causes a server crash. Upon reboot, the processor is likely to be automatically disabled by the BIOS which will then raise an alert in Hardware Sentry because the processor is "missing".

The CorrectedErrorCount and PredictedFailure parameters (available only for a few high-end processors) will help administrators intervene even before such a crash occurs.

Icon

Parameters

Parameter

CorrectedErrorCount

CurrentSpeed

Missing (*)

PredictedFailure

Status

StatusInformation

Description Unit Default

Alert

Thresholds

Type

Number of detected and corrected errors.

Value set by cpuColl every 2 minutes.

CPU speed.

When the physical processor is no longer discovered, the parameter goes into alarm errors None

MHz

{0 =

Present;

1 =

Missing}

None

1 = Alarm

Statistics

Availability

This parameter will trigger a warning if a CPU failure is predicted to happen.

Value set by cpuColl every 2 minutes.

CPU Status.

Value set by cpuColl every 2 minutes.

{0 = OK;

1 =

Failure predicte d}

1 = Warning Availability

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm

Availability

Additional (textual) information about the current status of the CPU.

n/a None --

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Reference Guide

179

Hardware Sentry KM for PATROL

Version 1.8.01

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

CPU Information

Manufacturer

Model

Speed

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for the monitored CPU. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the processor manufacturer

Model name of the processor

States the speed of the processor

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the CPU

PATROL ID of the connector currently used to monitor the CPU

File name of the connector currently used to monitor the CPU

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring.

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class

Reference Guide

180

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CPU_CONT

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of all the device container dependencies

MS_HW_CPUCORE

MS_HW_CPUCORE can be a child of MS_HW_CPU only.

Icon

Parameters

Parameter

Missing

(*)

Description

When the CPU Core is no longer discovered, the parameter goes into alarm.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

Reference Guide

181

Hardware Sentry KM for PATROL

Version 1.8.01

Status CPU Core Status.

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

-StatusInformation

UsedTimePercent

Additional (textual) information about the current status of the CPU Core.

Percentage of the CPU Core usage.

The "Used Time Percent" parameter is calculated as: (UsedTime - LastUsedTime) /

(currentTime - lastTime) *100

Percent

(%)

---

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

CPU Core Information

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

The device's PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the device

PATROL ID of the connector currently used to monitor the device

File name of the connector currently used to monitor the device

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

Reference Guide

182

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_CPUCORE_CONT

Icon

Parameters

None.

InfoBox

None.

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device from the monitoring environment

Refreshes all parameters of the device container dependencies

Reference Guide

183

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_DISKCONTROLLER

A disk controller is a card inside a computer that connects one or several physical disk drives to this computer. Some intelligent disk controllers (such as RAID controllers) manage several physical disks as a single logical disk which is the only disk exposed to the operating system. Monitoring both physical and logical disks is essential to ensure that the storage is available.

The purpose of the Disk controller instance is to act as a container for Logical Disks and Physical Disks monitoring, and symbolize the way hard drives are setup on the platform.

Please note, however, that if a controller goes missing, all its disk dependencies will be missing as well.

In addition, some information regarding the Disk Controllers, like their brand, model or driver version, is displayed in their infobox.

Icon

Parameters

Parameter

BatteryStatus

ControllerStatus

Missing (*)

StatusInformation

Description Unit Default

Alert

Thresholds

Type

Availability This parameter triggers an alert to predict that the disk controller battery will be unable to support the controller in the event of a power failure. Value set by diskcontrollerColl every 2 minutes.

Additional (textual) information about the current status of the Disk Controller.

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm

This parameter displays the status of the disk controller.

Value set by diskcontrollerColl every 2 minutes.

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm

When the disk controller is no longer discovered, the parameter goes into alarm

{0 =

Present;

1 =

Missing} n/a

1 = Alarm

None

Availability

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Reference Guide

184

Hardware Sentry KM for PATROL

Version 1.8.01

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Disk Controller Information

Manufacturer

Model

BIOS Version

Firmware Version

Driver Version

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for the monitored disk controller. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the disk controller manufacturer

Model details of the disk controller

BIOS version details

Disk controller’s firmware version

Disk controller’s driver version

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the disk controller

PATROL ID of the connector currently used to monitor the disk controller

File name of the connector currently used to monitor the disk controller

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, etc.)

Pauses the device monitoring.

Resumes the device monitoring after it has been paused.

Removes the device object from monitoring.

Refreshes all instance parameters of the application class.

Reference Guide

185

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_DISKENCLOSURE

Icon

Parameters

Parameter

IntrusionStatus

Missing

Status

Description

This parameter will trigger an alarm if the enclosure is open or not properly closed.

Value set by enclosureColl every 2 minutes.

When the disk enclosure is no longer discovered, the parameter goes into alarm.

Enclosure Status.

Value set by enclosureColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

Availability {0 = OK;

2 =

Intrusion

Detected

}

1 = Warning

2 = Alarm

{0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm

Availability

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Enclosure Information

Manufacturer

Model

Type

Serial Number

BIOS Version

Device ID

Connector Information

Connector Display Name

Connector ID

Description

PATROL internal identifier for the enclosure/chassis. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the enclosure/chassis manufacturer

Enclosure model details

Details about the type of enclosure/chassis

Serial number of the enclosure/chassis

BIOS version details

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the enclosure/chassis

PATROL ID of the connector used to monitor the enclosure/chassis

Reference Guide

186

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector File Name

Connector Version

Connector Date

Description

File name of the connector currently used to monitor the enclosure/chassis

Version details of the connector

Connector build date

Menu Commands

Function

Managing Baselines and Key Performance Indicators .

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

MS_HW_ENCLOSURE

Basically, each MS_HW_ENCLOSURE instance represents a box with some hardware components inside.

This class is used to represent the computer’s main chassis, but also external disk array enclosures or blade enclosures.

Icon

Parameters

Parameter

IntrusionStatus

Missing (*)

PowerConsumption

Description

This parameter will trigger an alarm if the enclosure is open or not properly closed.

Value set by enclosureColl every 2 minutes.

When the disk array is no longer discovered, the parameter goes into alarm

This parameter reports the electricity consumption.

Unit Default

Alert

Thresholds

Type

Availability {0 = OK;

2 =

Intrusion

Detecte d}

2 = Alarm

{0 =

Present;

1 =

Missing}

1 = Alarm

Watts None

Availability

Statistics

Reference Guide

187

Hardware Sentry KM for PATROL

Version 1.8.01

Status Enclosure Status.

Value set by enclosureColl every 2 minutes.

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

StatusInformation Additional (textual) information about the current status of the Disk Controller.

For detailed information about B a se lining and K P I, see

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Enclosure Information

Manufacturer

Model

Type

Serial Number

BIOS Version

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for the enclosure/chassis. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the enclosure/chassis manufacturer

Enclosure model details

Details about the type of enclosure/chassis

Serial number of the enclosure/chassis

BIOS version details

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the enclosure/chassis

PATROL ID of the connector used to monitor the enclosure/chassis

File name of the connector currently used to monitor the enclosure/chassis

Version details of the connector

Connector build date

Menu Commands

Function

Acknowledge IntrusionStatus

Alert

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Allows you to acknowledge and clear the alert triggered by the IntrusionStatus parameter

Reference Guide

188

Hardware Sentry KM for PATROL

Version 1.8.01

Function

Description

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

MS_HW_FAN

To avoid too high temperatures, system vendors install fans on critical devices (processors, power supplies, etc.). Monitoring fans is important because they ensure a proper temperature for the system to work efficiently.

Depending on the available information, the following parameters will be displayed for each detected fan device:

The Missing parameter represents the availability of the fan. An alert is triggered if the fan is no longer discovered

The Speed parameter represents the speed of the corresponding fan (in rotations/minute).

The SpeedPercent parameter represents the speed of the corresponding fan in percentage of its maximal speed.

The Status parameter represents the current status of the fan. An alert is triggered if the fan stops spinning or does not spin fast enough

The StatusInformation parameter gives additional information about the current status of the fan.

Icon

Reference Guide

189

Hardware Sentry KM for PATROL

Version 1.8.01

Parameters

Parameter

Missing (*)

Description

When the fan is no longer discovered, the parameter goes into alarm

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

RPM

1 = Alarm

Automatic Statistics Speed

SpeedPercent

Status

Fan Speed.

Value set by fanColl every 2 minutes

Fan Speed as a percentage of its maximal speed.

Value set by fanColl every 2 minutes.

Fan Status.

Value set by fanColl every 2 minutes

% of maximum speed

Automatic

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Statistics

Availability

-StatusInformation Additional (textual) information about the current status of the fan.

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Fan Information

Location

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

The fan’s PATROL internal identifier that will be reported in events etc. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Location of the fan

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the fan

PATROL ID of the connector currently used to monitor the fan

File name of the connector currently used to monitor the fan

Version details of the connector

Connector build date

Reference Guide

190

Hardware Sentry KM for PATROL

Version 1.8.01

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring.

Resumes the device monitoring after it has been paused.

Removes the device object from monitoring.

Refreshes all parameters of the application class.

MS_HW_FAN_CONT

This class is simply used to create a container for Fans for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Fans at the same time.

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes parameters of all the device container dependencies

Reference Guide

191

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_LED

MS_HW_LED instances can be children of MS_HW_ENCLOSURE only.

Icon

Parameters

Parameter

Color

Missing

(*)

Status

StatusInformation

Description

Color of the LED.

When the led is no longer discovered, the parameter goes into alarm

Led Status.

Additional (textual) information about the current status of the LED.

Unit Default

Alert

Thresholds

Type

Availability {0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm

{0 =

Present;

1 =

Missing}

1 = Alarm

{0 =

Off; 1 =

Blinking;

2 = On} n/a

1 = Warning

2 = Alarm

None

Availability

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

LED Information

Name

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Description

The device's PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

Name of the LED

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the device

PATROL ID of the connector currently used to monitor the device

File name of the connector currently used to monitor the device

Reference Guide

192

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector Version

Connector Date

Description

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

MS_HW_LED_CONT

Icon

Parameters

None.

InfoBox

None.

Reference Guide

193

Hardware Sentry KM for PATROL

Version 1.8.01

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of the device container dependencies

MS_HW_LOGICALDISK

!AL("Disk monitoring",0,`',`')RAID or advanced disk controllers expose several physical disks as a single logical disk to the operating system. The status of a logical disk typically corresponds to the status of a

RAID array (on-line, degraded, rebuilding, etc.). For each logical disk discovered, the Status parameter is displayed. An alert is triggered when the logical disk is not full operational (degraded, rebuilding, etc.) or not available at all.

Icon

For non-RA ID disk controllers (as most of IDE controllers, for ex ample), no logical disk will be display ed.

Parameters

Parameter

ErrorCount

Missing (*)

Status

StatusInformation

Description Unit Default

Alert

Thresholds

Type

None Statistics Number of errors encountered by the physical disk.

Value set by physical DiskColl every 2 minutes.

When the logical disk is no longer discovered, the parameter goes into alarm

Errors

Logical Disk status.

Value set by logicalDiskColl every 2 minutes.

Additional (textual) information about the current status of the logical disk.

{0 =

Present;

1 =

Missing}

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Alarm

1 = Warning

2 = Alarm n/a None

Availability

Reference Guide

194

Hardware Sentry KM for PATROL

Version 1.8.01

UnallocatedSpace Amount of unused disk space in the logical disk (i.e. not allocated to the higher layer or the operating system).

GB None Statistics

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Logical Disk Information

Manufacturer

RAID Type

Size

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for the monitored logical disk. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the manufacturer

Details on the type of RAID

Maximum capacity of the logical disk

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the logical disk

PATROL ID of the connector currently used to monitor the logical disk

File name of the connector currently used to monitor the logical disk

Version details of the connector

Connector build date

Menu Commands

Function

Acknowledge Error Count

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Acknowledges the alert, and resets the error counter to zero. Available only if the

ErrorCount parameter is collected (platform-dependent)

Pauses the device monitoring.

Resumes the device monitoring after it has been paused.

Removes the device object from monitoring.

Refreshes all instance parameters of the application class.

Reference Guide

195

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_LOGICALDISK_CONT

This class is simply used to create a container for Logical Disks for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Logical Disks at the same time.

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent devices from the monitoring environment

Refreshes the parameters of the device container dependencies

Reference Guide

196

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_LUN

Icon

Parameters

Parameter

AvailablePathCount

Description

Number of distinct paths available to the remote volume

Unit

paths

Default

Alert

Thresholds

Type

Warning when downgrades or fewer than expected.

Alarm when 0

Availability n/a -AvailablePathInformation

Missing

Status

(*)

Textual information about the paths to the remote volume

When the remote volume is no longer discovered, the parameter goes into alarm

Availability of the remote volume n/a

{0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a n/a

Availability

-StatusInformation Additional (textual) information about the current status of the volume

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

WWN

Local Device Name

Remote Device Name

Array Name

Description

WNN address of the disk array on the SAN.

Name of the device locally accessed

Name of the device remotely accessed

Name of the disk array

Reference Guide

197

Hardware Sentry KM for PATROL

Version 1.8.01

Menu Commands

Function

Settings > Unknown Status

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device from the monitoring environment

Refreshes all parameters of the application class

MS_HW_LUN_CONT

Icon

Parameters

None.

InfoBox

None.

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of the device container dependencies

Reference Guide

198

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_MAIN

There is only one instance of the MS_HW_MAIN class which is the main Hardware icon from which you can configure the product. All collectors are attached to this class.

Icon

Parameters

None.

InfoBox

Name

Product

Version

Release Date

Web Site

Support

Description

Name of the product.

Current version of the product.

Release date of the current version of the product.

Web site address

Support contact information

Menu Commands

Function Description

KM Settings

KM Settings >

KM Settings >

Displays all the command options for different monitoring settings

Enables you to select the Alert Actions (different methods of notification) to be executed by Hardware Sentry when a parameter breaches its threshold

Enables/Disables missing device detection. By default, Hardware Sentry detects

"missing devices" i.e. devices previously monitored but which have disappeared during the monitoring or after a reboot or due to some other cause

Allows you to decide when an intrusion detection alert for the enclosure/ systems chassis should be raised. The IntrusionStatus parameter of each enclosure object discovered by Hardware Sentry reports whether or not the chassis has been opened, and triggers an alarm as per user settings.

KM Settings >

KM Settings >

Enables you to schedule the automatic reset of the ErrorCount parameter of a specific device.

Enables you to customize the discovery cycle. By default, discovery is performed every hour

KM Settings >

Polling Interval

Enables you to customize the polling cycle. By default, the polling interval is done every

2 minutes

KM Settings >

Java Settings

KM Settings >

Debug

Enables you to define which Java instance is to be used by Hardware Sentry

Activates or deactivates the debug mode.

Reference Guide

199

Hardware Sentry KM for PATROL

Version 1.8.01

Function

KM Settings > Additional

Settings

KM Settings > Additional

Settings > Threshold

Mechanism Selection

Description

Enables you to perform additional settings such as restoring device monitoring, displaying settings for UNIX Console and enabling/disabling debug mode.

Allows you to select the threshold mechanism:

Automatic (by default): Hardware Sentry determines the mode of threshold management best suited to the system. The different modes are:

Tuning: Hardware Sentry uses the internal PATROL mechanism to set thresholds

PCM/Event Management: Hardware Sentry automatically sets thresholds through

PCM/Event Management

No thresholds: Hardware Sentry does not set any thresholds and lets you specify them manually.

Enables you to set actions to be performed when Hardware Sentry is unable to detect the status of a monitored device.

KM Settings > Additional

Management

KM Settings > Additional

Settings > Restore Device or

Sensor Monitoring

KM Settings > Additional

Settings

> Display Settings for Unix

Consoles

KM Settings > Additional

Settings > Internal KM Issues

Notification

This System’s Settings

Brings up the "Restore Device or Sensor Monitoring" wizard to restore one or several objects after their monitoring has been stopped

Gives you the option to turn on the UNIX console mode and modify all object labels to fit the PATROL UNIX Console label size.

Allows you to enable/disable and select the type of information messages displayed by

Hardware Sentry in the system output window of the PATROL Console.

Allows you to set the system properties and credentials and connectors be used for monitoring

Allows you to set the properties and credentials or the security settings (SNMP string) or the account used by Hardware Sentry to launch external commands.

This System’s Settings >

Connection, Credentials and

Connectors

KM Settings >

Network Link

Alerts

This System’s Settings >

Default Power Wattage

Trigger a Discovery

Allows you to choose the monitoring/alert settings for the network link status.

Allows you to manually enter the electricity consumption for a specific device.

Remove this System

Add a Remote System or an

Reporting > Ethernet/Fiber

Port Traffic Report

Reporting > Energy Usage

Pause Monitoring

Enables you to trigger a forced discovery and rediscover the hardware devices on the monitored host.

Removes the remote system added to the monitoring.

Enables you to monitor another system or an external device remotely using either

SNMP or WMI.

Provides access to various hardware inventory and reports.

Instantly generates a hardware health report for the entire managed system

Enables you to schedule automated hardware inventory on an hourly, daily, weekly or monthly basis.

Enables you to generate a report showing usage statistics returned by a specific ethernet/fiber port

Provides the energy consumption for hardware components.

Pauses the Hardware Sentry KM for PATROL.

Reference Guide

200

Hardware Sentry KM for PATROL

Version 1.8.01

Function

Resume Monitoring

Reinitialize KM

About

Description

Resumes the monitoring of all objects after it has been paused.

Triggers a complete re-initialization of Hardware Sentry. Customized settings are lost unless specified otherwise in the Reinitialize wizard.

States basic product information and BMC Software support contact information.

MS_HW_MEMORY

Each instance of the MS_HW_MEMORY module represents a memory module in the server.

The Status parameter will raise an "on the fly" alert on servers that can dynamically handle failed memory modules or, most often, for modules that have been disabled by the BIOS upon reboot (the module is then flagged as "missing").

The ErrorCount parameter represents the number of errors that have been fixed by ECC-enabled memory modules. Sometime the number of detected errors cannot be shown and the ErrorStatus parameter is used instead to raise an alert when too many errors have been detected and corrected, meaning that the memory module is about to fail.

In some case, the PredictedFailure parameter is used to alert administrators that the memory module is about to fail. The use of the ErrorCount, ErrorStatus or PredictedFailure parameter highly depends on the technology being used to report the health of memory modules.

Icon

Parameters

Parameter

ErrorCount

ErrorStatus

Missing

(*)

Description Unit Default Alert

Thresholds

1 = Warning Number of detected (and possibly, corrected) errors.

Value set by memoryColl every 2 minutes.

errors

This parameter will trigger an alert if the number of memory errors reaches a threshold set by the manufacturer’s agent.

Value set by memoryColl every 2 minutes.

When the memory module is no longer discovered, the parameter goes into alarm

{0 = No

Errors; 1 =

Detected

Errors; 2 =

Too Many

Errors}

1 = Warning

2 = Alarm

{0 =

Present; 1 =

Missing}

1 = Alarm

Type

Statistics

Availability

Reference Guide

201

Hardware Sentry KM for PATROL

Version 1.8.01

PredictedFailure This parameter will trigger a warning if a

Status memory failure is predicted to happen.

Value set by memoryColl every 2 minutes.

Memory Status.

Value set by memoryColl every 2 minutes.

{0 = OK; 1

= Failure

Predicted}

{0 = OK; 1

Degraded; 2

= Failed}

1 = Alarm

1 = Warning

2 = Alarm n/a None

Availability

StatusInformati on

Additional (textual) information about the current status of the memory.

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

Connector Display Name

Connector File Name

Description

Memory module’s PATROL internal identifier. This ID is used for PATROL event reporting etc.

Display name of the Connector currently used to monitor the Memory module.

File name of the Connector currently used to monitor the Memory module.

Menu Commands

Function

Managing Baselines and Key Performance Indicators .

Acknowledge Error Counts

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Acknowledges the alert and resets the error count to zero

Pauses the device monitoring.

Resumes the device monitoring after it has been paused.

Removes the device object from monitoring.

Refreshes all instance parameters of the application class.

Reference Guide

202

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_MEMORY_CONT

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the depending Memory modules of the selected container.

Resumes the monitoring of all the depending Memory modules of the selected container.

Removes the Memory container object as well as all its depending Memory modules from monitoring.

Refreshes all the Memory container dependencies.

Reference Guide

203

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_NETWORK

Each MS_HW_NETWORK instance represents a network adapter in the server.

The LinkStatus parameter reports whether the adapter is properly linked to the network or not from a pure hardware cable perspective (it will not report a bad IP configuration for example). By default, the

LinkStatus parameter raises an alert only for previously connected network adapters that are no longer linked to the network.

The ErrorPercent parameter represents the percentage of sent and received network packets that were in error. A high percentage of errors often means that the network link is improperly configured or that the network card is behaving badly and thus needs to be replaced.

Icon

Parameters

Parameter

BandwidthUtilization

DuplexMode

ErrorPercent

LinkSpeed

LinkStatus

Missing (*)

ReceivedBytesRate

ReceivedPacketsRate

Description Unit Default

Alert

Thresholds

Type

Statistics Percentage used of the available bandwidth.

% available bandwidt h

Automatic

Whether the port is configured to operate in half-duplex or full-duplex mode.

Automatic {0 =

Halfduplex;

1 = Full duplex}

% Automatic Transmitted and received packets in error as a percentage of all processed packets.

Value set by networkColl every 2 minutes.

Negotiated or configured link speed.

Mbits/s Automatic

1 = Alarm This parameter will trigger a warning if the network interface is not connected (i.e. no wire plugged-in).

Value set by networkColl every 2 minutes.

When the network adapters are no longer discovered, the parameter goes into alarm.

{0 =

Plugged;

1 =

Unplugg ed}

{0 =

Present;

1 =

Missing}

1 = Alarm

Received network traffic in megabytes per second.

Received network traffic in packets per second.

MB/s packets/ s

None

Availability

Statistics

Availability

Statistics

Reference Guide

204

Hardware Sentry KM for PATROL

Version 1.8.01

Status Network interface Status.

Value set by networkColl every 2 minutes.

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

StatusInformation

TransmittedBytesRate

Additional (textual) information about the current status of the network.

Emitted network traffic in megabytes per second.

Emitted network traffic in packets per second.

MB/s None

Statistics

TransmittedPacketsRate

Packets per second

None Statistics

ZeroBufferCreditPercent Percentage of zero buffer credits that occurred over the last polling interval.

None Statistics

For detailed information about B a se lining and K P I, see

Ethernet/Fiber Port Traffic

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

Connector Display Name

Connector File Name

Description

Network interface’s PATROL internal identifier. This ID is used for PATROL event reporting etc.

Display name of the Connector currently used to monitor the Network interface.

File name of the Connector currently used to monitor the Network interface.

Menu Commands

Function Description

Acknowledge Linkstatus Alert

Reports traffic on a given Ethernet/Fiber Port.

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.).

Acknowledges and clears the alert raised due to loss of a network link on this interface

(by default, Hardware Sentry will not trigger another alert until the Network interface is plugged-in and unplugged)

Pause Monitoring

Pauses the Network interface monitoring.

Resume

Monitoring

Remove

Ethernet/Fiber Port Traffic

Resumes the Network interface monitoring after it has been paused.

Removes the Network interface object from monitoring.

Refreshes all instance parameters of the application class.

Reference Guide

205

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_NETWORK_CONT

Icon

Parameters

None.

InfoBox

None.

Menu Commands

Function

Description

Reports traffic on a given Ethernet/Fiber port.

Pauses the monitoring of all the depending Network interfaces of the selected container.

Resumes the monitoring of all the depending Network interfaces of the selected container.

Removes the Network interface container object as well as all its depending Network interfaces from monitoring.

Refreshes all the Network interface container dependencies.

Reference Guide

206

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_OTHERDEVICE

MS_HW_OTHERDEVICE instances represent hardware components that do not fall into other predefined categories (processors, memory modules, temperature sensors, fans, voltage sensors, power supplies, network cards, disk controllers, physical disks and logical disks).

Icon

Parameters

Parameter

Missing (*)

Status

StatusInformation

UsageCount

Description

When the device is no longer discovered, the parameter goes into alarm

Device Status.

Value set by otherDeviceColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

-Additional (textual) information about the current status of the other devices.

Number of times the device has been used.

Device value.

Times used n/a

Automatic

Statistics

Statistics Value

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

Connector Display Name

Connector File Name

Description

Other Device’s PATROL internal identifier. This ID is used for PATROL event reporting etc.

Display name of the Connector currently used to monitor the Other Device

File name of the Connector currently used to monitor the Other Device

Reference Guide

207

Hardware Sentry KM for PATROL

Version 1.8.01

Menu Commands

Function

Description

Pauses the Other Device monitoring

Resumes the Other Device monitoring after it has been paused

Removes the Other Device from monitoring

Refreshes all instance parameters of the application class

Displays a text box recapitulating miscellaneous information regarding the monitored device

(properties of the object, its parameters, thresholds, etc.)

MS_HW_OTHERDEVICE_CONT

This class is simply used to create a container for Other Devices for display purpose. It contains no parameter or infobox but provides and easy way to interact with all other Devices at the same time.

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Resume

Description

Pauses the monitoring of all the depending Other Devices of the selected Container

Resumes the monitoring of all the depending Other Devices of the selected Container

Removes the "Other Device" object as well as all its depending Other Devices from monitoring

Refreshes all the Other Devices Container dependencies

Reference Guide

208

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_PHYSICALDISK

Physical disks must be monitored to avoid loss of data, un-availabilities and performance degradation.

When available, the S.M.A.R.T. technology will be used to predict a disk failure before it occurs.

Depending on the available information, the PredictedFailure and/or Status parameters will be displayed for each discovered physical disk:

The PredictedFailure parameter uses the S.M.A.R.T. technology to predict physical disk failures.

An alert will be triggered if it is predicted that the Physical Disk will soon break down.

The Status parameter represents the current status of the physical disk. An alert is triggered if the physical disk is not available for proper operation.

Icon

Parameters

Parameter Description Unit Default

Alert

Thresholds

Type

Automatic Statistics ErrorCount

DeviceNotReadyErrorCount

MediaErrorCount

NoDeviceErrorCount

HardErrorCount

IllegalRequestErrorCount

Number of errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

errors

Number of not ready device errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

errors errors Number of media errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

Number of no device errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

errors

Number of hard errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

errors

Number of illegal request errors that the disk has encountered since the last reinitialization, or since the last manual reset.

errors

Alarm ≥ 1

None

Statistics

Reference Guide

209

Hardware Sentry KM for PATROL

Version 1.8.01

RecoverableErrorCount

TransportErrorCount

Missing

PredictedFailure

Status

(*)

StatusInformation

Value set by physicalDiskColl every 2 minutes.

Number of recoverable errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

errors errors Number of transport errors that the disk has encountered since the last reinitialization, or since the last manual reset.

Value set by physicalDiskColl every 2 minutes.

When the physical disk is no longer discovered, the parameter goes into alarm

{0 =

Present;

1 =

Missing}

Informs if a failure is predicted.

Value set by physicalDiskColl every 2 minutes.

Physical Disk status.

Value set by physicalDiskColl every 2 minutes.

Additional (textual) information about the current status of the physical disk.

None

Alarm ≥ 1

1 = Alarm

{0 = OK;

1 =

Failure

Predicte d}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Statistics

Availability

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Physical Disk Information

Manufacturer

Size

Serial Number

Device ID

Connector Information

Connector Display Name

Description

PATROL internal identifier for the physical disk. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Name of the physical disk manufacturer

Maximum storage capacity of the physical disk

Serial number of the physical disk

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the physical disk

Reference Guide

210

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL ID of the connector currently used to monitor the physical disk

File name of the connector currently used to monitor the physical disk

Version details of the connector

Connector build date

Menu Commands

Function

Managing Baselines and Key Performance Indicators .

Acknowledge Error Count

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Acknowledges the alert and resets the error count to zero

Pauses the monitoring of the device

Resumes the monitoring after it has been paused

Removes the device from the monitoring environment

Refreshes all parameters of the application class

Reference Guide

211

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_PHYSICALDISK_CONT

This class is simply used to create a container for Physical Disks for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Physical Disks at the same time.

Icon

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent devices from monitoring

Refreshes all the device container dependencies

Reference Guide

212

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_POWERSUPPLY

The power supply is the component that transforms the AC Line into electric power needed by the computer. Therefore the power supply is a highly critical device of a computer that should never fail.

Because of that, many vendors build servers with redundant power supplies. Monitoring power supplies allows the operators to be alerted when a power supply fails, or even in some cases when a power supply is overloaded.

Depending on the available information, the UsedCapacity and/or Status parameters will be displayed for each power supply or power unit device:

The UsedCapacity parameter represents the power supply’s power currently in use in percentage.

An alert is triggered if the computer uses too much power than it can be supplied.

The Status parameter represents the current status of the power supply. An alert is triggered if an error occurs with the power supply.

Icon

Parameters

Parameter

Missing

(*)

Status

Description

When the power supply is no longer discovered, the parameter goes into alarm

Power Supply status.

Value set by powerSupplyColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

-StatusInformation

UsedCapacity

Additional (textual) information about the current status of the power supply.

Percentage of the Power Supply power currently in use if available.

Value set by powerSupplyColl every 2 minutes.

% Automatic Statistics

For detailed information about B a se lining and K P I, see

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Reference Guide

213

Hardware Sentry KM for PATROL

Version 1.8.01

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Power Supply Information

Type

Power

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for the power supply. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Type of power supply

Maximum power output

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the power supply

PATROL ID of the connector used to monitor the power supply

File name of the connector currently used to monitor the power supply

Version details of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the monitoring of the device object

Resumes the monitoring after it has been paused

Removes the device object from the monitoring environment

Refreshes all parameters of the application class

MS_HW_POWERSUPPLY_CONT

This class is used to create a container for Power Supplies for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Power Supplies at the same time.

Icon

Reference Guide

214

Hardware Sentry KM for PATROL

Version 1.8.01

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent device objects of the selected container

Resumes the monitoring of all the dependent device objects of the selected container

Removes the device container object as well as all its dependencies from the monitoring environment

Refreshes the parameters of all the device container dependencies

Reference Guide

215

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_ROBOTICS

MS_HW_ROBOTICS can be a child of MS_HW_ENCLOSURE only.

Icon

Parameters

Parameter

ErrorCount

Missing (*)

Move Count

Status

StatusInformation

Description

Number of moves in failure.

When the robotics is no longer discovered, the parameter goes into alarm

Number of moves performed by the robot.

Device Status

Additional (textual) information about the current status of the robotics.

Unit Default

Alert

Thresholds

Type

Automatic Statistics errors

{0 =

Present;

1 =

Missing} moves

1 = Alarm

None

Availability

Statistics

Availability {0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None --

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

Robotics Information

Manufacturer

Model

Serial Number

Type

Device ID

Identifying Information

Connector Information

Connector Display Name

Description

The device's PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

Name of the device manufacturer

Model of the device

Serial number identifying the device

Details about the type of device

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the device

Reference Guide

216

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL ID of the connector currently used to monitor the device

File name of the connector currently used to monitor the device

Version number of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

Reference Guide

217

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_ROBOTICS_CONT

Icon

Parameters

None.

InfoBox

None.

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of the device container dependencies

Reference Guide

218

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_TAPEDRIVE

MS_HW_TAPEDRIVE can be a child of MS_HW_ENCLOSURE and SEN_HW_DISKCONTROLLER.

Icon

Parameters

Parameter

ErrorCount

Missing (*)

MountCount

NeedsCleaning

Status

StatusInformation

Unmount Count

Description Unit Default

Alert

Thresholds

Type

Number of tape drive failures.

errors Automatic

When the tape drive is no longer discovered, the parameter goes into alarm

{0 =

Present;

1 =

Missing}

1 = Alarm

Number of mounts

Indicates whether the tapedrive needs cleaning.

Device status.

mounts None

{0 = OK;

1 =

Cleaning

Needed;

2 =

Cleaning

Needed

Immedia tely}

1 = Warning

2 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None Additional (textual) information about the current status of the tape drives.

Number of unmounts unmount s

None

Statistics

Availability

Statistics

Availability

Statistics

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

InfoBox

Name

PATROL ID

Tape Drive Information

Description

The device's PATROL internal identifier. This ID is used for PATROL event reporting etc.

Heading preceding the fields with information on the monitored device

Reference Guide

219

Hardware Sentry KM for PATROL

Version 1.8.01

Name

Manufacturer

Model

Serial Number

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

Name of the device manufacturer

Model of the device

Serial number identifying the device

Details about the type of device

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the device

PATROL ID of the connector currently used to monitor the device

File name of the connector currently used to monitor the device

Version number of the connector

Connector build date

Menu Commands

Function

Managing Baselines and Key Performance Indicators .

Description

Displays a text box recapitulating miscellaneous information regarding the monitored device (properties of the object, its parameters, thresholds, etc.)

Pauses the device monitoring

Resumes the device monitoring after it has been paused

Removes the device object from monitoring

Refreshes all instance parameters of the application class.

Reference Guide

220

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_TAPEDRIVE_CONT

Icon

Parameters

None.

InfoBox

None.

Menu Commands

Function Description

Pauses the monitoring of all the dependent devices of the selected container

Resumes the monitoring of all the dependent devices of the selected container

Removes the device container object as well as all its dependent objects from the monitoring environment

Refreshes all parameters of the device container dependencies

Reference Guide

221

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_TEMPERATURE

As any electronic devices, the chips and other components of a computer stop working when their temperature is getting too high (lots of unrecoverable errors, crashes and even hardware hurt). This temperature may get too high when the device is abnormally overloaded, when a fan is not working properly or when the ambient temperature is too hot. Monitoring the temperatures of the critical devices of your system allows you to take action before a crash occurs.

Depending on the available information, the Temperature and/or Status parameters will be displayed for each detected temperature sensor:

The Temperature parameter represents the current temperature reading in Celsius degrees (°C).

An alert is triggered if the temperature gets too high.

The Status parameter represents the current status of the temperature. An alert is triggered if the temperature gets too high.

Icon

Parameters

Parameter

Missing

(*)

Status

Description

When the temperature sensor is no longer discovered, the parameter goes into alarm

Temperature status.

Value set by temperatureColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

-StatusInformation

Temperature

Additional (textual) information about the current status of the temperature.

Temperature reading.

Value set by temperatureColl every 2 minutes.

degrees

Celsius

Automatic Statistics

For detailed information about B a se lining and K P I, see

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Reference Guide

222

Hardware Sentry KM for PATROL

Version 1.8.01

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Temperature Sensor

Information

Location

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for temperature monitoring. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Location of the temperature sensor

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the temperature

PATROL ID of the connector used to monitor the temperature

File name of the connector currently used to monitor the temperature

Version details of the connector

Connector build date

Menu Commands

Function

Description

Displays a text box recapitulating miscellaneous information regarding the monitored

Temperature sensor (properties of the object, its parameters, thresholds, etc.)

Pauses the Temperature monitoring

Resumes the monitoring after it has been paused

Removes the Temperature object from the monitoring environment

Refreshes all parameters of the MS_HW_TEMPERATURE application class

MS_HW_TEMPERATURE_CONT

This class is used to create a container for Temperatures for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Temperatures at the same time.

Icon

Reference Guide

223

Hardware Sentry KM for PATROL

Version 1.8.01

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent Temperature objects of the selected container

Resumes the monitoring of all the dependent Temperature objects of the selected container

Removes the Temperature container object as well as all its dependent objects from the monitoring environment

Refreshes the parameters of all the Temperature container dependencies

Reference Guide

224

Hardware Sentry KM for PATROL

Version 1.8.01

MS_HW_VOLTAGE

Power supplies convert the AC line power into voltages and currents needed by the motherboard of the computer. The stability of the motherboard (and therefore of the overall computer) strongly depends on this power converter. Too low or too high voltages may lead to unpredictable system crashes.

Monitoring the value of the different voltages needed by the motherboard will help detecting system instability.

Depending on the available information, the following parameters will be displayed for each voltage sensor on the motherboard:

The Missing parameter represents the availability of the power converter. An alert is triggered when a power converter is no longer discovered

The Status parameter represents the current status of the voltage. An alert is triggered if the voltage output is too low for proper functioning.

The StatusInformation parameter gives additional information about the current status of the voltage.

The Voltage parameter represents the voltage output in milliVolts (mV). An alert is triggered if the voltage goes out of the proper range.

Icon

Parameters

Parameter

Missing (*)

Status

StatusInformation

Voltage

Description

When the power converter is no longer discovered, the parameter goes into alarm

Voltage status.

Value set by voltageColl every 2 minutes.

Unit Default

Alert

Thresholds

Type

Availability {0 =

Present;

1 =

Missing}

1 = Alarm

{0 = OK;

1 =

Degrade d; 2 =

Failed}

1 = Warning

2 = Alarm n/a None

Availability

-Additional (textual) information about the current status of the voltage.

Voltage reading.

Value set by voltageColl every 2 minutes.

mV Automatic Statistics

" settings. You can disable the missing dev ice detection mechanism in the settings of the KM.

Reference Guide

225

Hardware Sentry KM for PATROL

Version 1.8.01

Depending on y our sy stem, all parameters may not be used. Only one of the parameters may be v isible. This will not affect the proper monitoring of the dev ice.

InfoBox

Name

PATROL ID

Voltage Information

Type

Device ID

Connector Information

Connector Display Name

Connector ID

Connector File Name

Connector Version

Connector Date

Description

PATROL internal identifier for voltage. This ID is used for PATROL event reporting etc.

Heading preceding fields with information on the monitored device

Type of voltage monitored

ID of the monitored object as communicated by the instrumentation layer

Heading preceding fields with information on the connector used to monitor the device

Displays name of the connector currently used to monitor the voltage

PATROL ID of the connector currently used to monitor the voltage

File name of the connector currently used to monitor the voltage

Version details of the connector

Connector build date

Menu Commands

Function

Adaptec Storage Manager (DPT)

Description

Displays a text box recapitulating miscellaneous information regarding the monitored voltage sensor (properties of the object, its parameters, thresholds, etc.)

Pauses the Voltage monitoring

Resumes the Voltage monitoring after it has been paused

Removes the Voltage from the monitoring environment

Refreshes all parameters of the application class

MS_HW_VOLTAGE_CONT

This class is simply used to create a container for Voltages for display purpose. It contains no parameter or infobox but provides and easy way to interact with all Voltages at the same time.

Icon

Reference Guide

226

Hardware Sentry KM for PATROL

Version 1.8.01

Parameters

None

InfoBox

None

Menu Commands

Function

Description

Pauses the monitoring of all the dependent Voltage objects of the selected container

Resumes the monitoring of all the dependent Voltage objects of the selected container

Removes the Voltage container object as well as all its dependent objects from the monitoring environment

Refreshes the parameters of all Voltage container dependencies

Reference Guide

227

Hardware Sentry KM for PATROL

Version 1.8.01

Connectors and Platforms

This section deals with connectors provided with this version of Hardware Sentry KM for PATROL. Since in most cases, the KM works along with vendor-specific agents of the platforms to first collect information and then monitor hardware components, it provides specific connectors for practically all platforms/environments.

A table gives you a quick overview of these connectors with their corresponding file names and applicable environments (i.e. type of computers, servers, operating systems).

Next, the section deals with detailed information on each of these connectors - stating the target, typical platforms, the pre-requisites for Hardware Sentry KM for PATROL to function optimally, technology used, and what it will discover (stating precise application class names) and then, most importantly, what it will monitor.

In order to know all about the connectors for your systems, first identify your platforms/environments in the reference table, and then read the corresponding details.

Connectors Index

The following table shows all the connectors provided with this versions of Hardware Sentry KM for

PATROL. Each connector is a file with the .hdf extension and they are stored in: $PATROL_HOME/lib/

MS_HW_hdf directory.

Connector Name Connector File Typical platform

Operating System

Adaptec - StorMan - RAID

MS_HW_AdptStorManU nix.hdf

Sun Fire (x64)

Adaptec IOManager

MS_HW_IOManager.hd

MS_HW_DptStorageMa nager.hdf

MS_HW_AAC.hdf

Adaptec Storage Manager Web

Edition (AAC)

Brocade SAN Switch

MS_HW_BrocadeSwitch

.hdf

Fujitsu-Siemens

PRIMERGY

Fujitsu-Siemens

PRIMERGY

Fujitsu-Siemens

PRIMERGY

SAN Switches

Sun Solaris, Linux

Microsoft Windows, Linux

Storage Device

Cisco MDS9000 Series - SSH/

Telnet

Cisco UCS Manager (Blade, Fabric

Interconnect Switch)

MS_HW_CiscoTelnet.hd

MS_HW_CiscoUCSBlade

.hdf

Cisco MDS9000

Series FC switches

Cisco UCS

Data Domain Storage Appliance -

SNMP Agent

DataDirect Networks (DDN) Disk

Array - SNMP Agent

Dell CMC (Dell Chassis

Management Controller)

MS_HW_DataDomain.h

MS_HW_DDN.hdf

MS_HW_DellCMC.hdf

Data Domain

Storage Appliance

DDN Disk Array

Dell M1000E Chassis

Storage Device

N/A

Storage Device

N/A

228

Reference Guide

Hardware Sentry KM for PATROL

Version 1.8.01

Connector Name Connector File Typical platform

Operating System

Dell DRAC/MC (Dell Remote

Access Controller/Modular

Chassis)

MS_HW_DellDRACMC.h

Dell PowerEdge

Dell EqualLogic PS Series

Dell OpenManage Array Manager

MS_HW_Equallogic.hdf

Dell EqualLogic PS

Series Disk Systems

MS_HW_DellArrayMana ger.hdf

Dell PowerEdge

Dell OpenManage Server

Administrator

Dell OpenManage Storage

Manager

EMC Disk Arrays

MS_HW_DellOpenMana ge.hdf

MS_HW_DellStorageMa nager.hdf

MS_HW_EMCDiskArray.

hdf

Dell PowerEdge

Disk Array

Emulex HBAs (hbacmd)

Fibre Alliance SNMP Agent

(Switches)

Fujitsu-Siemens Management

Blade (FSC BX Blade Servers)

Fujitsu-Siemens Serverview

MS_HW_EmulexHbacmd

.hdf

Server with Emulex

HBAs

MS_HW_FibreAllianceS witch.hdf

SAN Switches

MS_HW_FujitsuSiemens

Blade.hdf

Fujitsu-Siemens BX

Blade Servers

Fujitsu-Siemens ServerView RAID

Agent

Fusion ioDrive (fio-status)

MS_HW_ServerviewNT.

hdf

Fujitsu-Siemens

PRIMERGY

MS_HW_FscRaid.hdf

MS_HW_FusionIO.hdf

Fujitsu-Siemens

PRIMERGY

All x86 based servers

Hitachi BladeSymphony Chassis

HP BladeSystem

HP BladeSystem - Telnet/SSH

Drive Array

Fiber Array

HBA

HP Insight Management Agent iLO

IDE Storage

Network

SCSI Storage

MS_HW_HitachiBladeSy mphony.hdf

Hitachi

BladeSymphony

Chassis

HP BladeSystem MS_HW_HPBladeSyste m.hdf

MS_HW_HPBladeTelnet

.hdf

HP BladeSystem

MS_HW_CpqDriveArray

NT.hdf

HP ProLiant

MS_HW_CpqFCADriveA rray.hdf

MS_HW_CpqHBA.hdf

HP ProLiant

MS_HW_CpqIDEDriveAr ray.hdf

MS_HW_CpMgSm2.hdf

MS_HW_CpqNIC.hdf

MS_HW_CpqSCSIDrive

Array.hdf

HP ProLiant

N/A

Storage Device

Microsoft Windows, Linux

Storage Device

Linux, Sun Solaris

Storage Device

N/A

Microsoft Windows, Linux

Microsoft Windows, Linux, Sun

Solaris

N/A

Microsoft Windows, Linux, Sun

Solaris

N/A

Microsoft Windows, Linux, HP

OpenVMS, HP Tru64, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Microsoft Windows, Linux, HP

OpenVMS, HP Tru64, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Reference Guide

229

Hardware Sentry KM for PATROL

Version 1.8.01

Connector Name Connector File Typical platform

Server

Server - WBEM

Server - WMI

HP Insight Management Agent

Server (Alpha)

(v8.20 or lower) - Memory

HP Insight Management Agent

(v8.25 or higher) - Memory

HP MP/GSP card

MS_HW_CpMgServNT.h

HP ProLiant

MS_HW_HPInsightwbe m.hdf

MS_HW_HPInsightwmi.

hdf

HP ProLiant

MS_HW_CpMgServTru6

4.hdf

HP ProLiant

MS_HW_CpqSiMem.hdf

HP ProLiant

HP MSA 2000 & P2000

HP StorageWorks EVA - SSSU

HP TopTools Agent

HP TopTools NetRaid Agent

HP-UX - Common

MS_HW_CpqHeResMem

2.hdf

HP ProLiant

MS_HW_HPiLO.hdf

MS_HW_HPDotHill.hdf

HP 9000, Integrity,

SuperDome

HP StorageWorks

MSA P2000

MS_HW_HPSSSU.hdf

HP StorageWorks

EVA

HP NetServer MS_HW_HPTopToolsNT

.hdf

MS_HW_HpNetRaidCon troller.hdf

MS_HW_HPUX.hdf

HP NetServer

HP 9000, HP

Integrity, HP

SuperDome

HP-UX - Disks

HP-UX - Network

MS_HW_HPUXNetwork.

hdf

HP-UX - SASMGR Managed Disks

MS_HW_HPUXSasMgr.h

HP 9000, HP

Integrity, HP

SuperDome

HP 9000, HP

Integrity, HP

SuperDome

HP-UX - Smart Array RAID

MS_HW_HPUXDisk.hdf

HP 9000, HP

Integrity, HP

SuperDome f

MS_HW_HPUXSAUtil.hd

HP 9000, HP

Integrity, HP

SuperDome

HP-UX - STM

HP-UX WBEM

HP-UX - WBEM Network

IBM AIX - CHRP Environment

MS_HW_HPUXStm.hdf

HP 9000, HP

Integrity, HP

SuperDome f

MS_HW_HPUXWBEM.hd

HP-UX - WBEM

MS_HW_HPUXWBEMNe twork.hdf

MS_HW_IBMAIXChrpMa chstat.hdf

HP 9000, HP

Integrity, HP

SuperDome

IBM RS/6000, IBM pSeries, IBM eServer p5

Operating System

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Linux

Microsoft Windows

HP Tru64, HP OpenVMS

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

Microsoft Windows, Linux, HP

Tru64, HP OpenVMS, Sun Solaris

N/A

Storage Device

Microsoft Windows

Linux, Microsoft Windows

HP-UX

IBM AIX

Reference Guide

230

Hardware Sentry KM for PATROL

Version 1.8.01

Connector Name Connector File Typical platform

IBM AIX - Common

MS_HW_IBMAIX.hdf

IBM AIX - Environment (uesensor)

MS_HW_IBMAIXUeSens or.hdf

IBM RS/6000, IBM pSeries, IBM eServer p5

IBM AIX - HBA

IBM RS/6000, IBM pSeries, IBM eServer p5 f

MS_HW_IBMAIXHBA.hd

IBM RS/6000, IBM pSeries, IBM eServer p5

IBM AIX - SCSI disks

MS_HW_IBMAIXDisk.hd

IBM RS/6000, IBM pSeries, IBM eServer p5

MS_HW_IBMBlade.hdf

IBM BladeCenter

IBM BladeCenter Management

Module

IBM Director Agent 3.x - Windows

MS_HW_Director3NT.h

IBM Director Agent 4.x - Linux

MS_HW_Director4Linux

.hdf

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM Director Agent 4.x - Windows

MS_HW_Director4NT.h

IBM Director Agent 5.10.x - Linux

MS_HW_Director5Linux

.hdf

IBM Director Agent 5.10.x -

Windows

MS_HW_Director5NT.h

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM Director Agent 5.20.x - Linux

MS_HW_Director52Linu x.hdf

IBM Director Agent 5.20.x -

Windows

IBM Director Agent 6.x - Linux

MS_HW_Director52NT.

hdf

MS_HW_Director61Linu x.hdf

IBM Director Agent 6.x - Windows

MS_HW_Director61NT.

hdf

IBM DS (LSI) Disk Arrays (smcli)

MS_HW_smcli.hdf

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM xSeries, IBM

Netfinity

IBM DSxxxx Disk

Arrays

IBM Netfinity

IBM Netfinity Manager 5.20.x -

Basic

IBM Netfinity Manager 5.20.x -

Disks

MS_HW_IbmNetfinityM anagerBASIC.hdf

MS_HW_IbmNetfinityM anagerRAID.hdf

IBM Netfinity

IBM Netfinity Manager 5.20.x -

Normal

IBM VIO Server

MS_HW_IbmNetfinityM anager.hdf

MS_HW_IBMVIOS.hdf

IBM Netfinity

Intel Base Board 5 Motherboards

MS_HW_IntelBaseBrd5.

hdf

Generic Servers

Intel Modular Server

IBM RS/6000, IBM pSeries, IBM eServer p5

MS_HW_IntelModularSe rver.hdf

Generic Servers

Operating System

IBM AIX

N/A

Microsoft Windows

Linux

Microsoft Windows

Linux

Microsoft Windows

Linux

Microsoft Windows

Linux

Microsoft Windows

Storage Device

Microsoft Windows

IBM AIX

Microsoft Windows, Linux

N/A

Reference Guide

231

Hardware Sentry KM for PATROL

Version 1.8.01

Connector Name Connector File Typical platform

Operating System

IPMI

Linux - Emulex HBAs (hbacmd)

Linux - Multipath

Linux - Network

Linux - QLogic HBAs (scli)

LSI 1030-based GAM Server

(Alternate MIB)

LSI Logic - LsiUtil - RAID

MS_HW_IpmiTool.hdf

Intel and AMDbased servers

MS_HW_EmulexHbacmd

.hdf

Linux Server with

HBAs

MS_HW_LinuxMultipath

.hdf

Dell PowerEdge,

Fujitsu-Siemens

PRIMERGY, HP

ProLiant, IBM xSeries, NEC

Express5800, Sun

Fire (x64) f

MS_HW_LSI1030Alt.hdf

Fujitsu-Siemens

PRIMERGY

MS_HW_LSIUtilUNIX.hd

Sun Fire (x64)

Linux, Sun Solaris, Microsoft

Windows

Linux

MS_HW_LinuxNetwork.

hdf

Dell PowerEdge, HP

ProLiant, Fujitsu-

Siemens PRIMERGY,

IBM xSeries, Sun

Fire

Linux

Linux MS_HW_QlogicSCLI.hdf

Linux Server with

HBAs

MS_HW_LSI1030.hdf

Fujitsu-Siemens

PRIMERGY

Microsoft Windows, Linux

Linux, Sun Solaris

LSI Logic - LsiUtil - RAID

(Windows)

LSI MegaCli

LSI/Mylex GAM Server

LsiLogic MegaRAID PowerConsole

MS_HW_MegaRaidPow erConsole.hdf

LsiLogic MegaRAID SAS

MS_HW_LSIMegaRaidS

AS.hdf

LsiLogic MegaRAID SAS (Newer

MS_HW_LSIUtilWindow s.hdf

MS_HW_LSIMegaCliWin dows.hdf

MS_HW_MylexControlle r.hdf

MS_HW_LSIMegaRaidS

AS5.hdf

MS_HW_McData.hdf

Windows servers equipped with an

LSI RAID controller f

MS_HW_SunMegaCli.hd

All Solaris Machines with LSI controllers and IBM Servers with EXP3000

External Bays

Microsoft Windows

Any System with an

LSI controller managed by

MegaCli / CmdTool2

Fujitsu-Siemens

PRIMERGY

Microsoft Windows

Microsoft Windows, Linux

Fujitsu-Siemens

PRIMERGY

Fujitsu-Siemens

PRIMERGY

Fujitsu-Siemens

PRIMERGY

SAN Switches

Microsoft Windows, Linux

Storage Device

Sun Solaris, Linux

Network Interfaces

Network Interfaces - Linux

MS_HW_MIB2.hdf

Any SNMPinstrumented device

Network, HP-UX, Storage Device,

HP OpenVMS, HP Tru64

MS_HW_MIB2Linux.hdf

Any SNMPinstrumented device

Linux

Reference Guide

232

Hardware Sentry KM for PATROL

Version 1.8.01

Connector Name Connector File Typical platform

Operating System

Network Interfaces - Solaris