Single System connection
A Single System connection allows to connect, control and test on the same Windows machine from where the test is running. Performing single system model testing, allowing user to eliminate the step of setting up another machine as SUT.
The Single System is only supported on Windows and requires the 64 bit Eggplant Gateway build.
Windows Platform that tested with Single System
| Operating System | RAM | System type | Processor |
|---|---|---|---|
| Windows Server 2019 | 16GB or more | 64 bit operating system | 2.30 GHz |
| Windows 10 Enterprise 22H2 | 16GB or more | 64 bit operating system | 2.40 GHz |
| Windows 11 Enterprise 23H2 | 16GB or more | 64 bit operating system | Intel Ultra 7 165H 1.40 GHz |
| Windows 11 Enterprise 24H2 | 16GB or more | 64 bit operating system | 2.10 GHz |
Setup Eggplant Gateway for Single System environment
To set up Eggplant Gateway for a Single System connection, run the following command in Administrator mode:
./epgw setup single-system
Creating a connection
To create an Eggplant Gateway for Single System connection, run the following command:
./epgw add single-system \
--name <The connection name> \
--username <The parent machine username> \
--password <The parent machine password> \
--resolution <The remote server screen resolution>\
--domain <the remote server domain> (OPTIONAL)
| Key | Description |
|---|---|
| name | The name of the connection you want to create. You can freely choose this name. |
| username | The username of the parent machine login user. |
| password | The password of parent machine login user. |
| resolution | The resolution of at which to initialize the remote desktop. |
| domain | The remote server domain. (OPTIONAL) |
For example, to create a connection which will launch remote desktop session from the parent machine:
./epgw add single-system --name test_single_system --username "RdpUser" --password "RdpUser123" --resolution "1600x900"
Connecting to Eggplant Functional
Follow these steps to log in to SUT and establish a connection to Eggplant Functional:
- Start Eggplant Functional
- Run
epgw connect <name>, where name is the name of your Gateway connection. For example,epgw connect test_single_system
The Eggplant Gateway will now log in to your the server remote desktop, establish a connection and connect to Eggplant Functional.
Setting up a VNC server for your remote desktop connection
Alternatively, you can set up a VNC server for your remote desktop connection. To do so:
- Run
epgw vnc <name>, where name is the name of your Gateway connection. For example,epgw vnc test_single_system
The Eggplant Gateway will now log in to your remote desktop server, establish a connection and start a VNC server at port 5900.
You'll need to manually add your device to the connection list in Eggplant Functional.
Known issues:
- Upon first time connection, there might be showing black screen. Re-connect again will resolve the screen display issue.
- Google chrome will not able to launch simultaneously from parent machine and SUT. Windows restricted the launch of chrome using same profile between parent session and child SUT. To overcome it, create a new profile, and launch it from child SUT.