ViPR 2.1 - Add Windows Hosts and Clusters to ViPR

Table of Contents

Overview

ViPR Tenant Administrators can learn about ViPR support requirements, and prerequisite information to prepare Windows® hosts for ViPR integration, the steps to add the host to ViPR, the steps to configure the Windows host initiators, and the optional steps to add the host to a ViPR cluster.

This article is part of a series

You can add hosts to ViPR at anytime. If, however, you are setting up the virtual data center for the first time, complete the steps in Step by Step: Setup a ViPR Virtual Data Center.

Back to Top

ViPR configuration requirements for Windows hosts

Windows hosts must be configured as follows to be discovered by ViPR, and used for ViPR provisioning.

Windows version support

For supported versions, see the EMC ViPR Support Matrix on the EMC Community Network (community.emc.com).

Windows Remote Management (WinRM) must be enabled.

Refer to Configuring WinRM on a Windows Host for ViPR.

Either EMC PowerPath, or Microsoft MPIO (not both) must be enabled.

For details see either the EMC PowerPath and PowerPath/VE for Microsoft Windows Installation and Administration Guide or the Windows: Microsoft Multipath I/O Step-by-Step Guide.

Time synchronization is configured.

If using LDAP or Active Directory domain account credentials, the domain user credentials must be in the same domain where the Windows host is located; otherwise the Windows host discovery will fail.

Back to Top

Configuring WinRM on a Windows host for ViPR

Configures a Windows host to allow ViPR to run commands on it.

Before you begin

  • You must be logged in to the Windows host as administrator.
  • For the ViPR server to connect to Windows remote hosts, the host must accept remote Windows PowerShell commands. You can do this by enabling Windows remote access over HTTP.

Procedure

  1. At an administrator command prompt on the Windows host, issue the following command:
    winrm quickconfig
    This starts up a listener on port 5985. The port on which you start the listener must be consistent with the port that you configure for the host in the host asset page.
  2. You may need to make some configuration changes depending on how you want to connect to the host.
    • If you want ViPR to connect to the host as a local user, you need to:
      1. Check the winrm settings by running:

        winrm get winrm/config/service

        Basic Authentication and AllowUnencrypted must be set to true.

      2. If basic authentication is not set to true, run:

        winrm set winrm/config/service/auth @{Basic="true"}

      3. If AllowUnencrypted is not set to true, run:

        winrm set winrm/config/service @{AllowUnencrypted="true"}

      4. Add the host to the ViPR, Physical Assets > Hosts page.
    • If you want ViPR to connect to the host as a domain user, you need to:
      1. Ensure Kerberos is enabled. You can check using:

        winrm get winrm/config/service

      2. If you need to enable Kerberos, run:

        winrm set winrm/config/service/auth @{Kerberos="true"}

      3. A System Administrator must ensure that the domain has been configured as an authentication provider in ViPR (Security > Authentication Providers).
      4. A Tenant Administrator adds the host to ViPR (Physical Assets > Hosts) page.

        The credentials you supply for the host are of the form:

        domain\username

  3. Check that the host is displayed as valid in the table.

After you finish

After ViPR is deployed, you can check that the host is displayed as valid in the Physical Assets > Hosts page. If you receive the following message WinRM may not be enabled or configured properly, or there may be a network problem.

Failed to connect to host. Please ensure the connection details are correct. [Error connecting: Connection refused]

Back to Top

Add Windows hosts to ViPR

The following steps describe how to add a host to ViPR using the ViPR UI. To use the REST API to add a host to ViPR see Add Hosts and Clusters with the ViPR REST API

Before you begin

Hosts can only be added to ViPR by ViPR Tenant Administrators.

