SolutionPack for EMC VMAX

Table of Contents

Overview

This article explains how to install and configure the SolutionPack for EMC VMAX. The SolutionPack for EMC VMAX reports Input/Output Operations Per Second (IOPS) on Disks, directors, and devices to measure performance and assure service availability. Alerts are consolidated from EMC VMAX and shown on the All Alerts Console.

This article applies to EMC ViPR SRM version 3.5.1.

report screen

SolutionPack for EMC VMAX

Back to Top

Technical specifications

SolutionPack version

Compatible ViPR SRM version

Main reports

Storage Pool Capacity Planning
Trending and forecasting capacity for all arrays and pools, giving expected capacity based on trend
Thin Devices
Trending and forecasting capacity for all Thin Devices, giving bound devices capacity and the total Thin Devices consumed
Tiers
Trending and forecasting capacity for all arrays and tiers, giving expected capacity based on trend
All disks
Table listing information from all of the disks, including it's array, name, type, group RPM, director, IOPS, throughput and capacity
By DiskGroup
Table listing information from all of the disk groups, including it's array, disk group name, director, raw capacity, hyper capacity, free capacity and usage percentage
Masking views Summary
Capacity as seen by hosts in the masking view
Pool Capacity
Capacity information for all of the Pools available, including array, pool name, pool state and capacity used
Configured Usable
Trending and forecasting on the sum of all thick devices (including standard, BCV and R1 devices) plus the sum of all data devices (pool storage)
Hot Spares
Trending and forecasting on the sum of disks dedicated as hot spares
RAID overhead
Report on the array capacity used to support RAID protection overhead
Unconfigured
Report on all thick devices plus the sum of all data devices (pool storage)
Array ID
Overview of all VMAX main components, physical and logical
Arrays
Lists all the VMAX systems
Disks
Lists all disks and related key information, for all arrays
Directors
Lists all directors and related key information, for all arrays
Ports
Lists all ports and status for all arrays
Pools
Lists all pools and related key information, for all array.
Storage Groups
Lists all Storage Groups and related key information
Ports
Lists all ports and status for all arrays
Devices
Lists all devices and related key information, for all arrays
Storage Groups Summary
Performance and capacity of all storage groups for this array, including IO Density and Response Time
FE|BE|RDF Directors
Key performance metrics for all directors and ports

Supported models

Comments
SRM 3.5.x does not support SE/SMI/UniVMAX 8.x.
iSCSI Gatekeepers are supported.
If performance metrics are desired, then you must install UniSphere for VMAX or the SMI-S Provider, or both.
As of the 3.5 release, many statistics are available through both SMI-S and Unisphere. However if both SMI-S and Unisphere are present, ViPR SRM does not collect overlapping statistics from both sources. Rather, if both are present, overlapping statistics are always collected only through Unisphere. In this case only the LUN statistics will come from SMI-S. There are not two sets of same-named but inconsistent statistics.

Back to Top

Configuring the access credentials

W4N uses different accounts when running SolutionPacks.

VMAX Performance collection via EMC SMI Provider for VMAX:

VMAX Performance collection via UniSphere for VMAX:

Back to Top

Preparing EMC VMAX for discovery and data collection

Identify the information required to support data collection before installing the SolutionPack for EMC VMAX and perform the necessary pre-configuration.

ViPR SRM requires EMC Solutions Enabler to collect array topology details for VMAX arrays; optionally ViPR SRM requires UniSphere for VMAX and/or the EMC SMI-S Provider to collect array performance details. If both EMC Solutions Enabler and EMC SMI-S Provider are present, they must be on the same host. There are two supported scenarios for topology collection. The Solutions Enabler proxy scenario is recommended because the Collector and the Solutions Enabler are not competing for host resources.

Solutions Enabler proxy scenario (recommended)

In this scenario, you install Solutions Enabler on the ViPR SRM Collector host designated to collect data from VMAX.

You configure Solutions Enabler to communicate over TCP/IP with a Solutions Enabler instance on the remote SYMAPI server (Array Provider).

You should add two additional gatekeepers to the host that is already monitoring the Symmetrix array.

To support collection using the SYMAPI Server, two additional gatekeepers will be required per array on the remote Solutions Enabler host. For example, if there are already six gatekeepers per array then you will need to add two more for a total of eight gatekeepers per array.

Local Solutions Enabler scenario

The Local Solutions Enabler scenario supports topology collection for VMAX arrays using a VMAX Solution Pack Collector which has been installed on the same host as the Solution Enabler software.

