Add Windows Hosts and Clusters to ViPR

TOC

BacktoTop

Overview

ViPR System and 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 cluster.

This article applies to EMC ViPR 2.0.

This article is part of a series

You can add hosts to ViPR at anytime. If however, you are setting up the ViPR Controller virtual data center for the first time, complete the following steps.
  1. Add physical assets to ViPR:
  2. Create ViPR virtual assets:
    1. Create and configure a virtual array
    2. Create virtual pools:

BacktoTop

Windows Server version support

BacktoTop

ViPR configuration requirements for Windows hosts

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

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.

BacktoTop

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. Ensure that your domain has been configured as an authentication provider in ViPR by a System Administrator (Security > Authentication Providers).
      4. Add the host to the ViPR Physical Assets > Hosts page by a System Administrator.

        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]

BacktoTop

Add Windows hosts to ViPR

Before you begin

Hosts can be added to ViPR by ViPR System Administrators, and Tenant Administrators.

Procedure

  1. Select Physical Assets > Hosts.
  2. If working in a multi-tenancy environment, select the Tenant.
  3. Add a host.
  4. Select Windows > Operating System.
  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. Enter 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.

BacktoTop

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.

BacktoTop

Host initiator and host port configuration

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

BacktoTop

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

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.

BacktoTop

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

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

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.

  • When a Windows host is added to ViPR with discovery enabled, ViPR identifies if the Windows host is part of a cluster, and adds the cluster to the ViPR physical assets. Once it is added to ViPR, the cluster can be managed and edited as a ViPR cluster. Changes made to the Windows cluster from ViPR will only be made in the ViPR environment, and will not be applied to the Windows configuration.
  • ViPR imports the Windows cluster information with the host, but does not discover the other hosts that are in the Windows cluster until the hosts are manually added to the ViPR physical assets.
  • A host can only be used in one cluster.
  • Hosts that are not currently in use in a ViPR service, can be moved to different clusters by adding it to the new cluster. The host does not have to be removed from the previous cluster, to move it to a new cluster. ViPR will recognize the last assigned cluster as the cluster to which the host belongs.
  • Clusters can only contain the same type of hosts.

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.