Procedure

  1. Select Physical Assets > Hosts.
  2. If working in a multi-tenancy environment, select the tenant.
  3. Click Add.
  4. Select Windows for the operating system type. .
  5. Enter a name to identify the host in ViPR.
  6. Enter the host fully qualified domain name or IP address.
  7. Select the protocol: HTTP or HTTPs
  8. Leave the default or type the port that ViPR will use to communicate with the host.
  9. Leave Discoverable enabled to allow ViPR to automatically discover, and register the host initiators, and discover if the host is part of a cluster.
    If Discoverable is disabled, host initiators must be manually registered to ViPR and, ViPR cannot identify if the host is part of a Windows cluster.
  10. Enter the host login credentials.
  11. Enable Validation on Save to enable ViPR to check connectivity to the host before saving the host details.
  12. Save.

After you finish

If Discoverable was not selected, continue to add and register the host initiators.

Back to Top

Network configuration requirements for hosts

After a host is added to ViPR, configure the networks if required before using the host in a service.

Fibre Channel

IP

Add the host ports to an IP network.

ViPR can discover the ports of IP connected storage systems and hosts , but it cannot discover the paths between them, so it is necessary to create IP networks, and then add the host, and storage system ports, which will be provisioned together, to the same IP network.

iSCSI

Hosts that use ViPR services with the iSCSI protocol must have their iSCSI ports logged into the correct target array ports before they can be used in the service.

Back to Top

Host initiator and host port configuration

Once the host has been added to ViPR, configure the host initiators, or host ports as required.

Back to Top

Deregister host initiators

Deregistering a host initiator leaves the host initiator in the ViPR assets, but makes it unavailable to use in any VIPR service operations.

Before you begin

Only host initiators, currently not in use in a ViPR export, can be deregistered.

Procedure

  1. Open the Host Initiators page.
    1. Select Physical Assets > Hosts.
    2. Locate the row for the host, and click the Initiators button in the Edit column.
  2. Check the box in first column of the row with the host initiator to deregister.
  3. Click Deregister.
Back to Top

Adding host initiators

Host initiators must be manually added for hosts that are not automatically discovered by ViPR.

Procedure

  1. Open the Host Initiators page
    1. Select Physical Assets > Hosts.
    2. Locate the row for the host, and click the Initiators button in the Edit column.
  2. Click Add.
  3. If Fibre Channel, enter the host initiator Node (World Wide Name) name.
  4. Enter the Port information:
    • World Wide Port Name (WWPN) for Fibre Channel.
    • iSCSI Qualified Name (IQN) for iSCSI .
  5. Click Add.

After you finish

After adding the host initiators, they must be registered before they are available for use in ViPR service operations.

Back to Top

Registering host initiators

Host initiators manually added to ViPR or host initiators previously unregistered in ViPR, must be registered to be used in a service.

Procedure

  1. Open the Host Initiators page.
    1. Select Physical Assets > Hosts.
    2. Locate the row for the host, and click the Initiators button in the Edit column.
  2. Check the box in first column of the row or rows with the host initiators to register.
  3. Click Register.
Back to Top

Add host ports to an IP network

If adding hosts to provision over an IP network, the host ports must be added to the IP network.

Before you begin

IP Networks are created by System Administrators. Tenant Administrators cannot configure IP networks or add host ports to the network.

Procedure

  1. Select Physical Assets Networks page.
  2. If the Network is already created, click the name from the list of networks.
    If the Network is not created, create it:
    1. Click Add IP Network.
    2. Enter the network Name.
    3. Select the storage systems to include in the network.
  3. Under the IP Ports table, click Add to manually add the host ports, or click the Add arrow, and select Add Host Ports to select from the list of discovered host ports.
  4. Enter or select the host ports to use in the IP network.
  5. Click Save.
Back to Top

Add a host to a cluster

Optionally, hosts can be added to ViPR clusters. Adding hosts to clusters allows service operations to be performed exclusively on a single host, or shared across all the hosts in a cluster.

Procedure

  1. Select Physical Assets > Clusters.
  2. If in a multi-tenancy environment, select the Tenant.
  3. If the cluster is not listed, create it:
    1. Click Add.
    2. Provide the name, and click Save.
  4. Locate the cluster that will be edited in the list of clusters.
  5. Click Edit Hosts in the right column in the same row as the cluster.
  6. Click Add.
  7. Check the box next to the host to add to the cluster, and click Add again.
Back to Top