Configuring IBM SVC-Storwize KM for PATROL

Once IBM SVC-Storwize KM for PATROL is installed, you can:

  1. Create a connection to the IBM SVC-Storwize Storage Manager
  2. (Optional) Configure thresholds
  3. (Optional) Fine-tune the IBM SVC-Storwize monitoring
  4. (Optional) Configure alert actions
  5. (Optional) Configure the Unknown status
  6. (Optional) Schedule reports

Creating a Connection to the IBM SVC-Storwize Storage Manager

Before performing this first configuration step, it is recommended to test the connection to the IBM SVC-Storwize Storage Manager by using the troubleshooting tool provided by Sentry Software. Refer to the Troubleshooting section for more information.

To create a connection to the IBM SVC-Storwize Storage Manager:

  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.

    Creating a Monitoring Policy

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

    Specifying the Monitoring Policy Properties

Property Description
Name Name for the policy. The policy names must be unique. In an environment with tenants, the policy names must be unique for a single tenant. It is a mandatory field.
Description (Optional) A brief description about the policy.
Associated User Group Name of the user group that is associated with the PATROL Agents as defined in the Authorization Profile or in the PATROL Agent ACLs. The policy is applicable to these PATROL Agents.
Share with User Group Specify whether this policy is to be shared with the users across the associated user group or not. This property can be viewed in READ-ONLY mode by other users of the associated user group. Only the owner of the policy can modify this property.
Precedence Priority of the policy. Based on the precedence number that you configure, the configuration is applied to the PATROL Agents and the Infrastructure Management servers. The precedence number ranges from 0 to 999. A lower number indicates a higher precedence. The default value is 900. The configuration from a policy with a higher precedence overrides the configuration from a policy with a lower precedence. If two policies have the same precedence number, then the configuration from the latest created policy takes priority.
Enable Policy Indicates whether the policy is enabled or disabled. By default, the policy is enabled. If you disable a policy when you create it, the policy configurations are not applied to the PATROL Agents and the Infrastructure Management Servers. If you disable any existing policy, the policy configurations are removed from the PATROL Agents and the Infrastructure Management servers, where the policy was applied.
  1. Select the PATROL Agents on which the policy will be applied:

    Selecting the PATROL Agents

    • 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 inline button, and perform the earlier steps.
    • (Optional) To group the conditions, use the parentheses and Boolean operators from their corresponding lists.
  2. Configure the IBM SVC-Storwize monitoring solution

    Configuring the IBM SVC-Storwize 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 IBM SVC-Storwize Storage.
      • From the Version menu, select the required version.
      • The Monitor Profile is automatically selected.
  3. Configure the connection to the IBM SVC-Storwize Storage Manager:

    • In the IBM SVC-Storwize Storage Configuration section, click Add to open the IBM SVC-Storwize Storage Manager settings panel.

    IBM SVC-Storwize Storage Manager Global Settings

    • In the Global Settings section, define the Connection Settings to access the IBM SVC-Storwize Storage Manager:
      • Hostname: hostname of the system where the IBM SVC-Storwize Storage Manager is running.
      • Port Number: By default, the IBM SVC-Storwize Storage Manager 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 IBM SVC-Storwize Storage Manager.
  4. Click OK twice

  5. Click Save.

(Optional) Configuring Thresholds

By default no global thresholds are set in TrueSight. To take full advantage of IBM SVC-Storwize 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.

Setting Agent Thresholds

  1. Edit your IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
  2. Select the Agent Thresholds tab and click Add Agent Threshold.

  3. Select IBM SVC-Storwize Storage as the Monitoring Solution, the Version, the Monitor Type, the Scope and the Monitor Attribute.

    Setting Agent Threshold for the IBM SVC-Storwize Monitors

    The Instance SID is required when setting thresholds at the instance level. You will find that information in the TrueSight Infrastructure Management console by placing the cursor on the required instance.

  4. Specify under which conditions events will be triggered. In our example, a warning will be triggered when the response time of a specific volume is above 30 ms.

  5. Click OK
  6. Click Save.

Setting Global Thresholds

