ViPR 2.2 - Add Windows Hosts and Clusters to ViPR

Table of Contents

Add Windows hosts 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.

Additionally, System Administrators can learn, the steps that will be required to configure the ViPR networks for Windows hosts.

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: Set Up 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

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

The following steps describe how to add a host to ViPR using the ViPR UI.

To use the REST API to add a Windows host to ViPR see, Add Hosts and Clusters to ViPR Using the ViPR REST API.

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 enter the port that ViPR will use to communicate with the host.
  9. Leave Discoverable enabled, to allow ViPR to automatically discover the WIndows host initiators, and Windows clusters, or disable the option to manually manage the initiators associated with the host., and not discover the Windows clusters.
    If Discoverable is disabled, the host initiators must be manually registered in ViPR.
  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 manually add and register the host initiators.

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

Host initiator and host port configuration

Once the host has been added to ViPR, Tenant Administrators can 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

Network configuration requirements for hosts

After a host is added to ViPR, System Administrators can 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

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

Replace Host Initiators after a storage volume has been exported to a host

Once you have used ViPR to export a volume to a host, you can add a host initiator to the export, remove a host initiator from the export, or perform both actions to swap out one host initiator for another in the export group.

Back to Top

Update ViPR after a host initiator is replaced outside of ViPR

After you use ViPR to export a volume to an AIX, ESX, Linux, or Windows host, which was added to ViPR as discoverable, you can, add, remove, or replace a host initiator used by ViPR for an export operation directly on the host, using an application other than ViPR.

Before you begin

After you add, remove, or replace a host initiator that was used by ViPR in an export operation, using an application other than ViPR, you must rediscover the fabric manager which provides connectivity between the host and the storage.

Procedure

  1. From the Physical Assets > Fabric Manager page, select the fabric manager on which the network between the host and the storage is configured.
  2. Click Rediscover.
    Rediscovering the fabric manager ensures the host initiators are discovered on the correct networks in ViPR. If the fabric manager is not rediscovered, the new host initiator will not have connectivity to the storage after the automatic update to the export is performed.
    The next time ViPR discovers the host, ViPR will detect that a host initiator was removed, and another host initiator was added, and will update the export as required.
Back to Top

Replace a host initiator of an undiscovered host after a ViPR export operation

If ViPR was used to export a volume to a host, which was added to ViPR as “Other,” or if the host was added as undiscoverable, use the following procedures to replace a host initiator with a different host initiator after the export operation:

Procedure

  1. In ViPR, add the host port, on which the host initiator resides, to the same network from which the host initiator is being replaced, so that ViPR will see the connectivity between the host and the storage after the swap is complete.
    This should be the host initiator which will replace the initiator in the export.
    1. Go to the Physical Assets > Networks page.
    2. Locate the network to which you are adding the host port.
    3. Click the network name.
    4. Click Add > Add Host Ports, at the bottom of the Fibre Channel Ports table.
    5. Add the host port on which the host initiator you are adding resides.
  2. Add the host initiator to the host in ViPR
  3. Register the host initiator in ViPR.
  4. Remove the host initiator, which will be replaced by the host initiator added in the previous steps, from ViPR.
    1. Locate the row for the host on which the host initiator is being removed.
    2. Click Initiator in the Edit column of the host row.
    3. Select the row for the host initiator being removed, and click Deregister.
    4. Click Delete to delete the host initiator from ViPR.
    ViPR automatically updates the host initiators in the export group after the add, and remove operations are detected in ViPR.
Back to Top