Overview¶

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.

Remote Setup¶

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:
<SQUISHDIR>\etc\squishserverrc
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¶

Local¶

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.

Port of the Attachable AUT

Do NOT use the port 4322, because it is the standard port of the squish server.
Network sockets can only be used by one process at a time.
If the port was changed via the --port argument, the new selected port
should not be choosen for the startaut command or the attachable AUT.

Remote¶

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

\<SQUISHDIR\>\bin

For most cases, the most simple command works :

squishserver --verbose

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.

Remote¶

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.

Port of the Attachable AUT

Do NOT use the port 4322, because it is the standard port of the squish server.
Network sockets can only be used by one process at a time.
If the port was changed via the --port argument, the new selected port
should not be choosen for the startaut command or the attachable AUT.

After this is done you can start the server. For most cases, the most simple command works :

squishserver --verbose

Local¶

The squish runner must be started with the --host argument to tell it which machine the server, it should connect to, is running on.

remote