Submit a ticketCall us

Looking to compare latest NPM features with previous versions of NPM?
The NPM new feature summary offers a comparison of new features and improvements offered with this release.

 

 

 

 

Home > Success Center > Storage Resource Monitor (SRM) > SRM: Enable the Solutions Enabler Appliance for EMC Symmetrix VMAX / VMAXe / DMX-4 / VMAX3 and VNX / CLARiiON array

SRM: Enable the Solutions Enabler Appliance for EMC Symmetrix VMAX / VMAXe / DMX-4 / VMAX3 and VNX / CLARiiON array

Updated: 11/1/16

Overview

The article contains information on enabling the Solutions Enabler Appliance so that EMC Symmetrix VMAX / VMAXe / DMX-4 / VMAX3 and VNX /  CLARiiON arrays can be monitored by SRM.

For more information, pleas consult the documentation supplied with your array, visit the EMC support site at https://sso.emc.com/ or contact your vendor.

Environment

  • SRM 6.1+

Credentials required to add the array

Ensure you have the following information:

  • IP address or hostname for the array
  • Provider username. The default is admin
  • Provider password. The default is #1Password
  • Protocol. The default is HTTPS.
  • HTTP port. The default is 5988.
  • HTTPS port. The default is 5989.
  • Interop namespace. The default is: /interop.
  • Array namespace. The default is: /root/emc.

Enable the 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

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 the EMC website.

If you choose to download the SMI-S provider software, log into the EMC website, click Support, and then search for SMI-S Provider Download and download the latest version.

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.

If you choose to download the Solutions Enabler Appliance software, log into the EMC website, click Support, and then search for Solutions Enabler.

Install the EMC provider

Before you configure the Provider:

  • The default ports for the Provider are 5988 for HTTP traffic and 5989 for HTTPS traffic. Make sure the ports are open. 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. For information on changing the port, see the vendor documentation.

  • Do not install your EMC Provider where ECC is installed or the Unisphere for VMAX is installed, if possible. The EMC provider shares the db files with these applications and can cause memory allocation errors in larger environments.

  • Symmetrix arrays are discovered automatically by the provider. The host where the provider is installed must have at least one gatekeeper LUN presented to it from the array. For better performance, EMC recommends having at least six gatekeepers per array.

  • Use the proper executable. If the server is 32 bit, use the 32 bit executable of the EMC Provider. If the server is 64 bit, use the 64 bit executable of the EMC Provider.

This section provide installation steps for the following operating systems:

  • Windows
  • Linux

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.
  3. Click Next. The Destination Folder dialog box opens and prompts you to select an install directory for the Solutions Enabler and EMC SMI-S Provider. SolarWinds recommends that you choose the default directory.
  4. Choose a location for the install, and then click Next. The Provider List dialog box appears.
  5. Select Array Provider, and then click Next.
  6. You are prompted with the Service List. Accept the default settings, and then click Next. The Installation dialog box appears.
  7. Click Install.
  8. 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 begins copying the files. When complete, the installation program automatically starts the storapid daemon and the cimserver, which may take a few minutes.
  5. When complete, the installation program returns 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]:

Find the arrays discovered by the EMC provider

Execute the dv command to display the arrays discovered by the provider.

Remove unwanted arrays from the EMC provider

Version 4.6.x can have CLARiiON/VNX arrays discovered or added in the same provider. Also, Symmetrix arrays that are SRDF connected to the local arrays are auto-discovered as well.

SolarWinds recommends having a dedicated provider for Symmetrix arrays with no more than two arrays provider.

If ECC or Unisphere for VMAX runs on the same server, do not attempt this method.

