Guide d'installation Windows

Modifié par jhurst le 2024/04/02 14:26

 Java est requis pour pouvoir lancer DigDash. Actuellement, la version 17 de java n'est pas supportée et ne fonctionnera pas. Nous recommandons d'utiliser java 11 (les versions 12 à 16 n'étant pas des versions LTS) pour le moment.

Introduction

L'installation de DigDash Enterprise sur Windows peut se faire de deux façons :

  • Installation pour lancement manuel
  • Installation en tant que service Windows

Ce document décrit comment installer DigDash sur Windows dans ces deux modes.

Pour l'installation sur Linux, se reporter au document Guide d'Installation Linux.

Pour une mise à jour d'une installation existante, se reporter au document Guide de mise à jour.

Installation

Décompressez les fichiers contenus dans le fichier digdash_enterprise_20xx_64.zip vers le répertoire de votre choix sur votre ordinateur. L'ensemble des fichiers serveurs de DigDash Enterprise est à présent installé sur votre ordinateur.

L'installation peut également être faite par l'installeur fourni (voir documentation Installation).

Paramètres Tomcat

Certains paramétrages usuels tels que allocation de mémoire et les ports réseaux nécessaires sont susceptibles d'être modifiés dés l'installation.

Ce paragraphe décrit comment modifier trois des paramètres les plus importants au moment de l'installation : l'allocation de mémoire à tomcat, les ports réseau utilisés et le nom du service Windows (si une installation en tant que service Windows est prévue).

Une liste plus complète de paramètres système est dans le document Réglages avancés des paramètres système.

Mémoire allouée à Tomcat

  1. Ouvrez le répertoire <DD Install>\configure puis éditez le fichier setenv.bat
  2. Modifiez les valeurs des variables JVMMS et JVMMX définies en début du fichier. Par exemple : set JVMMS=4096 et set JVMMX=4096 pour augmenter la mémoire allouée à Tomcat à 4Go.

Ports réseau Tomcat

Si un des ports nécessaires à Tomcat est déjà utilisé par un autre processus, alors il ne se lancera pas. Il est nécessaire de vérifier la disponibilité des ports et si besoin de reconfigurer Tomcat. Par défaut les 3 ports suivants sont configurés : 8005, 8080 et 8009. Pour les modifier :

  1. Ouvrez le répertoire <DD Install>\apache-tomcat/conf puis éditer le fichier server.xml
  2. Cherchez et remplacez les valeurs des ports 8005, 8080 et 8009 par des numéros de port disponibles sur le système.

Nom du service Windows Tomcat

Dans certains cas il est intéressant de modifier le nom du service Windows qui sera créé lors de l'installation en tant que service (chapitre suivant), par exemple : un service du même nom existe déjà.

  1. Ouvrez le répertoire <DD Install>\configure puis éditez le fichier servers_install_service_64.bat
  2. Cherchez et modifiez la valeur de la variable SERVICE_NAME au début du fichier. Par exemple : set SERVICE_NAME=Tomcat_DEV

Démarrage et arrêt manuel de DigDash Enterprise

Lorsque DigDash Enterprise n'est pas installé en tant que service Windows.

Démarrage de DigDash Enterprise

Ouvrez le répertoire d'installation de DigDash Entreprise, puis double cliquez sur le fichier start_tomcat.bat.

Le premier démarrage du serveur peut prendre plusieurs minutes car les applications web se déploient.

Arrêt de DigDash Enterprise

Ouvrez le répertoire d'installation de DigDash Entreprise, puis double cliquez sur le fichier stop_tomcat.bat.

Installation en tant que service Windows

L'installation en tant que service doit être faite avec un utilisateur ayant des droits d'administration Windows sur cette machine.

Assurez-vous d'avoir vérifié et modifié si besoin les paramètres importants mentionnés dans le chapitre précédent avant d'installer le service.

  1. Démarrez l'invite de commande (faites un clic droit sur l'invite de commande et sélectionner « Exécuter en tant qu'administrateur »)
  2. Positionnez-vous dans le répertoire <DD Install>\configure puis entrez la commande servers_install_service_64.bat sur Windows 64 bits ou servers_install_service.bat sur Windows 32 bits. Le service « Apache Tomcat » est installé (ou un autre nom que vous auriez spécifié).
  3. Le service est installé en lancement manuel par défaut. Pour modifier ce comportement il faut lancer le gestionnaire de services Windows, et changer les propriétés du nouveau service. Pensez aussi à vérifier au même endroit que l'utilisateur exécutant le service est bien configuré.

Déployer le studio standalone (facultatif)

Cette procédure s’applique depuis la version 2019R1 incluse.

  1. Arrêtez le serveur
  2. Ouvrez l’explorateur de fichiers et naviguez jusqu’au dossier :
    • <DD Install>\add-ons\studio_standalone
  3. Exécutez la ou les commandes suivantes selon votre besoin :
    • .\deploy_studio_linux.bat
    • .\deploy_studio_macos.bat
    • .\deploy_studio_windows.bat
  4. Ces commandes vont créer des fichiers war dans le dossier apache-tomcat\webapps :
    • studio_linux.war
    • studio_macos.war
    • studio_windows_64bits.war
  5. Si vous utilisez votre propre Tomcat, déplacez ces war dans votre dossier webapps
  6. Redémarrez le serveur

La page d’accueil contient maintenant des liens pour télécharger les versions du Studio déployées précédemment.