Back to Top

Solutions Enabler proxy scenario

The Solutions Enabler proxy scenario supports resource discovery and data collection for EMC VMAX.

In this scenario, no ViPR SRM software is installed on the SYMAPI server. Instead, a client host and server host proxy relationship is configured. This is the preferred configuration for monitoring VMAX arrays.

  • Client host - You install Solutions Enabler on the ViPR SRM Collector host designated to collect data from VMAX. The client host has no direct connectivity to the array.
  • Server host - Solutions Enabler already exists on the SYMAPI server with connectivity and gatekeeper access to the array.

The client host is then configured for proxy communicate with the server host over TCP/IP (port 2707, which is the default). In this scenario, map two additional gatekeeper devices to your SYMAPI server.

Back to Top

Configuring Solutions Enabler proxy support

Configure support for the Solutions Enabler proxy scenario.

Before you begin

  • Install a supported version of EMC Solutions Enabler on the ViPR SRM Collector host. Refer to the EMC ViPR SRM Support Matrix for supported versions used with ViPR SRM.
  • In a proxy configuration, you must maintain the same Solutions Enabler family version. A mixed 32-bit and 64-bit Solution Enabler is supported in a proxy configuration.
  • Map two additional gatekeeper devices for ViPR SRM and present them to your SYMAPI server.
  • Ensure the storsrvd daemon is running on the Server host. You can confirm this by issuing the stordaemon list command on the Server host.

This procedure is applicable for Solutions Enabler or the Solutions Enabler installed with the EMC SMI-S Provider.

Procedure

  1. On the client host on which you installed Solutions Enabler, navigate to the netcnfg file.
    On Linux, the file is located at: /var/symapi/config/netcnfg.
    On Windows the file is located at: ..\Program Files\EMC\SYMAPI\config
  2. Edit the file to add the remote host to which Solutions Enabler will communicate. Add a line similar to the last line in the following example:
    # This is a sample config -- where WWW.XXX.YYY.ZZZ is a valid IP address.     #
    # Please use this format for your host.                                       #
    #                                                                             #
    # <SYMAPI_SERVER>  -  TCPIP  node001  WWW.XXX.YYY.ZZZ  2707  -                  #
    # SYMAPI_SECURE  -  TCPIP  node001  WWW.XXX.YYY.ZZZ  2707  SECURE             #
     
    SYMAPI_SERVER - TCPIP hostname IP-address 2707 NONSECURE
    
    Select NONSECURE when the server side is configured for NONSECURE, or ANY on the deamons_options file in the SECURITY_LEVEL section.
  3. Set the following System environment variables on the client host:
    • SYMCLI_CONNECT=<SYMAPI_SERVER>
    • SYMCLI_CONNECT_TYPE=REMOTE
    Option Description
    Windows

    The environment variables are shown with the set command at the command prompt.

    To establish persistent variables use Computer > Properties > Advanced system settings. Select Environment Variables > New to create the two variables as shown above.

    Linux

    Use the env command to show the environment variables.

    To establish persistent variables use export to create the two variables as shown above.

  4. On the SYMAPI server host, ensure that the SERVER license key is registered by reviewing the symapi\config\symapi_licenses.dat file. If it is not there, use the symlmf utility to add the license key.
    You can also control the Solutions Enabler licenses from the array.
Back to Top

Verifying the Solutions Enabler proxy configuration

Verify proxy configuration success and , if necessary, identify and resolve any configuration issues.

Procedure

  1. From the SYMAPI server host, typesympd list to display a list of devices that are visible to the host. Note the results.
  2. On the client host, type sympd list.
    • If the results match, the configuration is complete.
    • If the command issued from the client returns a message such as no devices found, continue to the next step.
  3. To isolate the issue:
    1. Verify that the same command works on the host with the FC connection to the Symmetrix array.
    2. Verify that the environment variables for Solutions Enabler are set using the symcli -def command.
    3. Verify that the netcfg file has been edited using the symcfg -services list command.command.
    4. Verify the arrays you intend to monitor using the symcfg list command.
    5. Verify that two additional gatekeepers are provisioned from each Symmetrix array using the sympd list command.
Back to Top

Local Solutions Enabler scenario

The local Solutions Enabler scenario supports resource discovery and data collection for EMC VMAX.

