diff --git a/docs/knowledge-base/scheduling-kb/virtual-machine-ui-tests-fail-without-active-session.md b/docs/knowledge-base/scheduling-kb/virtual-machine-ui-tests-fail-without-active-session.md new file mode 100644 index 00000000..e832efcf --- /dev/null +++ b/docs/knowledge-base/scheduling-kb/virtual-machine-ui-tests-fail-without-active-session.md @@ -0,0 +1,33 @@ +--- +title: UI Testing on Virtual Machines Fails Without Active User Session +description: Resolving issues with Telerik Test Studio UI testing in virtual machines when no active user session exists. +type: troubleshooting +page_title: Virtual Machine UI Tests Fail Without Active Session in Telerik Test Studio +meta_title: Virtual Machine UI Tests Fail Without Active Session in Telerik Test Studio +slug: virtual-machine-ui-tests-fail-without-active-session +tags: telerik test studio, ui testing, virtual machine, vgpu, session monitor +res_type: kb +ticketid: 1698547 +--- + + +## Description +I run UI test scripts in a virtual machine using vGPU with Telerik Test Studio. These scripts are triggered by a pipeline, and no user interacts with the virtual machine during execution. However, the tests fail to detect or interact with elements like login fields, despite the application launching successfully. When I establish an RDP connection to the virtual machine, the tests execute correctly. + +## Cause +UI functional testing requires an active user session to interact with UI elements effectively. When the virtual machine lacks an active session, the tests fail to interact with the application as expected. Establishing an RDP session temporarily resolves the issue because it restores the active console session. + +## Solution +To ensure UI test execution without requiring a continuous RDP session, use the Test Studio Session Monitor application. This tool maintains an active user session by reconnecting the console session after the RDP connection closes. + +### Steps: +1. Ensure the Test Studio Session Monitor is installed and enabled on the virtual machine. +2. Leave the Session Monitor application running on the virtual machine. +3. Disconnect the RDP session safely, knowing that the console session will be restored by the Session Monitor. +4. Trigger the test scripts from the pipeline. The tests should execute successfully as the active session is maintained. + +If the Session Monitor has been enabled but the issue persists, consider alternative remote desktop software that ensures the virtual machine maintains an active session during pipeline-triggered executions. + +## See Also +- [User Session Configuration for Execution Server](https://docs.telerik.com/teststudio/automated-tests/scheduling/multiple-machines-scheduling-setup/create-execution-server#user-session-configuration) +- [Test Studio Execution Servers Overview](https://docs.telerik.com/teststudio/automated-tests/scheduling/multiple-machines-scheduling-setup)