B - Install Squash-TA Toolbox version 1.9.0

 Note:

  • For older version of the toolbox please refer to this page.
  • In order to create and maintain your Squash-TA test cases, you need several tools. In order to simplify the installation process, we have bundled these tools into the Squash-TA Toolbox. The installation of the Squash-TA Toolbox is described below.
  • In order to execute your test cases, you need the Squash-TA test execution engine, which is NOT part of the toolbox. No need to install it though, it will be automatically downloaded and installed the first time you will try to run a Squash-TA test (the Squash-TA test execution engine is integrated as a maven plugin, as we will see later on).

Prerequisite : Before starting the installation of the toolbox version 1.9.0 or later you must install a JDK between 1.7 and 1.8, both 32 and 64 bits version are compatibles. See here to download it from Oracle site.

First of all, download the toolbox installer 'squash-ta-tools-bundle-X-X-X-RELEASE-installer.exe.jar' X-X-X beeing version 1.9.0 or later, documentation for older toolbox version can be found here : Install Squash-TA Toolbox (Versions before 1.9.0-RELEASE).
  • Launch the installer by double-clicking on it.

  • On the first wizard page, click on 'Suivant' (Next).

  • At this step, you may see all the licenses of the different components of the Squash TA Toolbox. Click on 'Suivant' (Next).


  • The next step lets you check the list of installed components. You may reuse some compatible components already installed on your workstation but for now let's assume that you will be getting all tools from the toolbox, and leave all boxes checked. Click on 'Suivant' (Next).

  • At this step (Path to the JDK) you need to specify the path to you installed JDK, as mentionned in the prerequisite, the version must be compatible with the toolbox, i.e. between 1.7 and 1.8. You can directly type the path in the input field, or click on 'Parcourir' (Browse) and browse to your chosen location through a file explorer (you may create your installation folder from there if needed). After choosing the location, click on 'Suivant' (Next).


  • If the chosen path is not correct, path to a JRE or JDK 1.6 for example, you will have this error message (The chosen directory does not contain the required product).

  • The next step, lets you choose your toolbox installing location. You can directly type the path in the input field, or click on 'Parcourir' (Browse) and browse to your chosen location through a file explorer (you may create your installation folder from there if needed). After choosing the location, click on 'Suivant' (Next).



  • If the target folder already exists (even if you've just created it), you will get the left confirmation alertbox above. Click on 'Oui' (Yes) to confirm the location. If you typed a non existing location, the alert dialog will look as shown on the right. In this case you may click on 'OK' to confirm.

  • Next step allows you to pick a location to create your new eclipse worspace for Squash-TA projects. It is not mandotory to specify a path. As for the installing location, you may type the path directly or browse through a file explorator : 'Parcourir...' (Browse) button. If the location you typed does not exist, it will be automatically created. After choosing your location, click on 'Suivant' (Next).

  • During this step, installation files are copied to the installing location. When it's done, click on 'Suivant' (Next).

  • Here, you can choose the shortcuts that you want to create, and for which users. To install the tools for yourself only, check 'utilisateur courant' (current user) on the right radio group. Click on 'Suivant' (Next) to go to the last step.

  • Click on 'Terminer' (Finish).  but beware there is still two things left to do to get a fully configured toolbox. Now that your Eclipse Mars is installed in the toolbox directory you have to launch it and import preference files.

  • Step 1, importing Eclipse general preferences :

    • While Eclipse is running Click on File -> Import.

    • Choose General -> Preferences.
    • Click Browse and select the file : {TOOLBOX_PATH}/eclipse-java-mars-win32/config/ta_user_profile.epf.

    • Leave the "Import all" box checked and Click "Finish".
  • Step 2, import Eclipse launch configurations :
    • While Eclipse is running Click on File -> Import.

    • Choose Run/Debug -> "Launch Configurations".

    • Click Browse and select the folder : {TOOLBOX_PATH}/eclipse-java-mars-win32/config
    • Check the "config" box.
    • Click Finish. 
  • The toolbox is now fully operational.

Done! You have just installed your Squash-TA test automation environment.

If you want to know how to create your first project, click on this link : Set up a Squash-TA project'