Submit a ticketCall us

Announcing NCM 7.7
With NCM 7.7, you can examine the rules that make up an access control list for a Cisco ASA device. Then you can apply filters to display only rules that meet the specified criteria, order the rules by line number or by the hit count, and much more.
See new features and improvements.

Home > Success Center > Storage Manager (STM) > SRM Profiler Administrator Guide > Appendices > Configure storage arrays > EMC provider and Solutions Enabler Appliance (VNX/CLARiiON, Symmetrix, VMAX)

EMC provider and Solutions Enabler Appliance (VNX/CLARiiON, Symmetrix, VMAX)

Updated: June 16, 2017

This information is provided 'as-is' as a reference for our customers. SolarWinds provides no guarantees as to the accuracy of this information as the software is built and distributed by 3rd party vendors who may make changes at any time. SolarWinds does not provide official support for problems related to vendor's SMI-S Providers, but customers can seek support via Thwack. Our product team and other knowledgeable customers regularly use these forums and may be able to assist you.

SolarWinds provides some guidance on installing the EMC SMI-S provider and Solutions Enabler Appliance software. For more information on what a provider is see SMI-S provider.

The Solutions Enabler Appliance is an alternative to installing the Windows/Linux SMI-S provider software. This section explains the process of downloading, installing and configuring your software. This section also explains the task of adding a SAN to your provider, troubleshooting and provides additional resources. The following is included in this section:

  • Download software and documentation from EMC
  • Install EMC provider version 4.0 and later
  • Log into Your provider
  • Symmetrix
  • VNX/CLARiiON locally attached
  • VNX/CLARiiON out-of-band
  • Add a Symmetrix & VNX/CLARiiON out-of-band
  • Install EMC solutions Enabler Appliance
  • Troubleshoot EMC (All Versions)
  • Troubleshoot EMC Versions 4.0.0 and later
  • Additional resources

Download software and documentation from EMC

The following information provides instruction on how to download software and documentation from EMC.

The SMI-S provider, Solutions Enabler Appliance, and documentation can be downloaded from https://support.emc.com

If you choose to download the SMI-S provider software, log into the https://support.emc.com website, click Support and do a search for SMI-S Provider Download and download the latest version.

File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/0300008C_481x281.png

You can download a copy of the release notes by searching for smi-s provider release notes, sort by relevance, and download the version that matches your SMI-S software version. The release notes contain detailed instructions on installing and configuring your SMI-S software.

File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/0300008D_470x303.png

If you choose to download the Solutions Enabler Appliance software, log into the https://support.emc.com website, click Support and search for Solutions Enabler.

File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/0300008E_443x403.png

Install EMC provider version 4.0 and later

Before you configure the provider, please make sure you have the following information:

  • Controller IP Addresses
  • Unisphere ID and Password with at least manager privileges
  • The default ports for the Provider are 5988 for HTTP traffic and 5989 for HTTPS traffic.
  • Do not install your EMC Provider where ECC is installed, if possible.

Before installing the provider, run netstat to make sure the default ports are not being used. If another Cimom (ex: Solaris) or application (ex: IBM Director) is using that port, you must change the port the provider uses. Please review the vendor documentation for changing the port. This section provide installation steps for the following operating systems:

Windows:

  1. Download your software from the EMC website.
  2. Save all files and exit all Windows applications. Launch the self-extracting executable. For example: To install the EMC SMI-S Provider V4.6 software on a Windows platforms, launch the self-extracting executable, se76226-WINDOWS-x86-SMI.exe. The EMC Solutions Enabler with SMI X86 welcome page appears prompting you to install Solutions Enabler with SMI version x.x. click Next.
  3. The Destination Folder dialog box opens and prompts you to select an install directory for the Solutions Enabler and EMC SMI-S Provider. It is recommended that you choose the default directory. Choose a location for the install and click Next.
  4. The Provider List dialog box appears. Select Array Provider and click Next.
  5. You are prompted with the Service List. Accept the default settings and click Next.
  6. The Installation dialog box appears. Click Install.
  7. When the installation completes, click Finish.

