Configuring HP 3PAR KM for PATROL

Creating a Connection to the HP 3PAR embedded SMI-S provider

Before performing this first configuration step, it is recommended to test the connection to the HP 3PAR embedded SMI-S provider by using the troubleshooting tool provided by Sentry Software. Refer to the Troubleshooting section for more information.

To create a connection to the HP 3PAR embedded SMI-S provider:

1. Create a monitoring policy:
   • Log on to the TrueSight console.
   • In the navigation pane, expand Configuration and select Infrastructure Policies.
   • In the Infrastructure Policies page, ensure that the Monitoring tab is selected and click Create Policy.

   

   • In the Create Monitoring Policy page, specify the monitoring policy properties:

   

1. Select the PATROL Agents on which the policy will be applied:

   

   • Select a property (example: Agent IP Address).
   • Select an operator to create the condition (example: equals). The available operators depend on the property that you select.
   • Specify a value for the selected property (example: 10.0.15.176).
   • (Optional) To add more than one condition (example: Agent Port), click the button, and perform the earlier steps.
   • (Optional) To group the conditions, use the parentheses and Boolean operators from their corresponding lists.

2. Configure the HP 3PAR monitoring solution

   

   • Click the Monitoring tab.
   • Click Add Monitoring Configuration.
   • In the Add Monitoring Configuration dialog box, configure the properties:
     • From the Monitoring Solution menu, select HP 3PAR Storage.
     • From the Version menu, select the required version.
     • The Monitor Profile is automatically selected.

3. Configure the connection to the HP 3PAR embedded SMI-S provider:

   • In the HP 3PAR Storage Configuration section, click Add to open the HP 3PAR embedded SMI-S provider settings panel.

   

   • In the Global Settings section, define the Connection Settings to access the HP 3PAR embedded SMI-S provider:
     • Hostname: hostname of the system where the HP 3PAR embedded SMI-S provider is running.
     • Port Number: By default, the HP 3PAR embedded SMI-S provider runs on port 5989 when the encryption option is enabled, or on port 5988 when the encryption is disabled.
     • Encryption: Select this option to encrypt the connection.
     • Enter the Credentials that will be used to connect to the HP 3PAR embedded SMI-S provider.

4. Click OK twice

5. Click Save.

(Optional) Configuring Thresholds

By default no global thresholds are set in TrueSight. To take full advantage of HP 3PAR KM for PATROL, Sentry Software recommends setting thresholds as specified in the Reference Guide.

Three type of thresholds exist in TrueSight:

• Global thresholds: Infrastructure Management Server-side thresholds (Absolute, Signature and Abnormality) managed from the TrueSight console, applicable to all monitors in a realm.
• Server thresholds: Same as above, but defined in a monitoring policy and therefore applicable to a subset of agents. Such thresholds can be set at the monitor type or monitor instance level.
• Agent thresholds: “Classic” range-based thresholds defined on the BMC PATROL Agents. They can be set at the monitor type or monitor instance level.

PATROL events generated by the Sentry Software’s KMs provide more information about the failure. Sentry Software therefore recommends setting agent thresholds over global or server thresholds.

tssh.bat thresholdtemplate import

+-------------------------------------------------------------------------------------------+
|   BMC TrueSight Presentation Server - Command Line Interface 2017 version 11.0            |
|   Copyright 2014-2017. BMC Software, Inc. as an unpublished work.  All rights reserved.   |
+-------------------------------------------------------------------------------------------+


Importing thresholds template....

Importing thresholds from file "C:/Program Files/BMC Software/TrueSightPServer/truesightpserver\modules\cma\thresholdtem
plate.csv"
Successfully imported thresholds template

(Optional) Fine-tuning the HP 3PAR Monitoring

HP 3PAR KM for PATROL periodically performs discoveries to detect new components in your monitored environment and polls the managed systems to collect data. By default, HP 3PAR KM for PATROL runs a discovery every hour and polls the managed systems every 2 minutes. You can however customize these intervals to match your specific needs.

By default, HP 3PAR KM for PATROL discovers and monitors all volumes in the HP 3PAR storage systems. Monitoring a very large number of volumes may represent an important workload to the Agents and the servers. To improve performances, you can disable the monitoring of volumes or filter the specific volumes you want to monitor.

To fine-tune the HP 3PAR Monitoring:

1. Edit your HP 3PAR monitoring policy:

   

   • Log on to the TrueSight console.
   • In the navigation pane, expand Configuration and select Infrastructure Policies.
   • In the Infrastructure Policies page, locate the monitoring policy you wish to modify, click its action button and click Edit.
   • In the Edit Monitoring Policy page, locate the HP 3PAR Storage Configuration you wish to modify and click its action button to access the monitoring options panel.

2. Configure the discovery and polling intervals:

   • Locate the discovery and polling intervals fields

   

   • Enter the frequency (in minutes) of the discovery process. By default, the discovery interval is set to 60 minutes.
   • Enter the interval at which the solution must poll the managed systems to collect data. By default, the polling interval is set to 2 minutes.

