Management Pack for Dell EMC Unity

VMware vRealize True Visibility Suite 1.0 Management Pack for Dell EMC Unity

You can find the most up-to-date technical documentation on the VMware website at: https://docs.vmware.com/

VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com

VMware, Inc. 2 Contents

1 Management Pack for Dell EMC Unity 4

2 System Requirements (Unity) 5 Adding an SSL Certificate to the vROps Truststore (Unity) 5

3 Installing the Management Pack (Unity) 7

4 Configuring the Management Pack (Unity) 10 Creating a Credential (Unity) 10 Creating an Adapter Instance (Unity) 12 Validating Data Collection (Unity) 14

5 Troubleshooting the Management Pack (Unity) 16

6 Using the Management Pack (Unity) 18 Resource Kinds and Relationships (Unity) 18 Inventory Tree (Traversal Spec) (Unity) 19 Dashboards (Unity) 23 Dell EMC Unity Overview 24 Dell EMC Unity Health Investigation 24 Dell EMC Unity File System Details 25 Troubleshooting a Dell EMC Unity System 26 Dell EMC Unity Alerts 26 Dell EMC Unity System Details 27 Dell EMC Unity LUN Capacity and Performance 28 Reports (Unity) 28 Analysis Badges and Capacity Definitions (Unity) 29 Alerts (Unity) 29 Metrics (Unity) 33

VMware, Inc. 3 Management Pack for Dell EMC Unity 1

The VMware vRealize® True Visibility™ Management Pack for Dell EMC Unity is an embedded adapter for vRealize Operations (vROps), collecting performance, health, and availability data from your Dell EMC Unity system and providing predictive analytics and real-time monitoring information—all within the vRealize Operations user interface.

Notable Features

The Management Pack for Dell EMC Unity provides the following notable features: n 7 comprehensive monitoring dashboards: n Almost 200 collected metrics for Unity resources, including used space, data reduction, and read/write rate. n 110+ alerts and notifications inform you when capacity usage and read/write latency is high. n vRealize Calculated Storage Capacities – Predict when your Unity arrays, volumes, hosts, or host groups need scaling. n External relationship – View the underlying Unity infrastructure as it relates to your VMware VMs.

Release Notes

Version Release Date Description

3.2.0 15 JUL 2021 Added FIPS compatibility

3.0.0 06 OCT 2020 Initial General Availability Release for VMware vRealize® True Visibility™

VMware, Inc. 4 System Requirements (Unity) 2

Before installing and configuring the Management Pack, ensure your system meets the following requirements:

vRealize Operations Requirements Dell EMC Unity Requirements

Version(s) vRealize Operations 7.x or UnityVSA 4.5.0 + 8.x (Advanced or Enterprise n Unisphere 4.5.0.0.5.096 + editions) n API version 9.0 +

Connection Hostname: of your Dell EMC Unity system Port: the default port used by this management pack is port 443

Credentials Note A user with the read-only monitoring permissions of Operator is required.

This chapter includes the following topics: n Adding an SSL Certificate to the vROps Truststore (Unity)

Adding an SSL Certificate to the vROps Truststore (Unity)

For added security, we recommend adding an SSL certificate to the vROps truststore for your Dell EMC Unity host server.

Note Different levels of security can be configured in the Management Pack for Dell EMC Unity. The least secure configuration is to leave the default selection of False for the SSL Configuration Advanced Setting. In this configuration, the Management Pack will accept all SSL certificates. For added security, you can enable SSL by following the instructions below and selecting True for the SSL Configuration Advanced Setting when Creating an Adapter Instance (Unity)

1 Obtain the SSL certificate for your Unity host server from your Internet browser. Export the certificate as an X.509 Certificate (PEM).

2 Copy the certificate to your vROps machine.

3 Use ‘ssh’ to log in to the vROps machine as the root user, then run the following command:

Linux:

VMware, Inc. 5 Management Pack for Dell EMC Unity

$VCOPS_BASE/jre/bin/keytool -import -alias -file /tmp/ -keystore “$VCOPS_DATA_VCOPS/user/conf/ssl/tcserver.truststore” -storepass `grep ssltruststorePassword /storage/vcops/user/conf/ssl/storePass.properties | sed s/ ssltruststorePassword=//` -trustcacerts

Windows:

