Aller au contenu

Installer les plugins et la licence SquashTM

Installation des plugins SquashTM

Il y a deux manières d'installer des plugins sur SquashTM :

En utilisant les fichiers des plugins embarqués dans la distribution de SquashTM

  1. Récupérer le plugin dans le dossier squash-tm/plugin-files ;
  2. Déplacer ou copier le dossier correspondant au plugin à installer dans le dossier suivant :
    • /opt/squash-tm/plugins : pour un tarball ;
    • C:\<rep>\squash-tm\plugins : pour Windows ;
  3. Sous Linux, attribuer les droits de lecture à l'utilisateur squash-tm sur les .jar ;
  4. S'il s'agit d'un plugin commercial, s'assurer que le fichier de licence squash-tm.lic est bien présent dans le dossier license ;
  5. Redémarrer SquashTM pour que l'installation des plugins soit prise en compte.

En téléchargeant les plugins

  1. Télécharger le plugin depuis la page Téléchargements ;
  2. Décompresser le plugin ;
  3. Récupérer la totalité des fichiers .jar qu'il contient et les déposer dans le dossier suivant :
    • /opt/squash-tm/plugins : pour un tarball ;
    • C:\<rep>\squash-tm\plugins : pour Windows ;
  4. Sous Linux, attribuer les droits de lecture à l'utilisateur squash-tm sur les .jar ;
  5. S'il s'agit d'un plugin commercial, s'assurer que le fichier de licence squash-tm.lic est bien présent dans le dossier license ;
  6. Redémarrer SquashTM pour que l'installation des plugins soit prise en compte.

Info

Les plugins peuvent également être installés dans des sous-répertoires du répertoire plugins.

Info

La liste des plugins installés peut être consultée directement dans SquashTM par un administrateur fonctionnel dans les informations système.

Une fois installés, certains plugins sont directement opérationnels, c'est le cas pour les plugins d'API ou de reporting. D'autres nécessitent par contre une configuration au niveau serveur ou au niveau de l'administration.

En savoir plus

Pour en savoir plus sur la configuration des plugins au niveau serveur, consulter la page Configurer les plugins. Pour les autres configurations, consulter le Guide Administrateur pour plus d'informations.

Installation de la licence commerciale

L'utilisation des plugins commerciaux de SquashTM est conditionnée par la présence d'un fichier de licence : squash-tm.lic. Ce fichier est nécessaire pour démarrer SquashTM avec les plugins commerciaux.
Il est fourni au client par le Support SquashTM suite à la contractualisation d'une nouvelle licence ou d'un renouvellement.

Le fichier de licence est unique pour chaque client. Il comporte les informations suivantes :

  • une date de fin de validité ;
  • un nombre d'utilisateurs ;
  • la liste des plugins commerciaux autorisés en fonction de la licence ou de la combinaison de licences contractées.

Ce fichier de licence peut être utilisé par le client aussi bien pour ses instances de production que pour ses instances de préproduction.

Pour installer le fichier sur SquashTM, voici les actions à réaliser : 

  1. Dans le répertoire plugins de SquashTM, créer un sous-répertoire intitulé license. Attention, le répertoire s'écrit license, avec un S ;
  2. Déposer le fichier squash-tm.lic communiqué par l'Équipe Support SquashTM ;
  3. Puis redémarrer SquashTM.

Le fichier de licence contrôle le nombre d'utilisateurs actifs sur SquashTM. Un message s'affiche pour alerter les administrateurs lorsque le nombre maximum d'utilisateurs est dépassé. Si ce nombre est dépassé de plus de 20%, la création de nouveaux utilisateurs est bloquée.

Deux mois avant la date de fin de validité de la licence, un message alerte les administrateurs. Passé cette date, un message indique à l'ensemble des utilisateurs que la licence est expirée. Si la licence n'est pas renouvelée deux mois après la date de fin, SquashTM s'éteint. Il faut alors retirer les plugins commerciaux pour pouvoir redémarrer l'application.

Installation du Xsquash pour Jira Data Center

Xsquash est un composant additionnel disponible sur l'Atlassian Marketplace pour Jira Data Center qui renforce l'intégration entre SquashTM et Jira. Il affiche les données des cas de test et des exécutions SquashTM directement dans les tickets Jira qui ont été synchronisés dans SquashTM via Xsquash4Jira.

Info

Les données sont affichées dans Jira via l'API REST de SquashTM, ce plugin n'écrit pas dans la base de données de Jira.

Ce plugin requiert à minima Jira Data Center 8.4+.

En savoir plus

Pour plus d'informations sur la configuration du plugin Xsquash4Jira, se référer à la page dédiée Configurer Xsquash4Jira dans SquashTM