IBM SVC-Storwize ships with predefined thresholds that can be imported into TrueSight Operations Management:

  1. Download ${filePrefix}_thresholdtemplate.csv
  2. Copy the content of ${filePrefix}_thresholdtemplate.csv to the thresholdtemplate.csv file located in _<TrueSight Presentation Server installation directory>_\TrueSightPServer\truesightpserver\modules\cma on your TrueSight server
  3. If required, in the resulting thresholdtemplate.csv file, replace bmcrealm with the name of the tenant (from version 11 of TrueSight Operations Management, you can use * to apply these thresholds to all tenants)
  4. From a command-line interface, go to _<TrueSight Presentation Server installation directory>_\TrueSightPServer\truesightpserver\bin and execute the command below:
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

You can further customize these global thresholds:

  1. Log on to the TrueSight console.
  2. In the navigation pane, expand Configuration and select Global Thresholds.
  3. Expand IBM SVC-Storwize Storage and select the required version. All the monitors and attributes are displayed on the right pane.
  4. Select the attribute for which you wish to set global thresholds. In our example: Response Time

    Setting Global Thresholds for the Response Time Attribute

  5. In the bottom pane, specify under which conditions events will be triggered. In our example, an event of severity “Major” will be triggered when the response time of the volumes is above 30 ms for more than 5 minutes.

    Setting Global Thresholds

Setting Server Thresholds

Server thresholds configured for a specific policy will override the global thresholds set in the TrueSight console.

  1. Edit your IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
  2. Select the Server Threshold tab and click Add Server Threshold

  3. Select IBM SVC-Storwize Storage as the Monitoring Solution, the Version and the Monitor Type.
  4. Enter the Monitor Instance Name and select the Monitor Attribute.

    Setting Server Thresholds

  5. Specify under which conditions events will be triggered. In our example, an event of severity “Major” will be triggered when the response time of the specified volume is above 30 ms for more than 5 minutes.

  6. Click OK
  7. Click Save.

(Optional) Fine-tuning the IBM SVC-Storwize Monitoring

IBM SVC-Storwize KM for PATROL periodically performs discoveries to detect new components in your monitored environment and polls the managed systems to collect data. By default, IBM SVC-Storwize 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, IBM SVC-Storwize KM for PATROL discovers and monitors all volumes in the IBM SVC-Storwize 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 IBM SVC-Storwize Monitoring:

  1. Edit your IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
    • In the Edit Monitoring Policy page, locate the IBM SVC-Storwize Storage Configuration you wish to modify and click its action button inline to access the monitoring options panel.
  2. Configure the discovery and polling intervals:

    • Locate the discovery and polling intervals fields

    Customizing the Discovery and Polling Intervals

    • 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:

    Enabling/Disabling 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:

    Customizing 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 IBM SVC-Storwize KM 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 IBM SVC-Storwize Storage Manager 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 IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
    • In the Edit Monitoring Policy page, locate the IBM SVC-Storwize Storage Configuration you wish to modify and click its action button inline to access the monitoring options panel.
  2. Locate the Global Alert Settings section:

    Configuring Alert Actions

  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

IBM SVC-Storwize 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 IBM SVC-Storwize 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 IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
    • In the Edit Monitoring Policy page, locate the IBM SVC-Storwize Storage Configuration you wish to modify and click its action button inline to access the monitoring options panel.
  2. Locate the Unknown Status Management section:

    Configuring the Unknown Status

  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

IBM SVC-Storwize 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 IBM SVC-Storwize monitoring policy:

    Editing the IBM SVC-Storwize 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 inline and click Edit.
    • In the Edit Monitoring Policy page, locate the IBM SVC-Storwize Storage Configuration you wish to modify and click its action button inline to access the monitoring options panel.
  2. Locate the Reporting section:

    Scheduling Reports

  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, Read and Write Bytes for all monitored storage systems
    • Nodes Activity: Reports on Transfer, Read and Write Bytes for all monitored nodes
    • Array Disks Activity: Reports on Transfer, Read and Write Bytes for all monitored array disks
    • Fiber Ports Activity:Reports on Transfer, Sent and Received Bytes for all monitored fiber ports
    • Managed Disks Activity: Reports on Transfer, Read and Write Bytes for all monitored managed disks
    • Storage Pools Activity: Reports on Transfer, Read and Write Bytes on for all monitored
    • Volumes Activity: Reports on Transfer, Sent and Received Bytes for all monitored volumes
  5. Check LUNs Mapping Table to automatically generate a mapping table of LUNs to hosts. The .csv file generated for this report consists in the following comma-separated data: Storage System, Hostname, Host WWN/IQN, LUN, Ports or 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.

Generated Report Files