Single System connection
A Single System connection allows you to connect, control, and test on the same Windows machine where the test is running. Performing single system model testing allows you to eliminate the step of setting up a separate machine as a System Under Test (SUT).
The Single System connection type is only supported on Windows and requires the 64 bit Eggplant Gateway build.
Windows Platforms Compatible with Single System Testing
| 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 your 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
Eggplant Gateway will now log in to the remote desktop server, 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
Eggplant Gateway will now log in to your remote desktop server, establish a connection, and start a VNC server at port 5900.
2.You will need to manually add your device to the connection list in Eggplant Functional.
Known issues:
- Upon connecting for the first time, a black screen might display. Re-connecting again will resolve this issue.
- Google Chrome will not able to launch simultaneously from both the parent machine and SUT, because Windows has restricted the launch of Chrome using the same profile between the parent session and child SUT. To resolve this, create a new profile, and launch it from the SUT.