Suppose you want to do Remote Testing on a different machine, but you don’t want Squish to end your AUT process after the test case has been executed. Then you will need an attachable Aut.
First you must do a little bit of Setup on the Remote Side, after the Installation of the Squish package. For this you edit the following file:
This file controls which IP addresses are allowed to contact the server. If the IP your local machine is not in there, the connection will be refused.
From within the IDE¶
First you establish the remote connection to the squish server already running on the other machine.
This is done by going to
Edit > Preferences > Squish > Remote Testing
and unchecking the Checkbox there. After that you input the IP4 address of the machine where your remote squish server is running and the port if needed.
Once you are done with this, you must configure the attachable AUT in
Edit > Server Settings > Manage Auts > Attachable Auts
The name is just an identifier and should not be a path or anything more complex.
On the remote Side, you must start the Application through the start*aut.exe tool, which you can find in <SQUISHDIR>\bin.
The correct command for this looks in most cases something like this:
<startaut_name> --port=5555 \<PATH_TO_APPLICATION_BINARY\>
After that you can start the server from
For most cases, the most simple command works :
If you need more information on the squish server you find that in the documentation : Squish Server
From the shell¶
If you are launching the tests from the shell in batch mode, you need to do some things differently, because you are not using the IDE.
On the remote Side, you must register the attachable AUT yourself before starting the server. This can be done through the follwing command:
squishserver --config addAttachableAUT \<Identifier\> [host:]port
The host argument is optional and if it is not entered, the attachableAUT will be registered for localhost.
After this is done you can start the server. For most cases, the most simple command works :
The squish runner must be started with the --host argument to tell it which machine the server, it should connect to, is running on.