%VCOPS_BASE%\jre\bin\keytool -import -alias C:\path\to\certfile -keystore “%VCOPS_DATA_VCOPS%\user\conf\ssl\tcserver.truststore” -storepass -trustcacerts

Parameter Descriptions:

n -alias is a unique name for each key that you add (per host)

n certfile is the location where the cert file was saved

4 Run the reboot command to re-start the vROps machine for the changes to take effect.

VMware, Inc. 6 Installing the Management Pack (Unity) 3

The Management Pack for Dell EMC Unity is installed using a .pak file.

1 Log in to vRealize Operations as an admin user.

2 From the top navigation bar, select Administration. In the left panel, the default Solutions view will be selected. In the right panel, click the Add icon.

Note If you are using vROps 7.5, Solutions will have two subcategories: Configuration and Repository. Select Repository and scroll down to Other Management Packs and select Add a Management Pack to install a new management pack. Refer to the second screenshot below if needed.

vROps versions 7 and lower:

vROps version 7.5:

VMware, Inc. 7 Management Pack for Dell EMC Unity

3 The Add Solution window will appear. Browse to the location of the saved .pak file, then click Upload.

VMware, Inc. 8 Management Pack for Dell EMC Unity

4 Click Next when the upload has finished.

5 Read and accept the End User License Agreement (EULA), then click Next.

6 Click Finish when the installation process is complete.

VMware, Inc. 9 Configuring the Management Pack (Unity) 4

Configuring the Management Pack for Dell EMC Unity in vRealize Operations includes the following required tasks: n Creating a Credential (Unity) n Creating an Adapter Instance (Unity)

Note In addition, you may want to perform one or more of the following optional tasks to further configure the Management Pack for your specific needs: n Validating Data Collection (Unity) (optional)

This chapter includes the following topics: n Creating a Credential (Unity) n Creating an Adapter Instance (Unity) n Validating Data Collection (Unity)

Creating a Credential (Unity)

One of the required configuration tasks for the Management Pack is to create a set of credentials in vROps.

Prerequisites n Chapter 3 Installing the Management Pack (Unity)

Procedure

1 From the top navigation bar, select Administration. In the left panel, expand the Management category and select Credentials.

VMware, Inc. 10 Management Pack for Dell EMC Unity

2 Creating an Adapter Instance (Unity)

Add Manage Credential

n Credential name: A name for this set of credentials

n User Name: Dell EMC Unity User Name

n Password:Dell EMC Unity Password

What to do next

VMware, Inc. 11 Management Pack for Dell EMC Unity

Creating an Adapter Instance (Unity)

Before you can begin using the Management Pack, you must create an adapter instance to identify the host from which the Management Pack will retrieve data.

Prerequisites n Chapter 3 Installing the Management Pack (Unity) n Creating a Credential (Unity)

Procedure

1 From the top navigation bar, select Administration. In the right panel, the Solutions view will be displayed.

2 Select Dell EMC Unity from the Solutions list on the right.

3 Click the Configure icon. The Manage Solutionwindow will appear.

Note Click the Add icon above the Instance Namelist on the left to create multiple adapter instances.

VMware, Inc. 12 Management Pack for Dell EMC Unity

4 In theManage Solutionwindow, enter the following information:

a Instance Settings:

n Display Name: A name for this particular instance of the Management Pack.

n Description: Optional, but it can be helpful to describe multiple instances of the Management Pack.

b Basic Settings:

n Host:Enter the hostname of your Dell EMC Unity System. Supported formats include: domain name, Fully-Qualified Domain Name (FQDN), and IPv4 address.

n Credential: Select the credential you created when Creating a Credential (Unity), or click the Add icon now to create one.

c Advanced Settings:

n Collector(s)/Groups: Default Collector/Group is automatically selected. Click the drop- down menu if you want to run the collection on a different node.

n Port: The port for communication to the Dell EMC Unity System (default: 443)

VMware, Inc. 13 Management Pack for Dell EMC Unity

n SSL Configuration:Options areNo Verify(default value; SSL enabled/certificate not verified), andVerify(SSL enabled/certificate verified). When you clickTest Connectionin step 5 below, you should be prompted to add an SSL certificate to the vROps truststore.

n Collect Events: Whether or not to gather events (default: True)

n Minimum Event Security: The minimum event severity to collect.

