Skip to content

Install Squash TM License and Plugins

Install Squash TM Plugins

There are two ways to install plugins in Squash:

By using the plugin files embedded in Squash distribution

  1. Retrieve the plugin in the squash-tm/plugin-files folder;
  2. Move or copy the folder corresponding to the plugin to be installed to the following folder:
    • for Linux tarball: /opt/squash-tm/plugins;
    • for Windows: C:\<rep>\squash-tm\plugins;
  3. In Linux, give read permission to the Squash TM user for the .jar files;
  4. If it is a commercial plugin, make sure that the license file squash-tm.lic is in the folder license;
  5. Restart Squash TM for the plugins installation to be taken into account.

By downloading the plugins

  1. Download the plugin from the Downloads page;
  2. Extract the plugin;
  3. Select all the .jar files it contains and put them in the following folder:
    • for Linux tarball: /opt/squash-tm/plugins;
    • for Windows: C:\<rep>\squash-tm\plugins;
  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 or reporting plugins. 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 Data Center

Xsquash is an additional component available on the Atlassian Marketplace for 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.

This plugin requires at least Jira Data Center 8.4+.

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 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. Retrieve 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 retrieved:

    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.