ViPR SRM 3.6 – Install and Manage EMC Host Interface Software

Table of Contents

Installing the EMC Host Interface on Windows Server

Learn how to install the EMC Host Interface. The EMC Host Interface is host agent software which enables ViPR SRM to collect data from supported hosts without requiring host credentials.

The EMC Host Interface software is installed as a Windows service on supported Windows hosts to enable data collection between the host and SRM Suite.

The installer automatically installs a prerequisite ( Microsoft Visual C++ 2005 Service Pack 1 Redistributable) before installing the EMC Host Interface software.

Back to Top

Installing the EMC Host Interface using the Command Line

You can choose local or LDAP authentication when installing EMC Host Interface using the command line. For both local and LDAP authentication, local database files are protected and encrypted using the RSA Common Security Toolkit.

Local authentication

The local authentication option installs a database on the local host which maintains authentication with a username and password.

LDAP authentication

The LDAP authentication option configures authentication using an LDAP server providing centralized control of authentication credentials.

Back to Top

Installing EMC Host Interface with LDAP authentication

Install the EMC Host Interface and configure LDAP authentication using the command line.

Before you begin

Consult the EMC ViPR SRM Support Matrix for information on supported Windows host operating systems on which you can install EMC Host Interface software.

This procedure describes the commands and parameters used to install the EMC Host Interface on a single server. You can also run the installer using remote push technology that supports MSI/EXE and use the parameters and push technology options to control the installation.

Procedure

  1. Download the EMC Host Interface Setup File to a temporary location on the local host.
  2. Open a command prompt and navigate to the temporary location.
  3. Construct the executable syntax from the command line using the following security parameters.
    Option Description
    SECURITY LDAP - Use provided LDAP Authority.
    USER Represents LDAP user to be given access rights.
    LBPASS Password to be given to secure lockbox store holding LDAP configuration information, min length 8, max length 40, alpha number mix required, mixed case required. Default: #1Password
    PORT Port number of the LDAP service. Default: 389
    SERVER Hostname or IP Address of the LDAP server to use for authentication. There is no default value.
    DOMAIN Distinguished Name (DN) of the privileged account used to perform operations, such as searching users and groups, on the LDAP directory. There is no default value.
    BINDPASS Password of the privileged account for accessing LDAP server. There is no default value.
    USERSEARCH DN of the node at which to begin user searches.
    GROUPSEARCH DN of the node at which to begin group searches. There is no default value.
    CONFIGNAME Name of this LDAP configuration/authority, when logging with agent pack use CONFIGNAME/USER. There is no default value.
    USEROBJCLASS

    (EHI 1.2)

    VALUE of the objectClass attribute of a user. Any of the attribute values on your LDAP server (person, organizationalPerson, user) can be specified.
    USERNAMEATTR

    (EHI 1.2)

    Similar to USERIDATTR, supply an attribute name that contains the value of the user name.
    USERIDATTR

    (EHI 1.2)

    Attribute name that contains a value of the user name. On LDAP servers, any one of the following attribute names can be used: cn, displayName, givenName, name, sAMAccountName. All of these attributes appear to contain the value of the user name.
    GROUPOBJCLASS

    (EHI 1.2)

    VALUE of the objectClass attribute of a group. On LDAP servers 'group' indicates a group class.
    GROUPNAMEATTR

    (EHI 1.2)

    Attribute name of a group entry that contains a value of the group name. Instead of mapping each user individually to a role, a group can be mapped to the administrator role. After mapping a group, all users within this group have administrator rights. On LDAP servers, the attribute 'cn' appears to contain the group name.
    GROUPMEMATTR

    (EHI 1.2)

    Attribute name of a group entry that contains the list of users within a group.
    INSTALLDIR

    (EHI 1.2)

    User defined directory for EHI installation.
  4. Establish LDAP authentication as shown in the following example:
    For EHI 1.1:
    Emc-host-interface.exe SECURITY=LDAP USER=myldapuser LBPASS=$4Secret PORT=389 SERVER=ldap.company.com DOMAIN=”uid=admin, ou=Administrators,ou=TopologyManagement,o=netscaperoot” BINDPASS=Password USERSEARCH=”ou=People,dc=emc,dc=localdomain” GROUPSEARCH=”ou=Groups,dc=emc,dc=localdomain” CONFIGNAME=”company.localdomain”
    For EHI 1.2:
    Emc-host-interface.exe SECURITY=LDAP USER=myldapuser LBPASS=
    $4Secret PORT=389 SERVER=ldap.company.com DOMAIN=”uid=admin,
    ou=Administrators,ou=TopologyManagement,o=netscaperoot”
    BINDPASS=Password USERSEARCH=”ou=People,dc=emc,dc=localdomain”
    GROUPSEARCH=”ou=Groups,dc=emc,dc=localdomain”
    CONFIGNAME=”company.localdomain” USEROBJCLASS="objectClass attribute of a user" USERNAMEATTR="attribute name" USERIDATTR="attribute name"
    GROUPOBJCLASS="objectClass attribute of a group" GROUPNAMEATTR="attribute name of a group entry that contains a value of the group name"
    GROUPMEMATTR="attribute name of a group entry that contains the list of users within a group" INSTALLDIR="Instalation Directory"

