Skip to content

Commit

Permalink
Update Docs/RunningOnRemoteMachine.md
Browse files Browse the repository at this point in the history
Added note around QRes

Co-authored-by: Canhua Li <[email protected]>
  • Loading branch information
smilinrobin and licanhua authored Jun 28, 2022
1 parent 819b741 commit 0a3a0f5
Showing 1 changed file with 1 addition and 0 deletions.
1 change: 1 addition & 0 deletions Docs/RunningOnRemoteMachine.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ Therefore we need to follow the below steps on the remote machine for the Window
- **5.3**. Setup Batch file to logout (without disconnecting) from the remote machine :
- *Name* : logout-rdp.bat
- *Contents*: `for /f "skip=1 tokens=3" %%s in ('query user %USERNAME%') do (%windir%\System32\tscon.exe %%s /dest:console C:\Install\QRes.exe /x 1920 /y 1080)`
- *Note*: Qres (http://qres.sourceforge.net/) is a remote vnc tool to change the resolution of the target machine to match the local machine
- *Note*: When using Remote Desktop to connect to a remote computer, closing Remote Desktop locks out the computer and displays the login screen. In the locked mode, the computer does not have GUI, so any currently running or scheduled GUI tests will fail.
To avoid problems with GUI tests, we use the tscon utility to disconnect from Remote Desktop. tscon returns the control to the original local session on the remote computer, bypassing the logon screen. All programs on the remote computer continue running normally, including GUI tests. Therefore logout-rdp.bat should be exclusively used to logout from the remote machine and the admin user should not logout/disconnect manually from the remote . Also, the resolution is passed as a parameter in the above batch file as 1920x1080
- **5.4** . Setup *Scheduled Tasks* on the target machine to kill Winappdriver (as per the BAT file in 5.1) and to start Winappdriver (as per the BAT file in 5.2) as the target programs. Ideally the Triggers should be *Daily* and *Startup* , so that the scripts running via the Test runner (Ex: JENKINS) , always have an instance of Winappdriver running on the server. These Scheduled Tasks should be setup to run with highest privileges on the machine (as Winappdriver requires to be run with Admin rights)
Expand Down

0 comments on commit 0a3a0f5

Please sign in to comment.