Product Documentation

Configuring virtual host connections for automated vDisk updates

Mar 08, 2017
To use vDisk Update Management, a designated hypervisor server is selected from within a virtual pool that is then used to communicate with Provisioning Services. This is accomplished by running the Virtual Host Connection Wizard.
Note: If running a vCenter server on alternate ports, the following registry modifications must be made in order to connect to it from Provisioning Services:
  • Create a new registry key named PlatformEsx under HKLM\Software\Citrix\ProvisioningServices
  • Create a new string value in the PlatformEsx key named ServerConnectionString and set it to http://{0}:PORT#/sdk (If using use port 300, ServerConnectionString= http://{0}:300/sdk)
To configure virtual host connections:
  1. Under the vDisk Update Management node in the Console tree, right-click on Hosts, then select the Add host... option. The Virtual Host Connection Wizard appears.
  2. Click Next to begin. The Hypervisor page appears.
  3. Select the radio button next to the type of hypervisor used by this pool, then click Next:
    • Citrix XenServer
    • Microsoft SCVMM/Hyper-V
    • VMWare vSphere/ESX

    The Name/Description page appears.

  4. Enter the name, and optionally a description, for the Virtual Host Connection then click Next.
  5. Enter the hostname or the IP address of the server to contact. If an ESX hypervisor was selected, you have the option to specify the datacenter to use when connecting to the host.
    Note: It can take several minutes before a hostname/IP address can be re-entered, if that hostname/IP was previously entered and then deleted.
  6. Click Next. The Credentials page appears.
  7. Enter the appropriate credentials required to connect to this host, then click Next:
    • Username – the account name with appropriate permissions to access the virtual host pool server.
    • Password – password used with this account name. The password must be a maximum of 32 characters.

    The Confirmation page appears.

  8. Review all settings are accurate, then click Finish.

Virtual Host Pool properties can be viewed or modified on the Virtual Host Connection Properties dialog.

General Tab

 

 

Field/button Description
Type The type of virtual host connection that was selected when the Virtual Host Connection Wizard was run. This field cannot be modified.
Name The name to use when referencing this virtual host connection by Provisioning Services.
Description A brief description of this virtual host connection.
Host The hostname or IP address of the virtual host connection server for Provisioning Services to contact.

To use a different port for the ESX server connection, in the server address field, enter the full connection string and include the correct port number. The format for the connection string is http://server_name:port/sdk

Note: If running a vCenter server on alternate ports, the following registry modifications must be made in order to connect to it from Provisioning Services:

  • Create a new key HKLM\Software\Citrix\ProvisioningServices\PlatformEsx
  • Create a new string in the PlatformEsx key named 'ServerConnectionString' and set it to 'http://{0}:PORT#/sdk' (If using use port 300, ServerConnectionString= http://{0}:300/sdk)

 

 

Datacenter Optional. If an ESX hypervisor was selected, you have the option to specify the datacenter to use when connecting to the host.

 

 

Credentials Tab

 

 

Field/button Description
Username The account user name required to connect to the virtual host server.
Password The account password that is associated with the username. The password must be a maximum of 32 characters.
Verify Connection button Click this button to verify that the username and password entered are valid and allow communications to the virtual host pool server.

 

 

Advanced Tab

 

 

Field/button Description
Update limit Controls the number of virtual machines that can concurrently process updates. Any additional updates are queued and start as virtual machines complete processing.
Update timeout The maximum amount of time allowed to perform an update to an image. If the update has not completed before the timeout period, the update is canceled. Maximum timeout = 240 minutes.
Shutdown timeout The maximum amount of time to wait for the virtual machine to shutdown. If the virtual machine has not shut-down before the time-out period, the virtual machine will force a shutdown by the server.
Port Sets the IP port number. This field is not available with VMWare vSphere/ESX.