How to setup a Jenkins Agent to run Squish tests

Last edited on

The following steps describe how to setup a Jenkins agent to run a Squish test with the Squish plugin:

StepDescriptionExample
1First of all Squish needs to be installed on the node machine as described at How to Install Squish.Squish installed at C:\Squish
2Setup a node inside Jenkins at Manage Jenkins | Manage Nodes | New Node. For Windows nodes please make sure to not start the agent as Windows Service at Launch method. Windows Services are intended to run command line applications but not to run applications which consist of a GUI. Starting the Jenkins agent as JNLP via Launch agent via Java Web Start works fine.Node name is windows_qt47
3Read the article Automation on Windows without a screen to make sure you don’t run into the pitfalls listed there.
4To learn how to configure where the plugin can find a Squish installation please get familiar with Different ways of setting Squish installation path article
5Finally configure your job to use the above agent

If Host is not configured in the Squish build step the squishrunner as well as the squishserver will be executed on the Jenkins agent. The test suite configured inside the Test Suite option of the Squish build step refers to the Jenkins agent file system not to the Jenkins master node file system.

The Squish Jenkins Plugin supports using the Jenkins environment variables listed at Jenkins Set Environment Variables. A common approach is to checkout the test suite from a version control system into the job’s workspace directory and to use the WORKSPACE Jenkins environment variable e.g. ${WORKSPACE}/suite_book.