Citrix Authentication Test

This test emulates a user login process at the system level on a XenApp server and reports whether the login succeeded and how long it took.

Target of the test : Any Citrix server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every user account being checked

Configurable parameters for the test
  1. TEST PERIOD - How often should the test be executed
  2. Host - The host for which the test is to be configured
  3. Port - Refers to the port used by the Citrix server 
  4. user - This test emulates a user login process at the system level on a XenApp server. Therefore, specify the login name of a user with interactive logon and logon locally privileges.
  5. password - Enter the password that corresponds to the specified USERname.
  6. confirm password – Confirm the specified password by retyping it here.
  7. domain - Specify the name of the domain to which the test will try to login. If the test is to login to a local host, specify 'none' here. 

    Note:

    If users are spread across multiple domains, then, you can configure this test with multiple domain specifications; in this case, for every domain, a user-password pair might also have to be configured. Sometimes, you might want the test to login as specific users from the same domain, to check how long each user login takes. Both these scenarios require the configuration of multiple domains and/ormultiple user names and passwords. In order to enable users to specify these details with ease, eG Enterprise provides a special page; to access this page, click on the Click here hyperlink at the top of the parameters in the test configuration page. To know how to use this page, refer to Configuring Multiple Users for the Citrix Authentication Test of this document.

  1. report by domain - By default, this flag is set to Yes. This implies that by default, this test will report metrics for every domainname\username configured for this test. This way, administrators will be able to quickly determine which user logged in from which domain. If you want the TEST to report metrics for the username alone, then set this flag to No
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Availability:

Indicates whether the login was successful or not

Percent

A value of 100 % indicates that the login has succeeded. The value 0 is indicative of a failed login.

Authentication time:

Indicates the time it took to login

Secs

If this value is very high then it could be owing to a configuration issue (i.e the domain might not be configured properly) or a slow-down/unavailability of the primary domain server.

Configuring Multiple Users for the Citrix Authentication Test

Administrators of multi-domain environments might want to configure the Citrix Authentication test to emulate user logins from multiple domains; in this case, for every domain, a user-password pair might have to be configured. In some other cases, administrators might want the test to login as specific users from the same domain, to check how long each user login takes. Both these scenarios require the configuration of multiple domains and/or multiple user names and passwords. In order to enable users to specify these details with ease, eG Enterprise provides a special page; to access this page, click on the Click here hyperlink at the top of the parameters in the CitrixAuthentication test configuration page (see Figure 1).

Figure 1 : Configuring the Citrix Authentication Test

Upon clicking, Figure 2 will appear, using which the user details can be configured.

Figure 2 : The Citrix Authentication test user configuration page

To add a user specification, do the following:

  1. First, provide the name of the Domain from which logins are to be emulated (see Figure 2). If you are trying to login to a local host, then, specify none here.
  2. The eG agent must then be configured with the credentials of a user with interactive logon and logon locally privileges in the specified Domain or local host. Provide the user credentials in the User and Password text boxes in Figure 2, and confirm the password by retyping it in the Confirm Password text box.
  3. To add more users, click on the button in Figure 2. This will allow you to add one more user specification as depicted by Figure 3.

    Figure 3 : Adding another user

  4. Sometimes, you might want the CitrixAuthentication test to emulate logins from a single domain but as multiple users in that domain. For instance, you might want the test to login as user eglabuser and as user labadmin from the same egitlab domain. You can configure the eG agent with the credentials of both these users as shown by Figure 4.

    Figure 4 : Associating a single domain with different admin users

  5. To clear all the user specifications, simply click the Clear button in Figure 4.
  6. To remove the details of a particular user alone, just click the button corresponding to that user specification in Figure 4.
  7. To save the specification, just click on the Update button in Figure 4. This will lead you back to the test configuration page, where you will find the multiple domain names, user names, and passwords listed against the respective fields (see Figure 5).

    Figure 5 : The test configuration page displaying multiple domain names, user names, and passwords