Skip to content

Install Squash TM License and Plugins

Install Squash TM Plugins

To install plugins in Squash TM, you must follow this procedure for every OS:

  1. Download the plugin from the site https://www.squashtest.com or from the links provided to you by the Squash Support Team
  2. Extract the plugin
  3. Select all the .jar files it contains and put them in the following folder:
    • /opt/squash-tm/plugins : for Linux tarball
    • C:\\squash-tm\plugins : for Windows
  4. In Linux, give read permission to the Squash TM user for the .jar files
  5. If it is a commercial plugin, make sure that the license file 'squash-tm.lic' is in the folder 'license'
  6. Restart Squash TM for the plugins installation to be taken into account

Info

Plugins can also be put in subfolders of the 'plugins' folder

Info

The list of installed plugins can be directly viewed in Squash TM by a functional administrator in the system information.

Once installed, some plugins can operate right away, such as API, reporting plugins, or the Actions Library plugin. Other plugins need to be configured in the server or in Squash TM administration workspace.

Learn More

To learn more about configuring plugins in the server, please read Configuring plugins. For other configurations, please read the Administrator Guide.

Install the Commercial License

The use of Squash TM commercial plugins is determined by the presence of a license file: squash-tm.lic. This file is mandatory to start Squash TM with commercial plugins.

This file is given to the client by the Squash Support Team following the formalization of a new license or a renewal.

The license file is unique to each client. It contains the following information: - expiration date - number of users - list of the authorized commercial plugins according to the license(s) you have

You can use this license file for production instances as well as preproduction instances.

To install the license file in Squash TM:

  1. In Squash TM's "plugins" directory, create a subdirectory entitled 'license'
  2. Put the file 'squash-tm.lic' given to you by the Squash Support Team in that subdirectory
  3. Restart Squash TM

The license file controls the number of active users in Squash TM. When the maximum number of users is exceeded, a message appears to alert the administrators. If this number is exceeded by more than 20%, the creation of new users is blocked.

Two months before the license's expiration date, a message alerts the administrators. Beyond this date, the message will alert all the users. If the license is still not renewed two months after the expiration date, Squash TM shuts off. You will then have to uninstall the commercial plugins to be able to restart Squash TM.

Install Xsquash for Jira Server

Xsquash is an additional component available on the Atlassian Marketplace for Jira Server and Jira Data Center that reinforces the integration between Squash TM and Jira. It displays Squash TM test cases and executions directly in Jira issues that were synced in Squash TM via Xsquash4Jira.

Info

The data is displayed in Jira via Squash TM's REST API. This plugin does not write in the Jira database.

To install this plugin, you must have at least these prerequisites:

  • Jira Server or Data Center 8+
  • Squash TM version 1.19.0+
  • Squash REST API 1.1.0+
  • Xsquash4Jira 1.2.0+: Xsquash4Jira plugin must be installed in Squash TM and be set up for at least one project

Learn more

For more information on how to configure the Xsquash4Jira plugin, please visit this page Configure Xsquash4Jira in Squash TM

To install the Xsquash plugin on Jira Server or Jira Data Center, please follow these steps:

  1. Log into Jira as an administrator
  2. Go to "Jira Administration" and click on "Manage Apps". The Atlassian Marketplace for Jira appears
  3. Search for Xsquash in the Marketplace. The search results include the app versions that are compatible with Jira
  4. Click on [Install] to download and install the app
  5. Click on Close in the dialog window

Xsquash must be configured for it to work.

Learn more

For more information on how to configure the Xsquash plugin, please visit this page Configure Xsquash in Jira

Install the Xsquash Cloud app in Jira Cloud

Xsquash Cloud is an app hosted on an internal server of the company Henix. It reinforces the integration between Squash TM and Jira Cloud. It displays Squash TM test cases and executions directly in Jira issues that were synced in Squash TM via Xsquash4Jira.

This app is only available if you have a commercial license.

Info

The data is displayed in Jira via Squash TM's REST API. This app does not write in Jira Cloud's database.

To install this plugin, you must have at least these prerequisites:

  • Jira Cloud
  • Squash TM version 1.19.0+
  • Squash REST API 1.1.0+
  • Xsquash4Jira 1.2.0+: The Xsquash4Jira plugin must be installed in Squash TM and be set up for at least one project.

Learn more

For more information on how to configure the Xsquash4Jira plugin, please visit this page Configure Xsquash4Jira in Squash TM

There are two ways of installing the Xsquash Cloud app in Jira Cloud:

Install Xsquash Cloud manually

To install Xsquash Cloud manually, please follow these steps:

  1. Log into Jira Cloud as an administrator
  2. Click on Settings. Choose 'Apps' then the option 'Manage apps'
  3. Click on 'Settings'. The 'Settings' window opens

    Settings

  4. Check the option 'Enable development mode' then click on [Apply]

  5. On the "Manage apps" page, click on 'Upload app'. The 'Upload app' window opens
  6. Enter the URL given to you by the Squash Support Team then click on [Upload]

    Upload app

  7. Xsquash Cloud appears in the list of installed apps.

    Application installed

Install Xsquash Cloud via the API

Before installing the Xsquash Cloud app in Jira Cloud via the API, you must have an administrator account with an API token.

To generate an API token, please follow these steps:

  1. Login with your administrator account. In "Your profile and settings", click on "Settings"
  2. Click on "Manage your account"
  3. Click on "Security"
  4. In the 'API Token' part, click on "Create and manage API tokens"
  5. Click on "Create an API token"
  6. Enter a description and click on "Create"
  7. Copy the token

Here are the steps to follow to install the Xsquash Cloud app via the API:

  1. Make a GET request in BASIC AUTH to the following URL:

    https://Jira-URL.atlassian.net/rest/plugins/1.0/?os_authType=basic
    

    with the following info in the header:

    Accept: application/vnd.atl.plugins.installed+json
    

    To authenticate yourself, use the administrator's username and their API token

  2. Recover the header "upm token" value in the answer

  3. Make a POST request in BASIC AUTH to the following URL by replacing 'Upm-Token' by the value of the header "upm-token" you just recovered:

    https://Jira-URL.atlassian.net/rest/plugins/1.0/?token=Upm-Token
    

    with the following information in the header:

    Content-type: application/vnd.atl.plugins.uri+json
    Accept: application/json
    

    and in the body the following command with the URL provided to you by the Squash Support Team:

    {
    "pluginUri": "https://Url-Xsquash-Cloud.com/atlassian-connect.json",
    "pluginName": "Xsquash Cloud"
    }
    

    To authenticate yourself, use the administrator's username and their API token

  4. Xsquash Cloud then appears in the list of installed apps in Jira Cloud administration.

You must then configure the app in order to use it.

Learn more

For more information on how to configure the Xsquash Cloud app, please visit the page Configure Xsquash Cloud in Jira Cloud.