Product Documentation

Configure the Virtual Machine service

Jun 05, 2015
Updated: 2014-01-06
To configure the Virtual Machine service, you perform the following tasks:
  • Configure the Virtual Machine service using the control panel
  • Synchronize resources from the SCVMM server
  • Configure the virtual networks that customers will use

To configure the Virtual Machine service

  1. Enable the service (top level):
    1. From the Services Manager menu bar, select Configuration > System Manager > Service Deployment, expand Virtual Machine, and click Save.
    2. Expand Virtual Machine, click Customer Plans, and create a customer plan if one is not already created. Verify and save the settings. Customer plan settings include per-customer machine limits and whether dynamic disks are used. Typically, dynamic disks are disabled to avoid over-subscription of disk storage. However, some Service Providers enable dynamic disks to increase provisioning speed.
  2. Enable and configure the service (location level): Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, expand Virtual Machine, and click Service Settings. Verify the settings, making sure that the following settings are configured, and then save the service:
    RDP Console URL
    Defaults to VMConnection.aspx.
    Self Service Role
    Set to SelfService, the name of the self-service user group configured in SCVMM.
    Virtual Machine Path
    If the customer will use clustered Hyper-V hosts, change the path from {PreferredDrive}Images{CustomerShortName} to {PreferredDrive}{CustomerShortName}. That change helps prevent folder creation errors in the cluster shared volume.
  3. Add the credentials for the service account:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Credentials. The Credentials Overview page appears.
    2. In the credentials table, click Add.
    3. In Username and Password, enter the user name and password for the service account.
    4. Leave Encrypted selected to encrypt the credentials as they are displayed on the page and stored in the database.
      Note: Citrix recommends encrypting credentials when Services Manager is deployed in a production environment. Use plain-text credentials only for debugging purposes.
    5. In Domain, enter the FQDN of the service account.
    6. Click Add to save your entries.
  4. Enable the server:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Servers.
    2. If the SCVMM server is not listed, click Refresh Server List.
    3. Expand the entry for the server and verify that Server Enabled is selected.
  5. Assign server roles:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Roles and then expand the entry for the SCVMM server.
    2. Under Server Connection Components, select Virtual Machine. Virtual Machine refers to the VirtualMachineWS.
    3. Under Server Roles, select Virtual Machine Manager and then click Save. Virtual Machine Manager indicates that SCVMM is installed on the server.
  6. Add a server connection:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Connections, click New Connection, and then select or type the following information for the SCVMM server.
      Server Role
      Choose Virtual Machine.
      Server
      Choose the server where the VM web service is running.
      Credentials
      Choose the credentials for the service.
      URL Base
      Defaults to /VirtualMachine/VirtualMachine.asmx.
      Protocol
      Defaults to http.
      Port
      Defaults to 8095. If you change the port here, change it also in the Services Manager Web Service.
      Timeout
      Citrix recommends that you change the setting from 200000 to 2000000 milliseconds. This increases the timeout to about 35 minutes, needed for disk creation operations.
    2. Click Save.
    3. From the Services Manager menu bar, choose Configuration > System Manager > Server Connections and click the icon in the Test column for the SharePoint server. The icon turns green for a successful connection. A red icon indicates an unsuccessful connection. Mouse over it for information about the failed connection.

To synchronize resources

This procedure verifies the server role and connection configuration and retrieves information from the SCVMM server.

  1. From the Services Manager menu bar, choose Services > Virtual Machine > Configuration > Virtual Resource Manager.
  2. Under Environment, choose the Location and SCVMM server. Incorrect entries in those lists indicate incorrect configuration of server roles or server connections.
  3. Click Refresh. The message "The Resources were updated successfully" appears. If it does not, verify the configuration.
  4. Expand the resource folders and verify their contents:
    1. Provide user-friendly labels and group names. For example, you might rename "Server03x64WE-DE” to “64-bit Windows Server 2003 – German".
    2. Review assignments.
    3. Assign sets of items to groups, such as "SQL Server DVDs", to speed selection of resources during provisioning.
  5. (Optional) Import existing Hyper-V VMs into the Service Manager customer: Before moving a VM to a customer, verify that it resides on a host assigned to that customer, along with the relevant VLANs.
    1. Expand Virtual Machines and locate a VM not yet managed by Services Manager (their names appear dimmed).
    2. Select the VM and use the right pane to search for a customer.
    3. Click Provision.

To configure virtual networks

You can create the following types of VLANs:
  • Dedicated – Can be assigned to one customer only (most commonly used).
  • Shared – Can be assigned to one or more customers.
  • Reserved – Not usable for customers. For instance, you might add an out-of-band management VLAN to ensure a customer is not accidently placed into the same network.
  • Mandatory – Available to all customers.

You can assign multiple subnets to a VLAN and use Services Manager to define a default gateway, DNS servers, and range for the subnet.

To configure virtual networks, choose Services > Virtual Machine > Configuration > Virtual Network Manager.