LBDiag is a utility for diagnosing load balancing in XenApp 6. LBDiag simulates the load balancing process for a user launching a specific application and provides a detailed report of the XenApp load balancing process. This simulation includes calculating load balancing policies, worker groups, server and application load evaluators, application installation, and multiple NIC support.
Prerequisites
LBDiag is only supported on XenApp 6. It must be run by a full Citrix administrator on a XenApp 6 server.
Installing LBDiag
To install LBDiag, copy the LBDiag.exe executable file to the desired location.
How to Use LBDiag
For command line options, run:
LBDiag.exe /?
There are four ways to use LBDiag to simulate load balancing for a user:
1. If the farm does not have any load balancing policies configured, simply run LBDiag <AppName>. If the server has multiple NICs, it is recommended to specify the client’s IPv4 address with the /CLIENTIP option to ensure the correct server address is returned.
2. If the load balancing policy for the user is known, run LBDiag <AppName> /POLICY <PolicyName>. If the server has multiple NICs, it is recommended to specify the client’s IPv4 address with the /CLIENTIP option to ensure the correct server address is returned.
3. Create a test user account with the same group memberships as the users you wish to simulate. Specify this user account by running LBDiag <AppName> /USER <UserName> /PASS <Password> /DOMAIN <Domain> /CLIENTNAME <ClientName> /CLIENTIP <ClientIP>. This calculates the load balancing policy for the test user account and simulates load balancing for the user.
4. Determine the group membership of the desired user, including all nested groups that could be used as a policy filter. This can be done by running the whoami /groups command as the user or by browsing the Member O” listings in the Active Directory Users and Computers snap-in. Specify the list of groups on the command line: LBDiag <AppName> /GROUPS <Domain><Group1> <Domain><Group2> … /CLIENTNAME <ClientName> /CLIENTIP <ClientIP>
LBDiag currently does not support calculating load balancing policies based upon Access Gateway filters. In this case, the policy name must be specified with the /POLICY option.
Security Permissions Required by LBDiag
LBDiag must be run as a full Citrix administrator.
Data Modified by LBDiag
LBDiag does not modify any registry or database values.
How to Undo the Changes Made by LBDiag
Not applicable.
Uninstalling LBDiag
Delete the LBDiag.exe file.
