LBDiag

Created Date: March 17, 2010

Updated Date: March 23, 2012

Where to download ?

Certain legacy Citrix tools are now available on request only. Please submit the request here - https://forms.gle/obA39PEz5qpDiSPq8

Once we verify your request, we will provide access to the download location.

Description

LBDiag is a utility for diagnosing load balancing in XenApp 6 and later. 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 and later. It must be run by a full Citrix administrator on a XenApp server.

Installing LBDiag

To install LBDiag, copy the LBDiag.exe executable file to the desired location.

A more recent version of LBDiag.exe for use on XenApp 6.5 may be found on the XenApp 6.5 DVD, located at \Support\debug\LBDiag.exe.

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.

Contact Information

Questions? Concerns? Send any feedback for this tool to supporttools@citrix.com.

Disclaimer

These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.