Linux:

  1. Download the software from the EMC website.
  2. Extract the TAR image to a temporary directory.
  3. Change the directory to the location of the EMC SMI-S Provider kit and run the install script by using the following commands:

    cd /<location of extracted files or CD>/UNIX

    ./se<xxxx>_install.sh -install

  4. The installation program will begin copying the files. When complete, the installation program will automatically start the storapid daemon and the cimserver, which may take a few minutes.
  5. When complete, the installation program will return the following confirmation message, which lists EMC Solutions Enabler with SMI-S Provider in the HAS BEEN INSTALLED list:

    #--------------------------------------------------------------------------

    # The following HAS BEEN INSTALLED in /opt/emc via the rpm utility.

    #---------------------------------------------------------------------

    ITEM PRODUCT VERSION

    01 EMC Solutions Enabler V7.6.2

    SMI KIT V4.6.2

    #----------------------------------------------------------------------

Log into your provider

To log into the provider software, run the TestSmiProvider executable located at the <install_dir>\ECIM\ECOM\bin directory and accept the defaults for hosts, connection type, and port, for example:

  • Connection Type (ssl,no_ssl) [no_ssl]:
  • Host [localhost]:
  • Port [5988]:
  • Username [admin]:
  • Password [#1Password]:
  • Log output to console [y|n (default y)]:
  • Log output to file [y|n (default y)]:
  • Logfile path [Testsmiprovider.log]:

Symmetrix

Symmetrix arrays are discovered automatically by the provider. So it is not required to add it to the provider using 'addsys' command. The host where the provider is installed must have at least one LUN presented to it from the array. EMC recommends having at least 6 gatekeepers for getting better performance.

VNX/CLARiiON locally attached

A locally attached storage array is one in which at least one VNX/CLARiiON LUN is visible to the host on which the provider is running. The locally attached VNX/CLARiiONS are discovered automatically. But it requires the authorization information for each VNX/CLARiiON storage processor already added.

  1. Confirm the array to be added is locally attached:

    <install_dir>\SYMCLI\bin\syminq –cids

  2. There should be at least one LUN mapped to this host from the array.
  3. Check the OSLSProvider.conf setting has discover set to 'true':

    OSLSProvider.conf is located at <install_dir>\ECIM\ECOM\Providers folder.

    OslProv/com.emc.se.osls.osl.StorApi.database.discover=true

  4. List the authorization info:

    <install_dir>\SYMCLI\bin\symcfg list auth

  5. If the list does not have entries for SPA and SPB of this array, stop the provider service(ECOM)
  6. Add the authorization for SPA and SPB using:

    <install_dir>\SYMCLI\bin\symcfg authorization add –host <host> – username <user> -password <pass> where <host> is the IP Address of the storage processor.

  7. Start the provider service.

VNX/CLARiiON out-of-band

Out-of-band VNX/CLARiiON are arrays which do not have any LUNs presented to the host where the provider is running.

  1. Log into the Provider by following the steps from Logging into the Provider.
  2. Type "y" at Add System prompt.
  3. Chose the Array Type 1 for VNX/Clariion
  4. Type in the IP address of Storage Processor A and Storage Processor B
  5. Type the Address type 2 for both Storage Processors
  6. Type the Username and Password for a user with either Admin or Manager privileges on the Array.

If the addition of the Array is successful, you will get an output of 0 when the Array is discovered.

The output should look like the following:

++++ EMCAddSystem ++++

OUTPUT : 0

Legend:0=Success, 1=Not Supported, 2=Unknown, 3=Timeout, 4=Failed

5=Invalid Parameter

4096=Job Queued, 4097=Size Not Supported

System : //172.28.5.35/root/emc:Clar_StorageSystem.CreationClassName="Clar_StorageSystem",Name="CLARiiON+CK100060002000"

Make a note of the Identifier (CLARiiON+CK100060002000 in the sample output shown above), which is required for configuring the Array in SRM Profiler,

Adding a Symmetrix & VNX/CLARiiON out-of-band

Out-of-Band VNX/CLARiiON are arrays which do not have any LUNs presented to the host where the provider is running.

  1. Log into the Provider by following the steps from "Logging into the Provider".
  2. Run the addsys command.
  3. Type "y" at Add System prompt.
  4. Chose the Array Type to be monitored (1 for Clariion, 2 for Symmetrix).
    Note: If choosing EMC Symmetrix, a LUN needs to be presented to the host where the EMC Provider is installed.
  5. Type in the IP address of Storage Processor A and Storage Processor B if Clariion. Type the array id for Storage Processor A and Storage Processor B if Symmetrix
  6. Type the Address type from step 5 above for both Storage Processors (2 if IP Address, 3 if Array ID).
  7. Type the Username and Password for a user with admin or manager privileges on the Array.
    File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/0300008F.png

If the addition of the Array is successful, you will get an output of 0 when the Array is discovered.

The output should look like:

++++ EMCAddSystem ++++

OUTPUT : 0

Legend:0=Success, 1=Not Supported, 2=Unknown, 3=Timeout, 4=Failed

5=Invalid Parameter

4096=Job Queued, 4097=Size Not Supported

System : //172.28.5.35/root/emc:Clar_StorageSystem.CreationClassName="Clar_StorageSystem",Name="CLARiiON+CK100060002000"

Make a note of the Identifier (CLARiiON+CK100060002000 in the sample output shown above), which is required for configuring the Array in SRM Profiler.

Install EMC Solutions Enabler Appliance

You can download instructions for installing and configuring your software from the EMC website. Log into your EMC account, click the Support tab, and do a search for Solutions Enabler Installation Guide.

File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/03000090_514x339.png

It is also recommended that you download the latest OVA and ISO files for your Solutions Enabler Appliance software.

Troubleshoot EMC (all versions)

The following section details FAQs regarding troubleshooting issues.

Q: How do I find the version of the provider?

A: To find the provider version, do the following:

<install_dir>\SYMCLI\bin\symcfg –version

OR

Login to <install_dir>\SYMCLI\storbinestsmiprovider

Execute the dv command.

Q: What port is used between the EMC Provider and VNX/Clariion?

A: Port 443 is used for bidirectional communication between the EMC Provider and VNX/Clariion.

Q: Why is my VNX/Clariion not reporting performance data?

A: Statistics logging must be turned on.

To enable Statistics Logging, do the following:

  1. Open Unisphere.
  2. Right click the icon for the storage system.
  3. Click Properties.
  4. Be sure SP A and SP B are in the System Level setting section.
  5. Click the box for Statistics Logging under the Configuration section.

Q: What is the minimum flare code level that EMC recommends for the VNX/CLARiiON arrays to work with the EMC SMI Provider?

A:

   For release R26 à R26.031 for CX3 arrays and R26.028 for CX arrays

   For release 28 à R28.707 for all arrays

   For release 29 à R29.006 for all arrays

Q: What are some steps I can follow to get VNX/Clariion Performance data?

A: The following are some steps that can be followed:

  1. Make sure Statistics are enabled for the array on SP A and SP B in Unisphere (Follow instructions in the section: Why is my VNX/Clariion not reporting performance data?).
  2. For locally attached VNX/CLARiiONs, check if authorization info is present. See section: Adding Authorization Info for Locally Attached VNX/CLARiiON.
  3. Run EMC TestSMIProvider and run the command 'dv'. Make sure all array are discovered without any errors.
  4. Make sure there are instances for class name CIM_BlockStorageStatisticalData when enumerating instance names (ein). To do this, do the following:
    1. Run Tek-Tools testProvider or EMCs testSMIProvider (Logging In instructions above in Tools section).
    2. Type ein for command.
    3. Type CIM_BlockStorageStatisticalData for Class Name.

If no instances are returned, follow the instructions on resetting EMC provider (How do I reset EMC provider?). Once complete, repeat steps 1-3 again.

Q: How do I get data for a CX600?

A: Per EMC, they do not support flare code 16 (2.16.x.x.x). The array must be upgraded to 19, 22, or 24 with all the latest patches for that release

Q: I get the following DEP error from windows for the SMI-s provider, how do I fix it?

File:Success_Center/Reusable_content_-_InfoDev/SRM_Profiler/EMC_Provider_and_Solutions_Enabler_Appliance_VNX_CLARiiON_Symmetrix_VMAX/03000091_273x133.png

A: To enable DEP for the SMI-s provider, do the following:

  1. Click Start. Click Run. Type sysdm.cpl, and then click OK.
  2. On the Advanced tab, under Performance, click Settings.
  3. On the Data Execution Prevention tab, use one of the following procedures:
    1. Click Turn on DEP for essential Windows programs and services only to select the OptIn policy.
    2. Click Turn on DEP for all programs and services except those I select to select the OptOut policy, and then click Add to add the programs that you do not want to use the DEP feature.
  4. Click OK twice.
    The following link below gives a detailed description of hardware and software based DEP: http://support.microsoft.com/kb/875352

Q: What permissions are required when configuring a user in Unisphere?

A: You have to have an Admin or Manager privileges in order to discover.

Monitor privileges are not enough.

Q: Why does the addsys command fail when trying to add an array to be monitored by the EMC Provider?

A: When running addsys, make sure of the following:

Make sure the user used has at least manager privileges.

Make sure that spA and spB are in correct order. To get the correct IP address for the storage processors, follow the instructions in the question "How do I get the IP address for the storage processors from Unisphere."

Array ID 0 refers to spA, and Array ID 1 refers to spB.

Q: Why do commands like 'addsys' and 'dv' fails with "Error: CIM_ERR_FAILED: A general error occurred that is not covered by a more specific error code: provider initialization failed "?

A: Check whether the provider is installed on a 64-bit OS, if then check that provider installed supports 64 bit OS (Check in Provider Release Notes-àSupported Host Operating System). Provider installs including version 3.3 supports only 32 bit OS.

Q: How do I get the IP address for the storage processors from Unisphere?

A: To get the correct IP address from Unisphere, do the following:

  1. Go to Unisphere.
  2. Right-click on spA for the array you wish to add.
  3. Click Properties.
  4. Click Network. (This will show the IP address for spA).
  5. Do steps 2 – 4 for spB.

Q: The server where we planning to install have a version of Solutions Enabler installed. How do I determine which version of the provider to use in this case?

A: Solutions Enabler is used by the provider as well as EMC management applications like ECC. It is better to install the provider on another server if possible. Otherwise, follow these steps to find out the correct version.

Check the version of the solutions enabler:

<install_dir>\SYMCLI\bin\symcfg –version

The output show the version of the solutions enabler installed.

Check the solutions enabler version of the installer. It can be found from the name of the installer.

Example: se76226-WINDOWS-x86-SMI.exe is packed with Solutions Enabler version 7.6.2

Install only if the versions match. If the versions do not match, check to see if the solutions enabler can be upgraded to the required version without affecting ECC or other management applications currently installed.

Q: Array Capacity (Raw) on the console screen shows non-zero value for Free capacity even though the Physical Disk Report shows that all disks are assigned to raid-groups. Isn't the free capacity representing the total capacity of the disks which are not assigned to any raid-groups?

A: This following response is from EMC.

The observed behavior is consistent with the way VNX/Clariion works. On VNX/Clariion, it is possible to see the primordial pool with RemainingManagedSpace having a non-zero value even though all disk drives are in use. In this situation, the value in the RemainingManagedSpace represents a collection of "left-over", unusable, disk capacities after the raid groups are created (i.e. concrete pools). For example, let's assume there are two disk drives available in a VNX/Clariion, with the capacities of 10 and 15 gigabytes. The client wishes to create a raid 1, raid group from these two disk drives. Because both disk drives should have the same size, the array uses the first disk drive with the capacity of 10 gigabytes and the first 10 gigabytes of the second disk drive. The remaining 5 gigabytes of the second disk drive will remain unused and is reported as a part of the RemainingManagedSpace capacity of the primordial pool.

One way to determine if all disk drives are in use is to examine the primordial pool's "EMCRemainingRawCapacity" property. If this property contains 0, it means all disk drives are in use by various concrete pools.

Q: EMC posted and End of Service Life for the Solutions Enabler and SMI-S provider, what are the versions affected and the end of life dates?

A:

Product

Version

EOSL Date

SMI-S Provider

3.0

10/2008

SMI-S Provider

3.1

10/2009

SMI-S Provider

3.2

10/2010

Solutions Enabler

5.5.1

9/30/2008

Solutions Enabler

5.4

9/30/2008

Solutions Enabler

5.5

9/30/2008

Solutions Enabler customers who choose to upgrade their environments to SMI-S Provider version 4.6.2 must uninstall their existing versions of Solutions Enabler before the installation. The SMI-S Provider V4.6.2 installation is bundled with the required Solutions Enabler libraries. For more information see the SMI-S provider release notes for version 4.6.2.

Q: Why is Symmetrix not showing correct number hosts masked into array?

A: Look at the symapi log file and look for following message:

'SymDevMaskLoginHisto The VCMDB_RESTRICTED bit on symm 000187751584 is set, only records for this host will be returned'

This message means that the host the provider is running on needs to be able to obtain all the vcmdb info. EMC does not provide instructions on how to change this value and EMC should be consulted for any additional steps.

Q: Can we use the EMC provider to monitor the VNX/CLARiiON behind the Celerra NS-20 device?

A: Yes, it works the same way as a regular VNX/Clariion

Troubleshoot EMC versions 4.0.0 and later

Q: LocalDir/admin no longer works in 4.1.1 provider, did the user name change?

A: Yes, username for 4.1.1 provider is now admin.

Q: What files are needed before opening a trouble ticket with EMC?

A: Any issues related to the EMC provider, EMC requires the following info before they'll look into the problem:

All log files from <install_dir>\symapi\log

  • All log files from <install_dir>\ECIM\ECOM\log
  • symapi_db.bin file, located <install_dir>\symapi\db
  • Output of the 'dv' command from the TestSmiProvider utility
  • Output of the 'tms' command from the TestSmiProvider utility

Q: How do I change the provider port?

A: To change the port, do the following:

On the machine running the Provider:

  1. Stop the ECOM Service.
  2. Navigate to <Install_dir>\ ECIM\ECOM\conf
  3. Edit the properties of the file and uncheck Read-only, click OK.
  4. Open the file named port_settings.xml.
  5. Change the port0 and port1 tag values to ports currently not in use.

    Example:

    <ECOMSetting Name="Port0">

    <port>15988</port>

    <secure>false</secure>

    <slp>true</slp>

    </ECOMSetting>

    <ECOMSetting Name="Port1">

    <port>15989</port>

    <secure>true</secure>

    <slp>true</slp>

    </ECOMSetting>

  6. Save port_settings.xml file.
  7. Start the ECOM Service.

Q: How do I add a new user to the provider?

A: Login to the provider GUI.

  1. Go to the URL https://<ipaddress>:5989/ecomconfig, and log in using the username LocalDir/admin and the password #1Password.
  2. Click Add User and create a user with the role of Administrator. This newly created username can now be used to obtain access to the Array Provider.

"LocalDir/' will prepended to the username whenever a new user is created.

Example: The new user name will be LocalDir/<the user name that you have given>

Q: How do I start/stop the provider from command prompt?

A:

Windows:

  • Stop à <install_dir>ECIM/ECOM/bin/sm_service stop ecom.exe
  • Start à <install_dir> ECIM/ECOM/bin/sm_service start ecom.exe

UNIX:

  • Stop à Obtain the PID of the ECOM process and issue the kill command for that PID. ie kill –SIGTERM [PID]
  • Restart à <install_dir>ECIM/ECOM/bin/ECOM –d

Q: How do I prevent locally attached VNX/Clariion from being discovered automatically?

A: To remove a locally attached VNX/CLARiiON from auto discovery, write out a file with name 'claravoid' in the directory SYMAPI/config. The file must have the name of the VNX/CLARiiON.

Q: How do I prevent Symmetrix arrays from being discovered automatically?

A: DO NOT use this method if the host where the provider is installed also has ECC running. Write out a file with name 'symavoid' in the directory SYMAPI/config. The file must have the SymmID of the Symmetrix arrays that should not be auto-discovered.

Use the command 'SYMCLI\bin>symcfg list' to get the SymmID.

Make sure that the provider is not running when you make the change. Delete the symapi_db.bin file and re-discover for the changes to take effect.

Q: Will the LocalDir/admin password expire?

A: Yes, it will expire after 90 days. EMC was not aware of this, and are looking into making it tunable in a future release. So as of 4.1 release, it will expire. If user resets password, it again expire in 90 days after resetting. If user creates new user, it will password expire in 90 days. You can change password from https://<ipaddress>:5989/ecomconfig

Additional resources

This section provides additional resources for installing EMC software:

Disclaimer: Please note, any content posted herein is provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software or documentation that you purchased from SolarWinds, and the information set forth herein may come from third parties. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment.  You elect to use third party content at your own risk, and you will be solely responsible for the incorporation of the same, if any.

Screenshots property of © 2016 Dell EMC

 
Last modified
11:17, 26 Jun 2017

Tags

Classifications

(not set)