Aller au contenu

Installation de l'applicatif

L'application Squash TM est livrée sous différents packages :

  • un installeur Windows qui permet une installation rapide à des fins de démonstration ;
  • un package universel compatible Windows, Linux (.zip ou .tar.gz) ;
  • une image Docker.

Attention

Les prérequis indiqués sur la page Configuration minimale et prérequis doivent être respectés.

Installation avec Linux

Installation avec le tarball Linux

Pour installer Squash TM avec le tarball Linux :

  1. Décompresser l’archive .tar.gz de Squash TM dans /opt

    tar -zxvf archivexsquashtm.tar.gz
    

  2. Créer un utilisateur et un groupe dédié à Squash TM

    adduser --system --group --home /opt/squash-tm squash-tm
    

  3. Définir squash-tm propriétaire de son dossier et ses fichiers

    chown -R squash-tm:squash-tm /opt/squash-tm
    

  4. Peupler la base de données grâce aux scripts présents dans /opt/squash-tm/database-scripts.

    S'il s'agit d'une première installation passer le script <database\>-full-install-version-7.X.X.RELEASE.sql correspondant au SGBD portant le numéro de version de Squash TM.
    S'il s'agit d'une montée de version, passer les scripts d'upgrade <database\>-upgrade-to-X.X.X.sql correspondants au SGBD dans l'ordre des versions jusqu'à atteindre la version cible.

  5. Rendre startup.sh exécutable

    chmod +x /opt/squash-tm/bin/startup.sh
    

  6. Renseigner dans le fichier bin/startup.sh les informations de connexion à la base de données :

    DB_URL="jdbc:mariadb://localhost:3306/squashtm" ou "jdbc:postgresql://localhost:5432/squashtm"
    DB_TYPE="mariadb" ou "postgresql"
    DB_USERNAME="squash-tm"
    DB_PASSWORD="password"
    

  7. Démarrer Squash TM via :

    cd /opt/squash-tm/bin
    nohup ./startup.sh &
    

  8. Faire Ctrl+C pour reprendre le contrôle sur le terminal.

Installation du service systemd sous Debian

Pour installer Squash TM comme service systemd sous Debian :

  1. Copier le fichier de service systemd qui est dans /opt/squash-tm.

    cp /opt/squash-tm/squash-tm.service /etc/systemd/system/
    

  2. Puis recharger les services :

    systemctl daemon-reload
    

  3. Faire en sorte que Squash TM démarre avec le système :

    systemctl enable squash-tm
    

  4. Et enfin démarrer le service :

    systemctl start squash-tm
    

Il n’y a pas de fichier de service dans squash-tm-7.X.X.RELEASE.tar.gz. Il faut donc créer le fichier de service squash-tm.service avec le contenu qui suit :

[Unit]
Description=Squash-tm daemon
After=systemd-user-sessions.service time-sync.target

[Service]
WorkingDirectory=/opt/squash-tm/bin
ExecStart=/opt/squash-tm/bin/startup.sh
ExecStop=/bin/kill $MAINPID
KillMode=process
Type=simple
User=squash-tm
Group=squash-tm
Restart=on-failure
RestartSec=10
StartLimitInterval=120
StartLimitBurst=3
StandardOutput=null
StandardError=null

[Install]
WantedBy=multi-user.target

Installation avec Windows

Info

L’installeur Windows est livré à des fins d’évaluation et son utilisation dans un contexte de production est déconseillée. Il s'installe via un installeur. Il ne sera pas décrit ici.

Installation standard avec un fichier Zip

Pour installer Squash TM sous Windows :

  1. Décompresser l'archive .zip de Squash TM dans votre répertoire de travail (le chemin sera appelé <rep> par la suite). Attention : le processus Windows lié à Squash TM doit disposer des autorisations de lecture et d'écriture sur l'emplacement d'installation.

  2. Peupler la base de données grâce aux scripts présents dans <rep>\squash-tm\database-scripts.

    • S'il s'agit d'une première installation, passer le script <database>-full-install-version-7.X.X.RELEASE.sql correspondant au SGBD portant le numéro de version de Squash TM ;
    • S'il s'agit d'une montée de version, passer les scripts d'upgrade <database>-upgrade-to-X.X.X.sql correspondants au SGBD dans l'ordre des versions jusqu'à atteindre la version cible;
    • Ou s'il s'agit d'une restauration d'une base existante, passer la commande associée au SGBD pour restaurer le dump.
  3. Renseigner dans le fichier startup.bat les informations de connexion à la base de données :

    DB_URL="jdbc:mariadb://localhost:3306/squashtm" ou "jdbc:postgresql://localhost:5432/squashtm"
    DB_TYPE="mariadb" ou "postgresql"
    DB_USERNAME="squash-tm"
    DB_PASSWORD="password"
    

  4. Exécuter en double-cliquant directement le fichier startup.bat ou installer Squash TM en tant que service.

  5. Accéder à Squash TM via le navigateur à l'adresse suivante :

    http://localhost:8080/squash
    

    Les identifiants pour une installation nouvelle sont :

    login : admin
    mot de passe : admin
    

Installation en tant que service Windows (.exe)