In this scenario, you install only the ViPR SRM Collector software directly on the existing SYMAPI Solutions Enabler server.

  • The Solutions Enabler proxy scenario is the preferred configuration.
  • Implementing this scenario includes the advantages of reduced network calls and a more secure configuration. However, the Collector software installed on the SYMAPI server will require processing cycles from that server.
  • This scenario requires two additional gatekeeper devices be mapped to your Collector host.
Back to Top

Configuring VMAX arrays for consolidation of availability alerts

Use this procedure to configure forwarding of availability alert traps (SNMP v1) from VMAX arrays to the suite.

VMAX performance alerts are collected using the discovery data collection configuration.

Procedure

  1. Log into Solutions Enabler on the array provider host as an administrator.
  2. Navigate to the daemon_options file in the C:\Program Files\EMC\SYMAPI\config\ directory.
  3. In the parameter section SNMP_TRAP_CLIENT_REGISTRATION:
    1. Uncomment the line storevntd:SNMP_TRAP_CLIENT_REGISTRATION
    2. Add the ViPR SRM trap recipient IP to the trap filter. The trap recipient IP is the Backend host IP.
      The syntax is <IP>,<port>,<filter>,<state>, where <filter> is the filtering level for trap forwarding defined in the FCMGMT-MIB file.
      Example: 10.31.90.148, 2041,10,ACTIVE
  4. In the parameter section LOG_EVENT_TARGETS, uncomment the line storevntd:LOG_EVENT_TARGETS = snmp file.
  5. To identify the arrays from which traps should be forwarded to the suite, type symcfg list, and press Enter.
  6. For each array that should forward alert traps to ViPR SRM:
    1. Type symcfg list, and press Enter.
    2. In the parameter section LOG_SYMMETRIX_EVENTS, specify the appropriate event categories in the format:
      sid=<SYM serial number>, <event category 1>, <event category 2>\
      Example: SID=000194900854, disk, device, device pool, director, srdf consistency group, srdfa session, srdf link, srdf system, service processor, environmental, diagnostic, checksum, status, events, array subsystem, groups, optimizer, thresh_critical=3, thresh_major=2, thresh_warning=1, thresh_info=0 ;\
  7. To reload the changes to the daemon_options file, type stordaemon action storevntd -cmd reload, and press Enter.
  8. Ensure that the storevntd Event Daemon is running on the provider host.
  9. If you have multiple VMAX array provider hosts in your storage environment, repeat this procedure on each array provider host.
Back to Top

Installing the SolutionPack

Before you begin

Procedure

  1. Log in.
  2. Click Administration.
  3. Click Centralized Management.
  4. Click SolutionPacks.
  5. Select SolutionPack Center.
  6. Select the SolutionPack for EMC VMAX in the Browse and Install SolutionPacks screen.
  7. Click Install.
    The steps below assume a typical four VM deployment.
  8. In Alert Consolidation field of the Select the components to install window, select the Primary Backend host.
  9. In Pre-configured alerts, select the Primary Backend host.
  10. In Data Collection, select the Collector host.
  11. In Reports, select the Frontend host.
  12. Click Next.
  13. Click Next.
  14. In the Pre-configured alerts window, make a selection in the Alerting on data collection field.
    If you select Add a new Alerting on data collection, select the Primary Backendhost in the Alerting Web-Service Instance field.
  15. Click Next.
  16. In the Data collection window, select a value for Data Collection.
    If you select Add a new data collection, type information about the data collection. In Hostname or IP address to send data, type localhost.
  17. Leave Enable alerting on data collected checked.
  18. Select a value for Alerting on data collection.
    If you select Add a new Alerting on data collection, type information about the alerting configuration. In Alerting Backend the hostname or IP address, select the Primary Backend host.
  19. Select a value for Property Store configuration.
    If you select Add a new Property Store configuration, type information about the Property Store.
  20. Leave Enable Topology Backend on data collected checked.
  21. Select a value for Topology Service.
    If you select Add a new Topology Service, type information about topology queries.
    • Select a value for Web-Service Gateway.
    • If you select Add new gateway, type information about the gateway.
  22. Select Configure Unisphere for VMAX performance collection.
  23. In Unisphere hostname or IP address, select the host on which Unisphere for VMAX is running and change the default Unisphere network port, Username and Password if different.
  24. Click the plus (+) sign to add additional Unisphere hosts.
  25. Select Configure SMI for VMAX Performance collection, if desired, and select a name for the SMI configuration settings.
    If you select Add a new, enter the new configuration settings.
  26. If Solutions Enabler was installed in the default location, leave the Solutions Enabler bin directory empty. If installed in another location, type the path to the bin directory.
  27. In Connection type, select Remote if you are using the Solutions Enabler proxy scenario or Local if you are using a local Solutions Enabler scenario. Refer to Preparing EMC VMAX for discovery and data collection.
  28. In SYMAPI Connection name, type the connection name. This is the name of a SYMAPI service, which is configured in the netconfig file (netcnfg). This is not a host name. To view the name that is configured, use the symcfg list -services command.
  29. In the VMAX array configuration section of the Data collection window, you add the serial number of each array from which you want to collect data. Run the symcfg list command to view a list of arrays.
  30. In Array Full Serial Number, type the Symmetrix SID from which data will be collected by Solutions Enabler or SMI-S. Click the plus (+) icon to add additional SIDs.
    Note Image
    EMC recommends not to exceed six medium-sized (30K-40K devices) VMAX arrays for each VMAX collector.

  31. Select Use advanced settings to configure polling settings.
  32. In the Administration Web-Service Instance field of the Reports window, select the Frontend host.
  33. Click Install.
    The SolutionPack installation begins.
  34. Click Ok once installation is complete.
    Performance data will displayed in about an hour.
    Discovery of large (> 20K devices) Symmetrix arrays may take long periods of time due to the number of volumes. To address this, discover the Symmetrix on its own instance. This will prevent the discovery from impacting the discovery of other arrays on the same symapi connection and allows the smaller arrays to complete during the polling schedule.