Pour installer le plugin Xsquash sur Jira Data Center, voici la procédure à suivre :

  1. Se connecter à l'instance Jira en tant qu'administrateur ;
  2. Aller sur l'Administration Jira et cliquer sur [Gérer les Apps]. L'Atlassian Marketplace pour Jira s'affiche ;
  3. Rechercher Xsquash sur la Marketplace. Les résultats de recherche incluent les versions de l'application compatibles avec l'instance Jira ;
  4. Cliquer sur [Installer] pour télécharger et installer l'application ;
  5. Cliquer sur [Fermer] dans la fenêtre de dialogue.

Le plugin Xsquash nécessite une configuration pour être opérationnel.

En savoir plus

Pour plus d'informations sur la configuration du plugin Xsquash, se référer à la page dédiée Configurer Xsquash dans Jira

Installation de l'application Xsquash Cloud sur Jira Cloud

Xsquash Cloud est une application hébergée sur un serveur interne à l'entreprise Henix qui renforce l'intégration entre SquashTM et Jira Cloud. Il affiche les données des cas de test et des exécutions SquashTM directement dans les tickets Jira qui ont été synchronisés dans SquashTM via Xsquash4Jira.

Attention

  • Xsquash Cloud n'est disponible que pour les clients disposant d'une licence SquashTM Premium ou Ultimate.
  • SquashTM et Xsquash Cloud doivent être dans des versions compatibles, il est donc nécessaire de contacter l'Équipe Support SquashTM pour demander une mise à jour de Xsquash Cloud lorsque SquashTM a été monté de version.

Info

Les données sont affichées dans Jira via l'API REST de SquashTM, cette application n'écrit pas dans la base de données de Jira Cloud.

En savoir plus

Pour plus d'informations sur la configuration du plugin Xsquash4Jira, se référer à la page dédiée Configurer Xsquash4Jira dans SquashTM.

Il existe deux façons d'installer l'application Xsquash Cloud sur Jira Cloud :

Installer manuellement Xsquash Cloud

Pour installer manuellement Xsquash Cloud, voici la procédure à suivre :

  1. Se connecter à l'instance Jira Cloud en tant qu'administrateur ;
  2. Cliquer sur le bouton [Paramètres] et choisir [Apps Marketplace] ;
  3. Depuis le menu Gérer les apps, cliquer sur [Accéder à cette page] ;
  4. Depuis le menu Apps connectées, cliquer sur [Paramètres] ;
  5. Vérifier que le Mode développeur est bien sur Activé, sinon activer le ;
  6. Sur la page Apps installées, cliquer sur [Installer une app privée] pour ouvrir la fenêtre Installer une app privée ;
  7. Dans le champ Choisissez un produit sur lequel installer cette app, sélectionner Jira ;

  8. Dans le champ URL du descripteur de l'app, renseigner l'URL qui aura été fournie par l'Équipe Support SquashTM puis cliquer le bouton [Installer l'app] ;

    Installer Xsquash Cloud

  9. L'application Xsquash Cloud apparaît ensuite dans la liste des applications installées.

    Application installée

Installer Xsquash Cloud via l'API

Avant d'installer l'application Xsquash Cloud dans Jira Cloud par API, il faut au préalable un compte administrateur disposant d'un jeton d'API.

Pour générer un jeton d'API, il faut suivre la procédure suivante :

  1. Être connecté avec le compte administrateur puis dans Votre profil et vos paramètres, cliquer sur [Profil] ;
  2. Cliquer sur [Gérer votre compte] ;
  3. Cliquer sur [Sécurité] ;
  4. Dans la section Jeton d'API, cliquer sur [Créer et gérer des jetons d'API] ;
  5. Cliquer sur [Créer un jeton d'API] puis saisir un libellé ;
  6. Saisir un libellé puis cliquer sur [Créer] ;
  7. Copier le jeton.

Voici la procédure à suivre pour l'installation de l'application Xsquash Cloud via l'API :

  1. Faire une requête GET en BASIC AUTH à l'URL suivante :

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

    avec dans le header, l'information suivante : 

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

    Pour l'authentification, utiliser le Username de l'administrateur et son jeton d'API ;

  2. Récupérer la valeur du header upm-token dans la réponse ;

  3. Faire une requête POST en BASIC AUTH à l'URL suivante en remplaçant Upm-Token par la valeur du header upm-token récupérée précédemment :

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

    avec dans le header, l'information suivante : 

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

    et dans le body la commande suivante avec l'URL qui vous aura été fournie par l'Équipe Support SquashTM :

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

    et pour l'authentification, utiliser le Username de l'administrateur et son jeton d'API ;

  4. L'application Xsquash Cloud apparaît ensuite dans liste des applications installées au niveau de l'administration Jira Cloud.

Il faut ensuite configurer l'application pour pouvoir l'utiliser.

En savoir plus

Pour plus d'informations sur la configuration de l'application Xsquash Cloud, se référer à la page dédiée Configurer Xsquash Cloud sur Jira Cloud.