Pour installer Squash TM en tant que service Windows, il faut au préalable avoir fait les 3 premières étapes de l'installation standard. Puis suivre les étapes suivantes :

  1. Installer le service Squash TM via l'invite de commandes en administrateur (cmd) :

    <rep>\squash-tm\bin\squash-tm.exe install
    

  2. Aller dans Services (rechercher Services ou dans l'onglet Services au niveau du gestionnaire des tâches).

  3. Démarrer le service squash-tm.

  4. Étape 5 de l'installation standard.

Passage d'une installation packagée (1.X) en tarball (.tar.gz).

Les distributions packagées Red Hat et Debian de Squash TM ne sont plus supportées à partir de Squash TM 2.0. Cette section décrit la procédure à suivre pour basculer d'une installation packagée en version 1.X de Squash TM à une installation en tarball.

Focus

Avant de commencer la procédure, bien sauvegarder tous les binaires, fichiers de configuration, plugins, licences, base de données de Squash TM.

Cette documentation est valable pour du Debian/Ubuntu ou Red Hat/CentOS, s'il y a des différences, celles-ci seront clairement notées.

Sauvegarde des éléments avant migration

Avant de procéder au transfert, il faut d'abord créer un répertoire de backup.

mkdir -p /opt/squash-bckp/plugins
mkdir -p /opt/squash-bckp/conf
mkdir -p /opt/squash-bckp/ident

Pour Debian/Ubuntu :

cp -r /usr/share/squash-tm/plugins/*  /opt/squash-bckp/plugins
cp -r /etc/squash-tm/* /opt/squash-bckp/conf
cp /etc/default/squash-tm /opt/squash-bckp/ident

Pour Red Hat/CentOS :

cp -r /usr/lib/squash-tm/plugins/*  /opt/squash-bckp/plugins
cp -r /etc/squash-tm/* /opt/squash-bckp/conf
cp /etc/sysconfig/squash-tm /opt/squash-bckp/ident

Suppression de l'ancienne installation

Attention

Si la désinstallation de la base de données est proposée, choisir "No".

Pour Debian/Ubuntu :

apt purge squash-tm

Pour Red Hat/CentOS :

yum remove squash-tm

Installation

Dans ce qui suit, il est supposé que l'archive de Squash TM a été téléchargée dans /opt.

cd /opt
tar -zxvf squash-tmXXXX.tar.gz
chmod +x squash-tm/bin/startup.sh

Reprise de l'ancienne installation

Configuration

Si les fichiers de configuration n'ont pas été modifiés, cette section peut être passée, sinon il faut ouvrir chaque fichier qui se trouve dans /opt/squash-bckp/conf, reprendre les anciens paramètres de configuration et les reporter dans les fichiers se trouvant dans /opt/squash-tm/conf/.

Connexion à la base de données

Pour récupérer la connexion à la base de données :

  • Ouvrir /opt/squash-bckp/ident/squash-tm
  • Reprendre les valeurs des variables :
    • DB_TYPE
    • DB_URL
    • DB_USERNAME
    • DB_PASSWORD
  • Les reporter dans le fichier /opt/squash-tm/bin/startup.sh

Focus

Ne pas oublier de passer les scripts d'upgrade sur la base de données pour faire la montée de version du schéma.

Licence

Pour récupérer le fichier de licence de Squash TM :

cp -ar /opt/squash-bckp/plugins/license /opt/squash-tm/plugins

Plugins

Les plugins évoluent entre la V1 et la V2 de Squash TM, il n'est donc pas possible de reprendre les anciens plugins en faisant un simple copier/coller :

  • Lister les plugins/jar se trouvant dans /opt/squash-bckp/plugins/.
  • En cas de plugin inclus dans la distribution de Squash TM, la mise à jour est déjà faite dans /opt/squash-tm/plugins/.
  • Pour les autres plugins, télécharger leur mise à jour sur la page Téléchargements.

Service sous systemd

  • Créer le fichier de service dans /etc/systemd/system/squash-tm.service.
  • Le remplir avec cet exemple (à modifier si l'installation ne se fait pas dans /opt) :

    [Unit]
    Description=Squash-TM daemon
    After=systemd-user-sessions.service time-sync.target
    
    [Service]
    WorkingDirectory=/opt/squash-tm/bin
    ExecStart=/opt/squash-tm/bin/startup.sh
    ExecStop=/bin/kill $MAINPID
    KillMode=process
    Type=simple
    #Restart=on-failure
    User=squash-tm
    Group=squash-tm
    
    [Install]
    WantedBy=multi-user.target
    
  • Recharger les services

    systemctl daemon-reload
    
  • Mettre à jour la base de données

    Les scripts de mise à jour se trouvent dans /opt/squash-tm/database-scripts/.

  • Changer l'utilisateur de Squash TM

    useradd squash-tm
    chown -R squash-tm: /opt/squash-tm/
    
  • Supprimer le repository

    • Pour Debian/Ubuntu

      rm /etc/apt/sources.list.d/squash-tm.list*
      

    • Pour Red Hat/CentOS

      rm /etc/yum.repos.d/squashtest.repo*
      

  • Lancer Squash TM

    systemctl enable squash-tm
    systemctl start squash-tm
    

Pour vérifier le bon déroulement du démarrage de Squash TM, regarder les logs dans /opt/squash-tm/logs/squash-tm.log.