Back to Top

Updating SolutionPack alert definitions

During SolutionPack update, any new alert definitions supported in the updated version do not get updated by default. This is expected behavior.

To add newly introduced alert definitions after updating, follow the steps below.

Procedure

  1. In Centralized Management, navigate to SolutionPacks > Storage > EMC VMAX in the tree.
  2. In the table, click the pen icon button to the left of Pre-configured alerts.
  3. Click Reconfigure.
  4. In the Alerting Frontend, navigate to Local Mananger > Alert definitions > EMC VMAX to see the newly added alert definitions.
Back to Top

Configuring Solutions Enabler client access for VMAX

Symmetrix Authorization using symauth provides a secure host and user-based authorization solution. Use this procedure in environments in which Symmetrix Authorization is enabled.

Before you begin

Ensure that you have configured an appropriate Solutions Enabler scenario as described in Preparing EMC VMAX for discovery and data collection.

For more detailed information about Solutions Enabler, refer to the following documents:

The following configuration procedures are specific to a Solutions Enabler proxy configuration. However, you can also use these procedures for a local Solutions Enabler configuration in which the ViPR SRM Collector software is installed directly on the existing SYMAPI Solutions Enabler server. The term "client" refers to the host where the Collector software has been installed.

Procedure

  1. Validate if Symmetrix Authorization is enabled by running the symauth list command on the host that has direct FC connectivity to the arrays to be managed.
  2. Check the status displayed in the the Authorization Control section to determine the required action:
    Option Description
    Disabled Symmetrix Authorization is not configured. In this case, do nothing.
    Enabled Symmetrix Authorization is configured. In this case, you must configure the apg user and ViPR SRM hosts that will be issuing commands. Continue to step 3.
  3. If Symmetrix Authorization is enabled, use the following procedures to complete the configuration:
    1. Configuring host access
    2. Adding client hosts to existing SYMAUTH configuration
    3. Enabling client authorization
    4. Validating Symmetrix access controls
Back to Top

Configuring host access

Enable the ViPR SRM apg account to access the local Solutions Enabler resources and logs.

This procedure provides an example of configuring access on a host using the Linux operating system.

Procedure

  1. Log in to the Solutions Enabler client host.
  2. Navigate to /var/symapi
  3. Grant the apg user write access to the following Solutions Enabler directories and contents:
    1. chown -R apg <SYMAPI_HOME>/config
    2. chown -R apg <SYMAPI_HOME>/db
  4. Repeat steps 1-3 for each VMAX Collector server.
  5. Grant the apg user authorization for the Solutions Enabler storapid daemon by navigating to <SYMAPI_HOME>/config/daemon_users and adding the following line to the storapid[Base Daemon] section of the file:
    apg storapid <all>
  6. Save and exit the daemon_users file.
  7. Set a password for the apg user.
  8. Repeat steps 5-7 for each VMAX collector server.
  9. Log out and log in as the apg user and run symauth show -username to determine the fully-qualified account name.
  10. Make note of the value displayed in your current username. For example: H:system_name\apg
  11. Repeat steps 9-11 for each VMAX Collector server.