Results

You can use these credentials when accessing the host using the SolutionPack for Physical Hosts. For example, use credentials:

Username: company.localdomain/myldapuser or myldapuser@company.localdomain

Password: ldap_user_password

After you finish

Verify installation by accessing the log file in:install_dir\log\installation.log

Troubleshoot runtime issues by accessing the log file in: install_dir\log\cimomlog.txt

Back to Top

Installing EMC Host Interface with local authentication

Install the EMC Host Interface from the command line using the LOCAL authentication option.

Before you begin

Consult the EMC ViPR SRM Support Matrix for information on supported Windows host operating systems on which you can install EMC Host Interface software.

This procedure describes the commands and parameters used to install the EMC Host Interface on a single server. You can also run the installer using remote push technology that supports MSI/EXE and use the parameters and push technology options to control the installation.

Procedure

  1. Download the EMC Host Interface Setup File to a temporary location on the local host.
  2. Open a command prompt and navigate to the temporary location.
  3. Construct the executable syntax from the command line using the following security parameters.
    Option Description
    SECURITY LOCAL - database maintained on local machine
    USER Username for authentication. Default: admin
    LBPASS Password to be given to LOCAL user, min length 8, max length 40, alpha number mix required, mixed case required. Default: #1Password
  4. Do one of the following:
    • Establish local authentication using the default credentials (admin/#1Password) as shown in the following example: C:/temp/Emc-host-interface.exe
    • Specify local authentication and provide your own credentials as shown in the following example: C:/temp/Emc-host-interface.exe SECURITY=LOCAL USER=myaccount LBPASS=$4Secret

Results

You can use these credentials when accessing the host using the SolutionPack for Physical Hosts.

After you finish

Verify installation by accessing the log file in:install_dir\log\installation.log

Troubleshoot runtime issues by accessing the log file in: install_dir\log\cimomlog.txt

Back to Top

Installing or Upgrading the EMC Host Interface using the GUI

Install or Upgrade the EMC Host Interface using the GUI.

Before you begin

Consult the EMC ViPR SRM Support Matrix for information on supported Windows host operating systems on which you can install EMC Host Interface software.

The GUI installation is not supported with Server Core installations of Windows Server. Server Core installations require the command line installation.

Procedure

  1. Download the EMC Host Interface executable (emc_host_interface-versionplatform) to a temporary location on the local host.
  2. Navigate to the temporary location, double click the executable, and click Run.
    The EMC Host Interface installation wizard displays.
  3. Click Next.
  4. Accept the license agreement.
  5. Click Next.
  6. Specify the installation directory.
    For upgrades, you must accept the default installation directory where the previous version was installed.
  7. Click Install.
  8. After the installation is complete, click Finish.
  9. Click Close.
  10. Verify that two EMC Host Interface processes (EMCHost.exe) have been created and are running.
    In earlier versions of the EMC Host Interface, the processes were named ECOM.exe.
Back to Top