Connecting to Workload Balancing


XenCenter 2023.x.x is currently in preview and is not supported for production use. Note that any future references to production support apply only when XenCenter 2023.x.x and XenServer 8 go from preview status to general availability.

You can use XenCenter 2023.x.x to manage your XenServer 8 and Citrix Hypervisor 8.2 CU1 non-production environments. However, to manage your Citrix Hypervisor 8.2 CU1 production environment, use XenCenter 8.2.7. For more information, see the XenCenter 8.2.7 documentation.

You can install XenCenter 8.2.7 and XenCenter 2023.x.x on the same system. Installing XenCenter 2023.x.x does not overwrite your XenCenter 8.2.7 installation.

After importing the Workload Balancing virtual appliance and running the Workload Balancing Configuration wizard, you must connect the pool you want monitored to Workload Balancing. To do so, use either the Connect to WLB Server dialog box in XenCenter or the xe CLI.


The WLB tab appears on the Properties pane after you license your hosts with XenServer Premium Edition. For more information about licensing, see About XenServer Licensing.


To complete the XenCenter procedure that follows, you need the:

  • IP address or Fully Qualified Domain Name (FQDN) and port of the Workload Balancing virtual appliance.
  • Credentials for the resource pool (that is, the pool coordinator) you want Workload Balancing to monitor.
  • Credentials for the account you created on the Workload Balancing appliance. This account is often known as the Workload Balancing user account. XenServer uses this account to communicate with Workload Balancing. (You created this account on the Workload Balancing virtual appliance during Workload Balancing Configuration.)

If you want to specify the Workload Balancing virtual appliance’s FQDN when connecting to the Workload Balancing server, first manually add its host name to your DNS. If you want to configure Trusted Authority certificates, Citrix recommends specifying either an FQDN or an IP address that does not expire.

When you first connect to Workload Balancing, it uses the default thresholds and settings for balancing workloads. Automatic features, such as Automated Optimization Mode, Power Management, and Automation, are disabled by default.


If you don’t receive optimal placement recommendations after WLB runs for a time, Citrix recommends you evaluate your performance thresholds. For more information, see Evaluating the Effectiveness of Your Optimization Thresholds. It is critical to set the correct thresholds for your environment for Workload Balancing recommendations to be optimal.

To connect to the Workload Balancing virtual appliance

  1. In the Resources pane of XenCenter, select XenCenter > your-resource-pool.
  2. In the Properties pane, select the WLB tab. The WLB tab appears in the Properties pane after licensing your XenServer hosts.
  3. In the WLB tab, select Connect. The Connect to WLB Server dialog box appears.
  4. In the Server Address section, dialog box, enter the following:
    • In the Address box, type the IP address or FQDN of the Workload Balancing server. An example of an FQDN is WLB-appliance-computername.yourdomain.net.
    • Enter the port number in the Port box. XenServer uses this port to communicate with Workload Balancing.

      By default, XenServer connects to Workload Balancing (specifically the Web Service Host service) on port 8012. If you changed the port number during Workload Balancing Configuration, you must enter that port number in the Port box.


      Change the default port number only if you changed the default port during Workload Balancing Configuration. The port number specified during Configuration, in any firewalls, and in the Connect to WLB Server dialog must match.

  5. In the WLB Server Credentials section, enter the user name (for example, wlbuser) and password that XenServer uses to connect to the Workload Balancing virtual appliance. This account must be the account you created during Workload Balancing Configuration. By default, the user name for this account is wlbuser.
  6. In the XenServer Credentials section, enter the user name and password for the pool you are configuring. Workload Balancing uses these credentials to connect to each of the hosts in that pool. To use the credentials with which you are currently logged into XenServer, select the Use the current XenCenter credentials check box. If you have assigned permissions to the account using the Role Based Access Control feature (RBAC), be sure they are sufficient to use Workload Balancing. See Definitions of RBAC roles and permissions.
  7. After connecting to the Workload Balancing appliance, if you want to change the settings for thresholds or the priority given to specific resources, see Editing Workload Balancing Settings.
Connecting to Workload Balancing