Back to Top

Adding client hosts to existing SYMAUTH configuration

Enable the apg user with read-only monitoring access for VMAX arrays using Solutions Enabler User Authorization.

Before you begin

Complete the procedure described in Configuring host access.

You must be logged in as Root or Administrator.

Perform the following procedure for each VMAX you want to enable ViPR SRM to access.

Procedure

  1. Run the symauth -sid <SID> list command to determine if User Authorization Control is enabled on the local client system.
    • If User Authorization Control is disabled (Disabled) for the specific VMAX, proceed to Enabling client authorization.
    • If User Authorization Control is enabled (Enabled) and in use (Enforced) for the specific VMAX, continue with this procedure.
  2. Ensure that you are logged in with an existing privileged account (e.g., root or administrator).
  3. Use the find / -name auth.txt command to find the auth.txt file.
  4. Navigate to the folder with the auth.txt file.
  5. Edit the file to include a line based on the results obtained from performing the procedure described in Configuring host access. For example:
    assign user H:system_name\apg to role Admin;
  6. Save the file.
  7. Use the symauth -sid <SID> -f auth.txt command to commit changes to the User Authorization User-to-Role map.
  8. Repeat this procedure for each VMAX array.
Back to Top

Enabling client authorization

Use this procedure when User Authorization Control is disabled (Disabled) for the specific VMAX and you want to restrict the apg user to a monitoring role without limiting other accounts in the environment.

Before you begin

You determined that User Authorization Control is disabled by performing the task described in Adding client hosts to existing SYMAUTH configuration.

You are logged in to the client host with local root or administrator credentials.

Procedure

  1. Create an auth.txt file with the following contents:
    assign user * to role Admin;
    set enforcement enforce;
    assign user H:system_name\apg to role Admin;
  2. Repeat step 1 for each VMAX Collector server.
  3. Use the symauth -sid <SID> -f auth.txt command to commit changes to the User Authorization User-to-Role map.
  4. Repeat step 3 for each VMAX array.
  5. Use the symauth -sid <SID> enable command to enable User Authorization Control for a specific VMAX array.
  6. Repeat step 5 for each VMAX array.
  7. Use the symauth list command to validate that User Authorization Control is enabled and enforced.
       S Y M M E T R I X   A U T H O R I Z A T I O N   S T A T U S
    
    Symmetrix ID: 000195700363
    
      Authorization Control           : Enabled
    
      Time Enabled                    : Mon Aug  5 12:51:08 2013
      Time Disabled                   : Thu Aug  1 15:54:23 2013
      Time Updated                    : Mon Aug  5 12:51:08 2013
    
      Enforcement Mode                : Enforce
      Server Policy                   : Trust clients
    
Back to Top

Validating Symmetrix access controls

Validate that the Symmetrix Access Control (SymACL) security feature is enabled and in use on VMAX systems.

Before you begin

You are logged in to the client host with local root or administrator credentials.

Procedure

  1. Run the symacl list command for each VMAX array. Status information is displayed.
       S Y M M E T R I X   A C C E S S   C O N T R O L   S T A T U S
    
    Symmetrix ID: 000195700363
    
        Access    Session
        Control   Locked   Time Last Updated
        --------  -------  -------------------------
        N/A       N/A      N/A
    
    Symmetrix ID: 000195700932
    
        Access    Session
        Control   Locked   Time Last Updated
        --------  -------  -------------------------
        N/A       N/A      N/A
    
    • If the Access Control field indicates N/A, SymACL is not enabled on this VMAX system. No action is necessary.
    • If the Access Control field indicates Enabled, continue this procedure to secure ViPR SRM client systems from a host system in the existing SymACL AdminGrp for each VMAX system.
  2. Create a SymACL access group appropriate to contain the ViPR SRM client systems (e.g., SRMGRP)
  3. Add each client system's unique identifier to the access group.
  4. Repeat for each ViPR SRM client host system.
  5. Grant BASE access rights to the access group just created for all devices (ALL_DEVS).
  6. Repeat this procedure for each VMAX system monitored by ViPR SRM.
Back to Top

Limitation: some alerts not displayed

ViPR SRM fails to receive and display some alerts

If a trap is lost in the network communication, Solutions Enabler is not aware of the host and is not able to resend the lost information.

Back to Top