n Request Timeout: The maximum amount of time to wait for each call to the Unity server to respond, in milliseconds (default: 10000)

n Maximum Concurrent Requests: The maximum number of requests allowed at the same time (default: 4)

n Support Autodiscovery: When you enable autodiscovery (set toTrue by default), the Management Pack creates resources and relationships in vROps, then collects data for the discovered resources after the main collection query runs. Do not change this to False.

5 Click Test Connection to test the configured connection information. If you encounter any errors, see: Chapter 5 Troubleshooting the Management Pack (Unity)

6 Click Save Settings and Close to save your adapter instance.

What to do next n To validate data collection, see: Validating Data Collection (Unity)

Validating Data Collection (Unity)

After you add an adapter instance, you will most likely want to validate the data that it collects in vROps. Wait until one collection cycle is complete and the Collection Status for the adapter instance on the Solutions page shows as "Data Receiving".

Prerequisites n Creating an Adapter Instance (Unity)

Procedure

1 From the top navigation bar, select Environment.

2 In the left panel, select All Objects, then expand the Dell EMC Unity objects list.

VMware, Inc. 14 Management Pack for Dell EMC Unity

3 Select a resource from the list, then click the All Metrics tab to select metrics and validate values against the data source.

VMware, Inc. 15 Troubleshooting the Management Pack (Unity) 5

Once you have finishedChapter 3 Installing the Management Pack (Unity) andChapter 4 Configuring the Management Pack (Unity), check theCollection StateandCollection Statusfor the adapter instance on theSolutionspage. If they show asNot Collecting orNo Data Receiving, respectively, the following troubleshooting topics can help you diagnose and correct common problems with your adapter instance.

Test Connection Errors

When Creating an Adapter Instance (Unity), click Test Connection after entering all of your configuration settings to ensure vROps can connect to the specified host.

The following errors are possible:

Ex Uno Error: property_metric_present This appears when properties were requested but not returned. This isn't necessarily a problem because some properties might not have values depending on the system configuration.

Ex Uno Error: This appears along withunexpected status code 422 from HTTP performance_metric_gathering responsewhen requesting unsupported performance metrics.

Adapter and Collector Log Files

You can review adapter errors in the adapter and collector log files, which can be viewed in the vROps UI or in an external log viewer. n Adapter log files are located in the $VCOPS_BASE/user/log/adapters/DellEMCUnityAdapter/ folder. n Collector log files are located in the $VCOPS_BASE/user/log/ folder.

To set the base log level for the collector in vROps:

1 Navigate to Administration>Logs.

2 Expand the MASTER folder, then select the COLLECTOR folder.

3 Click the Edit Properties icon.

VMware, Inc. 16 Management Pack for Dell EMC Unity

4 In the Root logger level drop-down menu, select the desired option. n The default logging level is warning. n To troubleshoot issues, set the logging level to info. n To view detailed messages, including micro steps, queries, and returned results, set the logging level to debug.

Caution If you set the logging level to debug , log files can become large very quickly. Set the logging level to debug only for short periods of time.

For more information about viewing log files and modifying levels, refer to the vROps online help.

VMware, Inc. 17 Using the Management Pack (Unity) 6

The Management Pack for Dell EMC Unity includes the following out-of-the-box features, harnessing the power of the vRealize Operations user interface: n Resource Kinds and Relationships (Unity) n Inventory Tree (Traversal Spec) (Unity) n Dashboards (Unity) n Reports (Unity) n Analysis Badges and Capacity Definitions (Unity) n Alerts (Unity) n Metrics (Unity)

This chapter includes the following topics: n Resource Kinds and Relationships (Unity) n Inventory Tree (Traversal Spec) (Unity) n Dashboards (Unity) n Reports (Unity) n Analysis Badges and Capacity Definitions (Unity) n Alerts (Unity) n Metrics (Unity)

Resource Kinds and Relationships (Unity)

The Management Pack for Dell EMC Unity creates Resource Kinds and Relationships (associations) for critical resources in your Dell EMC Unity environment.

Resource Kinds

Performance, health, availability, and capacity data are collected for the following resource kinds: n System

VMware, Inc. 18 Management Pack for Dell EMC Unity

n Enclosure n Physical Disk n Virtual Disk n Pool n LUN n File System n VVol Block n VVol File

Relationships

Unity Relationships Diagram

Inventory Tree (Traversal Spec) (Unity)

