Configuration of HrznLogonSimTest
This test emulates a user logging into a VMware Horizon farm and launching an application/desktop. In the process, the test reports the total duration of the simulation, time taken for the login to be authenticated, the time taken for application/desktop ennumeration, duration of application/desktop launch, and log out duration.
The default parameters associated with this test are:
The TEST PERIOD list box helps the user to decide how often this test needs to be executed.
- If multiple applications/desktops are configured for launching against PUBLISHED RESOURCES: In this case, the test will repeat the entire sequence of steps for every configured application/desktop - i.e., after an application is launched, the test will logoff and then log in again to attempt the launch of the next application. This can increase the duration of the simulation.
- If the value of the Launch Timeout and/or the LOGOFF DELAY parameters of the test is significantly increased: If this is done, then the simulator will wait that much longer for the application launch or logoff to happen, thereby increasing simulation duration.
Note:
Some parameter changes can sometimes impact the simulation duration. Most often, this can happen in the following situations:
Sometimes, these changes can cause the simulation to take more time than the configured Test Period.
If this happens, the test will fail after logging an error to that effect in the <EG_AGENT_INSTALL_DIR>\agent\error_log file. To avoid this, it would be good practice to relook at the TEST PERIOD configuration every time one of the parameters mentioned above is modified, and increase it if required.
Specify the the host name of the server for which the test is to be configured in the HOST text box.
Specify the port used by the VMware Horizon Connection Server in the PORT text box.
Specify the URL for connecting to the Access Point (VMware Unified Access Gateway) / VMware Horizon Connection Server in the SITE URL text box. You can provide an HTTP or an HTTPS URL here.
To configure the published resources that are to be monitored, click the
button against the PUBLISHED RESOURCES field. The CONFIGURATION OF PUBLISHED RESOURCES pop up window will then appear. Configure the following this pop up window:In the Published Resources text box, specify a comma-separated list of published resources to be launched. The resource can be an application / desktop. When providing application/desktop names, make sure you provide the same name using which the applications/desktops are displayed in the Access Point or VMware Horizon Connection Server web console. Also, make sure that the User you specify is authorized to launch all the applications/desktops configured in the comma-separated list of Published resources.
Typically, any application/desktop that is launched opens in a separate window. Sometimes, a different name may be displayed for the launched application/desktop in that window's title bar. If there is a mismatch between the resource name in the Access Point or the VMware Horizon Connection Server console and the resource name in the launched window title, then the simulator may wrongly report a successful launch as a failure. To avoid this, in such circumstances, your Published resources specification should be of the following format: <Application / Desktop Name as seen in the Access Point / VMware Horizon Connection Server console>:<Application/Desktop Name as displayed in the Window title>. For example, your specification can be: winword-Documn:winword.exe,excel-Dev:excel.exe
Note:
- The resources can be specified either in lower case or upper case or a combination of both.
- The display name of the resources should not contain the following special characters:`*+=#.|;\"\'<>\/[]{}()?
Then, using the Domain, User, Password, and Confirm Password parameters, configure the credentials of the user who is authorized to launch the configured resources.
Two-factor authentication (2FA), often referred to as two-step verification, is a security process in which the user provides two authentication factors to verify they are who they say they are. If VMware Horizon Connection Server is enabled with two-factor authentication, then to authenticate the specified User login, the VMware Horizon Connection Server will require an additional layer of security other than the Password you have provided. This can be any piece of information that only the User knows or has immediately in hand - such as a verification code that the VMware Horizon Connection Server provides. This is why, if the VMware Horizon Connection Server is enabled with twofactor authentication, you will have to set the Is 2FA enabled? flag to Yes, and then specify the verification code in the text box that appears alongside. On the other hand, if the server is not enabled with two-factor authentication, set this flag to No.
Some high-security VMware Horizon environments may have been configured to display a ‘disclaimer’, whenever a user attempts to login to a server/desktop in the environment. Such disclaimers typically include statements that delimit the scope of access, uphold confidentiality or protect copyright laws, and mitigate the risk of virus infections or data losses that may be caused by unauthorized access. If such a disclaimer is enabled for your environment, then set the Is disclaimer enabled flag to Yes. In this case, the simulator will accept the disclaimer and proceed with the simulation. If no such disclaimer has been configured for your environment, set this flag to No.
If you do not want to configure any more resources for launching, then click the Update button to save the changes. To add another resource for launching, click the Add More button. This will add an empty record in the CONFIGURATION OF PUBLISHED RESOURCES pop up window. Here, specify the names of more Published resources, and then use the Domain, User, Password, and Confirm Password parameters to provide the credentials of a user who is authorized to launch those resources.
- At any given point in time, you can exclude/delete a resource from the simulation by clicking the encircled - button corresponding to that resource.
The simulator needs to run in the account of a user who has local administrator rights on the simulation end point - i.e., the system on which the external agent and the VMware Horizon Connection Server have been installed. Specify the name of this user in the CONSOLE USERNAME text box. This user should also be logged in at all times for the simulator to run continuously.
By default, the LAUNCH TIMEOUT parameter is set to 90 seconds. This implies that the simulator will wait for a maximum of 90 seconds (by default) for an application/desktop to launch. If the application/desktop does not launch even after the 90 seconds have elapsed, then the simulation will be automatically terminated, and the simulator will mark that application/desktop launch as &Lsquo;failed’. Accordingly, the Application launch availability measure for that published resource (i.e., application/desktop) will report the value 0, and no launch duration will be reported for the same.
In some environments, one/more published applications may take a little longer to launch than the rest. In such environments, you can instruct the simulator to wait longer for launching each of the configured published resources, by increasing the launch timeout. The high time out setting for resource launch ensures that the simulator captures and reports only genuine launch failures, and does not treat a launch delay as a failure.
By default, the LOGON DELAY parameter is set to 30 seconds. This implies that the simulator will wait for a maximum of 30 seconds (by default) during each resource launch, for the logon to actually occur. If the logon does not happen even after the lapse of 5 seconds, then the simulation will be automatically terminated, and the simulator will mark the logon attempt as ‘failed’. A logon duration will hence not be computed or reported in this case.
By default, the LOGOFF DELAY parameter is set to 30 seconds. This implies that the simulator will wait for a maximum of 30 seconds (by default) after each resource launch, for the logoff to occur. If the logoff does not happen even after 30 seconds have elapsed, then the simulation will be automatically terminated, and the simulator will mark the logoff attempt as ‘failed’. A logoff duration will hence not be computed or reported in this case.
In some environments, even during normal operation, logoff may take longer. In such environments, you can instruct the simulator to wait longer for the logoff to occur, by increasing the web logoff delay. The high time out setting for logoff ensures that the simulator waits for the log off to complete and captures and reports the accurate logoff duration.
The DD FREQUENCY refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD FREQUENCY.
To make diagnosis more efficient and accurate, the eG Enterprise suite embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the DETAILED DIAGNOSIS capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.
The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:
The eG manager license should allow the detailed diagnosis capability
Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.
Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.
When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.