3. Disable Volumes monitoring:

   

   • Check the Disable Volumes Monitoring option if you want to completely exclude all volumes from your monitored environment to limit the number of volumes instances created and therefore reduce the system resource consumption. Discovery and collect requests as well as any other operation will no longer be performed on volumes.
   • Filter the volumes that will be monitored by excluding volumes you do not want to monitor or by identifying those you want to keep on monitoring:
     • In the Exclude Volumes field, enter the names of the volumes that will be excluded from monitoring process. A regular expression can also be used to identify volumes that will be excluded from monitoring process.
     • In the Keep Only Volumes field, enter the names of the volumes to be monitored. A regular expression can also be used to identify volumes to be monitored.

4. Configure the discovery and collect timeouts:

   

   • In the Discovery Timeout field, specify the number of minutes after which the discovery should be stopped. By default the discovery timeout is set to 6000 minutes. When the timeout is reached for the first time, the Collection Status attribute of the HP 3PAR Storage System Monitor Type is set to 2 (Failed) and triggers an alert.
   • In the Collect Timeout field, specify the number of minutes after which the collect should be stopped. By default the collect timeout is set to 6000 minutes. When the timeout is reached, the Collection Status attribute of the instance of the HP 3PAR KM Monitor Type is set to 2 (Failed) and triggers an alert.

5. Click OK twice

6. Click Save.

(Optional) Configuring Alert Actions

Alert Actions enable you to choose specific actions to be executed when a storage problem is detected. Using alert actions, you can customize the way a storage problem notification is performed.

IMPORTANT: Alert Actions are executed when an Agent Threshold is breached, and not when a Global Threshold or Server Threshold is breached.

To configure alert actions:

1. Edit your HP 3PAR monitoring policy:

   

   • Log on to the TrueSight console.
   • In the navigation pane, expand Configuration and select Infrastructure Policies.
   • In the Infrastructure Policies page, locate the monitoring policy you wish to modify, click its action button and click Edit.
   • In the Edit Monitoring Policy page, locate the HP 3PAR Storage Configuration you wish to modify and click its action button to access the monitoring options panel.

2. Locate the Global Alert Settings section:

   

3. In the Events section, select the type of event you want the solution to trigger Upon a Storage Problem:

   • A Specific PATROL Event (Specific storage problem related to a monitored component)
   • A STD 41 PATROL Event (Standard 41 event)
   • No Event.

   These events are generated every time a threshold is exceeded. They contain a full Storage Health Report detailing the fault that has occurred.

4. Select the Enable Annotations option to make the solution annotate the attribute’s graph with a comprehensive report of the problem.

5. Click OK
6. Click Save.

(Optional) Configuring the Unknown Status

HP 3PAR KM for PATROL returns an Unknown status when it is unable to detect the status of a monitored device. Even though this situation is rare, you may want to get notified of this Unknown status with a warning or an alarm. To get this specific notice, you need to tell HP 3PAR KM for PATROL how you want the Unknown status to be interpreted by using the Unknown Status setting.

To configure the Unknown Status:

1. Edit your HP 3PAR monitoring policy:

   

   • Log on to the TrueSight console.
   • In the navigation pane, expand Configuration and select Infrastructure Policies.
   • In the Infrastructure Policies page, locate the monitoring policy you wish to modify, click its action button and click Edit.
   • In the Edit Monitoring Policy page, locate the HP 3PAR Storage Configuration you wish to modify and click its action button to access the monitoring options panel.

2. Locate the Unknown Status Management section:

   

3. From the drop-down list, select:

   • 0 (OK) to set the Status attribute to OK (default)
   • 1 (Warning) to trigger a WARNING on the Status attribute
   • 2 (Alarm) to trigger an ALARM on the Status attribute

4. Click Close to save your settings

5. In the Add Monitor Types dialog box, click Add.

(Optional) Scheduling reports

HP 3PAR KM for PATROL can automatically produce text reports that provide detailed and valuable information about your monitored storage systems.

To schedule reports:

1. Edit your HP 3PAR monitoring policy:

   

   • Log on to the TrueSight console.
   • In the navigation pane, expand Configuration and select Infrastructure Policies.
   • In the Infrastructure Policies page, locate the monitoring policy you wish to modify, click its action button and click Edit.
   • In the Edit Monitoring Policy page, locate the HP 3PAR Storage Configuration you wish to modify and click its action button to access the monitoring options panel.

2. Locate the Reporting section:

   

3. In the Schedule section, indicate the time at which the report(s) must be generated.

4. Check the Activity report type to automatically generate the following reports:
   • Storage Systems Activity: Reports on Transfer, Received and Sent Bytes for all monitored storage systems
   • Nodes Activity: Reports on Transfer, Read and Write Bytes for all monitored nodes
   • FC, Ethernet, and SAS Ports Activity:Reports on Transfer, Received and Sent Bytes for all monitored fiber ports
   • Storage Pools Activity: Reports on Transfer, Read and Write Bytes for all monitored storage pools
   • Physical Disks Activity: Reports on Transfer, Read and Write Bytes for all monitored physical disks
   • Volumes Activity: Reports on Transfer, Read and Write Bytes for all monitored volumes

5. Check Virtual Volumes Mapping Table to automatically generate a mapping table of virtual volumes to hosts. The .csv file generated for this report consists in the following comma-separated data: Host WWN, Virtual Volume, Storage System and Size.

6. Click OK
7. Click Save.

The generated file(s) are time-stamped and stored in %PATROL_HOME%\log for the specific time set through the History Retention Period parameter.