Configuring Dell EMC Unity KM

[7b0ffb19]: ./troubleshooting-patrol.html "Troubleshooting"

Once Dell EMC Unity KM for PATROL is installed, you can:

  1. Create a connection to the Dell EMC Unity SMI-S provider
  2. (Optional) Configure thresholds
  3. (Optional) Fine-tune the Dell EMC Unity monitoring
  4. (Optional) Configure alert actions
  5. (Optional) Schedule reports

Creating a Connection to the Dell EMC Unity SMI-S provider

Before performing this first configuration step, it is recommended to test the connection to the Dell EMC Unity SMI-S provider by using the troubleshooting tool provided by Sentry Software. Refer to the [Troubleshooting][7b0ffb19] section for more information.

To create a connection to the Dell EMC Unity 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. 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 Dell EMC Unity monitoring solution

    Configuring the Dell EMC Unity 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 Dell EMC Unity.
      • From the Version menu, select the required version.
      • The Monitor Profile is automatically selected.
  3. Configure the connection to the Dell EMC Unity SMI-S provider:

    • In the Dell EMC Unity Storage Configuration section, click Add to open the Dell EMC Unity SMI-S provider settings panel. Add to open the Dell EMC Unity SMI-S provider settings panel. Dell EMC Unity SMI-S provider Global Settings
    • In the Global Settings section, define the Connection Settings to access the Dell EMC Unity SMI-S provider:
      • Hostname: hostname of the system where the Dell EMC Unity SMI-S provider is running
      • Port Number: Port number to be used (Default: 5989)
      • Encryption: Select this option to encrypt the connection
      • Enter the WBEM Credentials that will be used to connect to the Dell EMC Unity SMI-S provider. A user with operator role can be used.
  4. Click OK twice

  5. Click Save.

(Optional) Configuring Thresholds

By default no global thresholds are set in TrueSight. To take full advantage of Dell EMC Unity 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 Dell EMC Unity monitoring policy:

    Editing the  Dell EMC Unity  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 Dell EMC Unity KM as the Monitoring Solution, the Version, the Monitor Type, the Scope and the Monitor Attribute.

    Setting Agent Threshold for the Dell EMC Unity  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 disk time utilization of a specific physical disk is above 90% five times in a row.

  5. Click OK
  6. Click Save.

Setting Global Thresholds

Dell EMC Unity KM ships with predefined thresholds that can be imported into TrueSight Operations Management:

  1. Download SEN_UNITY_thresholdtemplate.csv
  2. Copy the content of SEN_UNITY_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 Dell EMC Unity KM 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: Disk Time Utilization

    Setting Global Thresholds for the Disk Time Utilization 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 disk time utilization of the physical disks is above 90% 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 Dell EMC Unity monitoring policy:

    Editing the  Dell EMC Unity  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 Dell EMC Unity KM 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 disk time utilization of the specified physical disk is above 90% for more than 5 minutes.

  6. Click OK
  7. Click Save.

(Optional) Fine-tuning the Dell EMC Unity Monitoring

Dell EMC Unity KM for PATROL periodically performs discoveries to detect new components in your monitored environment and polls the managed systems to collect data. By default, Dell EMC Unity 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, Dell EMC Unity KM for PATROL discovers and monitors all volumes and file systems in the Dell EMC Unity storage systems. Monitoring a very large number of volumes and file systems may represent an important workload to the Agents and the servers. To improve performances, you can disable the monitoring of volumes and/or file systems or filter the specific volumes / file systems you want to monitor.

To fine-tune the Dell EMC Unity Monitoring:

  1. Edit your Dell EMC Unity monitoring policy:

    Editing the  Dell EMC Unity  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 Dell EMC Unity 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. 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 and/or File Systems monitoring:

    Enabling/Disabling File Systems Monitoring

    • Check the Disable Volumes Monitoring and/or Disable File Systems Monitoring options if you want to completely exclude all volumes and/or file systems from your monitored environment to limit the number of volumes and/or file systems 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 and/or file systems.
    • Filter the volumes and file systems that will be monitored by excluding volumes and file systems you do not want to monitor or by identifying those you want to keep on monitoring:
      • In the Exclude Volumes and Exclude File Systems fields, enter the names of the volumes and file systems 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 and Keep Only File Systems fields, enter the names of the volumes and file systems 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 Dell EMC Unity KM Monitor Type is set to 2 (Failed) and triggers an alert, all subsequent timeout breaches will trigger an alert on the Collection Status attribute of the instance of the Dell Unity Storage System Monitor Type.
    • 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 Dell Unity Storage System 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 Dell EMC Unity monitoring policy:

    Editing the  Dell EMC Unity  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 Dell EMC Unity 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) 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) Scheduling reports

Dell EMC Unity 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 Dell EMC Unity monitoring policy:

    Editing the  Dell EMC Unity  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 Dell EMC Unity 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 pools: Reports on Transfer, Read and Writes Bytes for all monitored storage pools
    • Volumes: Reports on Transfer, Read and Writes Bytes for all monitored volumes
    • Physical disks: Reports on Transfer, Read and Writes Bytes for all monitored physical disks
    • FC Ports: Reports on Transfer Bytes for all monitored ports.
  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, Fiber 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

Keywords:
unity km patrol