The Inventory Tree (Traversal Spec) feature in vROps allows you to easily navigate your Unity environment. The hierarchical structure implicitly shows relationships among resources and enables quick drill-downs to root-cause issues.

To access a Dell EMC Unity Inventory Tree, navigate to Home > Environment > Inventory Trees.

VMware, Inc. 19 Management Pack for Dell EMC Unity

Example Inventory Tree – Dell Icon Legend EMC Unity

System

VMware, Inc. 20 Management Pack for Dell EMC Unity

Enclosure

File System

VMware, Inc. 21 Management Pack for Dell EMC Unity

LUN

Physical Disk

Virtual Disk

VMware, Inc. 22 Management Pack for Dell EMC Unity

Pool

VVol Block / VVol File

Dashboards (Unity)

Dashboards are the primary feature for monitoring and troubleshooting Unity data problems from within vRealize Operations.

VMware, Inc. 23 Management Pack for Dell EMC Unity

The following dashboards are included in the Management Pack for Dell EMC Unity: n Dell EMC Unity Overview n Dell EMC Unity Health Investigation n Dell EMC Unity Alerts n Dell EMC Unity System Details n Dell EMC Unity LUN Capacity and Performance n Dell EMC Unity File System Details n Troubleshooting a Dell EMC Unity System

Dell EMC Unity Overview

TheDell EMC Unity Overview dashboarddisplays heat maps depicting the overall health of your entire Unity environment.

Dell EMC Unity Health Investigation

The Dell EMC Unity Health Investigation dashboard allows you to select a Dell EMC Unity resource from the Environment Overview widget to view its relationships, alerts, and selected metrics charts.

VMware, Inc. 24 Management Pack for Dell EMC Unity

Dell EMC Unity File System Details

The Dell EMC Unity File System Details dashboard is your jumping-off point for troubleshooting your Unity file systems. Simply select one of them on the left and a health chart, alerts list, and capacity and performance metrics will populate.

VMware, Inc. 25 Management Pack for Dell EMC Unity

Troubleshooting a Dell EMC Unity System

The Troubleshooting a Dell EMC Unity System dashboard is your jumping-off point for troubleshooting. Select a system to populate a list of alerts, and overall health graph, a CPU usage graph, and numerous performance metrics.

Dell EMC Unity Alerts

The Dell EMC Unity Alerts dashboard displays alerts generated in your environment. Selecting an alert will populate helpful, relevant information about the object's relationships, health, and efficiency.

VMware, Inc. 26 Management Pack for Dell EMC Unity

Dell EMC Unity System Details

The Dell EMC Unity System Details dashboard gives relevant details on your Unity systems, including listing alerts, details, network, and performance metrics.

VMware, Inc. 27 Management Pack for Dell EMC Unity

Dell EMC Unity LUN Capacity and Performance

The Dell EMC Unity LUN Capacity and Performance dashboard gives you detailed metrics on the capacity and performance of your LUNs, including alerts and an overall health chart as well.

Reports (Unity)

The Management Pack for Dell EMC Unity contains an out-of-the-box reports that you can export and easily share with key stakeholders in either .pdf or .csv formats.

The following reports are available in the Management Pack:

Report

Dell EMC Unity File System Performance

Dell EMC Unity System Performance

Dell EMC Unity VVol Block Capacity Trends

Dell EMC Unity VVol File Capacity Trends

To access Management Pack reports:

1 Navigate to Environment > All Objects > Dell EMC Unity Adapter .

2 Double-click on the desired object (resource).

3 Select the Reports tab, then Report Templates .

VMware, Inc. 28 Management Pack for Dell EMC Unity

The available report(s) for the selected resource are listed and can be selected.

To run a selected report, click the Run Template icon.

Analysis Badges and Capacity Definitions (Unity)

Using the predictive analytics capabilities of the vROps Analysis Badges through capacity definitions, the Management Pack for Dell EMC Unity populates capacities for resources as indicated in the table below.

Capacity Definitions List

Container Use in Workload

Unity File System

vRealize Calculated File System Capacity Yes

Unity Pool

vRealize Calculated Pool Capacity Yes

Unity LUN

vRealize Calculated LUN Capacity Yes

Unity VVol Block

vRealize Calculated Capacity Yes

Unity VVol File

vRealize Calculated Capacity Yes