Pre-requisites for Using the AWS AppStream Logon Simulator

Before attempting to use the simulator, make sure that the following pre-requisites are fulfilled:

Category Pre-requisites
Logon Simulator Agent / Simulation Endpoint

  • Client Emulation capability should be enabled on the eG license.

  • The logon simulator agent / external agent should be installed on a dedicated virtual machine or a physical server running Windows 2012/2016/2019/2022 or Windows 8/10/11 operating system.

  • The logon simulator agent / external agent should only run an English version of Windows operating system.

    Note:

    If Multilingual User Interface pack is applied on the Windows operating system, then, ensure that the English language is chosen as the System locale.

  • The logon simulator agent / external agent should not be used to monitor any other component in the target environment.

  • Microsoft .Net 4.5 (or above) should pre-exist on the system hosting the logon simulator agent/external agent.
  • The simulator requires a dedicated AWS AppStream user account with rights to launch applications/desktops.

  • The simulator also requires a user account with local administrator rights on the simulation endpoint - i.e., on the system hosting the logon simulator agent. This user should be logged in at all times for the simulator to run continuously.

    Note:

    • The logon simulation will not work if the session is closed.

    • The logon simulation will not work if the screen is locked on the logon simulation endpoint.

    • The logon simulator will not work if the screensaver appears on the logon simulation endpoint.
Environment
  • The simulator will only work with AWS AppStream Web Client.

  • If a firewall separates the simulation endpoint from the web interface, then make sure you configure the firewall to allow two- way communication between the endpoint and the web interface.
Browser

Chrome browser v122 (and above) should be available on the dedicated endpoint.

Note:

In some environments where browsers are automatically updated to their latest versions, incompatibility is cited between the browser version and the Chrome drivers. This may sometimes lead to the nonstart of simulation. Therefore, ensure that the Chrome drivers are also updated whenever the browser is updated to the latest version.

Chrome is capable of automatically applying updates and upgrading itself to higher versions. Sometimes, when Chrome auto-upgrades, some drivers that the eG Logon Simulator Agent uses may suddenly be rendered incompatible with Chrome. This can cause problems in simulation. To avoid this, eG AWS AppStream Logon Simulator, by default, prevents Chrome upgrades/updates (both automatic and manual) from being applied at the simulation endpoint.

However, whenever a new version of the eG agent with updated drivers is released, you will have to manually upgrade Chrome to ensure continued compatibility. In this case therefore, you will have to make sure that the simulation endpoint allows Chrome upgrades. To achieve this, before manually upgrading Chrome, follow the steps below:

  • Login to the eG agent host.
  • Open the Windows command prompt as Administrator.

  • Switch to the <EG_AGENT_INSTALL_DIR>\lib directory, and issue the following command:

    ChromeUpgradeHandler.exe enable

Note:

To ensure that all the pre-requisites of the AWS AppStream Logon Simulator is fulfilled, you can execute the LogonSimulatorChecks.exe which is available in the <eG_INSTALL_DIR>\lib folder. This executable should be executed by a user with administrator privileges from the command prompt of the target agent host. If any pre-requisite has not been fulfilled, failure will be highlighted in Red (as shown by Figure 1).

Figure 1 : Setup script where a pre-requisite has failed

Use the pointers provided in Figure 1, just below the failed pre-requisite, to know how to fulfill that requirement. Then, rerun the LogonSimulatorChecks.exe to make sure that all pre-requisites are fulfilled, and then proceed.

If all pre-requisites are fulfilled, then Figure 2 will appear.

Figure 2 : All pre-requisites are fulfilled

Caveats:

  • Amazon AppStream can be integrated with additional authentication mechanisms (single sign-on systems) such as OKTA. The AWS AppStream Logon Simulator is therefore capable of simulating the transactions when the Amazon AppStream is integrated with OKTA authentication mechanism.