Installing and Configuring EMC SMI-S

Provider and Solutions Enabler

Appliance (Symmetrix
VMAX/VMAXe/DMX-4/VMAX3)
Note: This information is provided as-is as a reference for our customers. VMTurbo
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. VMTurbo
does not provide official support for problems related to vendors SMI-S Providers.
VMTurbo provides some guidance on installing the EMC SMI-S provider and Solutions
Enabler Appliance software. VMTurbo provides some guidance on configuring provider
software.
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.

Downloading 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.
Installing 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

The following steps explain the installation process for 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. VMTurbo
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.

The following steps explain the installation process for 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:
o cd /<location of extracted files or CD>/UNIX
o ./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
#-----------------------------------------------------------
------------------

Logging 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]:

Finding the Arrays Discovered by the EMC Provider

Execute the dv command to display the arrays discovered by the 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.

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.

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

Troubleshooting
The following section details FAQs regarding troubleshooting issues.
Q: I get the following DEP error from windows for the SMI-s provider, how do I fix
it?
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:
o Click Turn on DEP for essential Windows programs and services
only to select the OptIn policy.
o 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.

5. Click OK two times.

The following link provides a detailed description of hardware and software based
DEP: http://support.microsoft.com/kb/875352.
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:

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.

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

Note: 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

Additional Resources
This section provides additional resources for installing EMC software:

EMC support portal

o Visit the EMC2 support portal for more information on installing the EMC
SMI-S Provider.