To remove symmetrix arrays from the provider:

  1. Create a file name named symavoid in the following directory:
    • Windows: c:\program files\emc\symapi\config
    • Linux: /var/symapi/config
  2. In the file, add the Symmetrix ID of the array to be removed, one ID per line.
  3. Save the file.
  4. Shut down the EMC Provider.
  5. Remove the symapi_db.bin from the following directory:
    • Windows: c:\program files\emc\symapi\db
    • Linux: /var/symapi/db
  1. Start up the EMC Provider.
  2. Check the arrays discovered by the EMC provider using the dv command and make sure removed arrays are not listed.

To remove auto-discovered CLARiiON/VNX from the provider:

  1. Create a file named claravoid in the following directory:
    • Windows: c:\program files\emc\symapi\config
    • Linux: /var/symapi/config
  2. Save the file.
  3. Restart the EMC provider.

Symmetrix

Symmetrix arrays are discovered automatically by the provider, so adding it to the provider using addsys command is not required. The host where the provider is installed must have at least one LUN presented to it from the array. For better performance, EMC recommends having at least six gatekeepers.

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 require 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

There should be at least one LUN mapped to this host from the array.

  1. Check the OSLSProvider.conf setting has discover set to 'true':
    • OSLSProvider.conf is located in the <install_dir>\ECIM\ECOM\Providers folder.
    • OslProv/com.emc.se.osls.osl.StorApi.database.discover=true
  1. List the authorization info:
    • <install_dir>\SYMCLI\bin\symcfg list auth
  1. If the list does not have entries for SPA and SPB of this array, stop the provider service(ECOM).
  2. Add the authorization for SPA and SPB using the following:
    • <install_dir>\SYMCLI\bin\symcfg authorization add -host <host> - username <user> -password <pass> where <host> is the IP Address of the storage processor.
  1. Start the provider service.

VNX/CLARiiON: out-of-band

Out-of-band VNX/CLARiiON are arrays that 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. Choose 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 Storage Manager

Adding a Symmetrix & VNX/CLARiiON Out-of-Band

Out-of-Band VNX/CLARiiON are arrays that 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. Choose the Array Type to be monitored (1 for Clariion, 2 for Symmetrix).

If choosing EMC Symmetrix, a LUN must be presented to the host where the EMC Provider is installed.

  1. 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.
  2. Type the Address type from step 5 above for both Storage Processors (2 if IP Address, 3 if Array ID).
  3. Type the Username and Password for a user with admin or manager privileges on the Array.

 

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

The output should look similar to 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 Storage Manager.

Installing the 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 search for Solutions Enabler Installation Guide.

SolarWinds recommends that you also download the latest OVA and ISO files for your Solutions Enabler Appliance software.

FAQs

The following section details FAQs regarding troubleshooting issues.

Q: What is the minimum version of the provider supported?

A: 4.6.2 and 8.x.

8.x is only for VMAX series.

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:

            Log in to <install_dir>\SYMCLI\storbin\testsmiprovider

Execute the dv command.

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

         To help protect your computer, Windows has closed this program.

Name: cimserver

A: To enable DEP for the SMI-s provider:

  1. Click Start > Run.
  2. Type sysdm.cpl, and then click OK.
  3. On the Advanced tab, under Performance, click Settings.
  4. On the Data Execution Prevention tab, use one of the following procedures:
    • Click Turn on DEP for essential Windows programs and services only to select the OptIn policy.
    • 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.
  1. Click OK two times.

The following link provides a detailed description of hardware and software based DEP: http://support.microsoft.com/kb/875352.

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

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 shows 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: What files are needed before opening a trouble ticket with EMC?

A: Any issues related to the EMC provider, EMC requires the following information before they will investigate a problem:

  • All log files from <install_dir>\symapi\log
  • All log files from <install_dir>\ECIM\ECOM\log
  • symapi_db.bin file, located at <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:

On the machine running the Provider:

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>

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

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

A: Log in to the provider GUI.

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

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

Example: The new user name is 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. Example: kill -SIGTERM [PID]
  • Restart: <install_dir>ECIM/ECOM/bin/ECOM -d

 

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.

 

 

 

Last modified
11:24, 2 Nov 2016

Tags

Classifications

Public