Installation d’Apache Tomcat 9

Apache Tomcat 9 est un logiciel permettant de lancer des applications web développées en langage Java. Il est donc indispensable à la bonne exécution de Karuta.

Procédure
  1. Site de téléchargement de Tomcat

    Rendez-vous sur le site de Tomcat

    Attention

    ⚠️⚠️⚠️ La version 10 de Tomcat n’est actuellement pas compatible avec Karuta.

  2. Télécharger Tomcat 9.0

    Choisissez la version zip :

    Les différentes versions d'installation de Tomcat 9Informations[1]
  3. Décompression

    Décompressez l'archive, vous obtiendrez un dossier dont le nom commence par apache-tomcat-9

  4. Déplacement du dossier

    Déplacer le dossier nouvellement créé à la racine de votre compte

    Racine du compte utilisateur (sous MacOs)Informations[2]
  5. Variable d'environnement

    Qu'est-ce que c'est ?

    Il est nécessaire de créer une variable d'environnement qui permettra à Karuta de savoir où se trouve Tomcat. Une variable d'environnement est une sorte de conteneur nommé (ici KARUTA_HOME) dans lequel on stocke une information (ici l'emplacement où se trouve Tomcat) : cela permet à une application (comme Karuta) de connaitre une information qui peut éventuellement varier (l'emplacement ou le nom du dossier contenant Tomcat peut, en fonction des versions, être différent).

    Comment faire ?

    Sur MacOs, il n'existe pas d'outil spécifique pour créer ou modifier des variables d'environnement. Nous allons utiliser l'éditeur TextEdit, en principe disponible sur toutes les versions de MacOs, voici 2 solutions :

    ConseilA partir d'un terminal

    1. Lancez un Terminal

    2. vérifiez que vous êtes à la racine de votre compte (avec la commande pwd) : le chemin doit être de la forme /Users/nom_de_votre_compte

    3. saisissez, ou copiez/collez, la commande suivante (respectez bien les majuscules/minuscules) :

      open -a TextEdit .bash_profile

    4. vous venez d'ouvrir le fichier .bash_profile dans l'éditeur de texte TextEdit : soyez très prudent, c'est un fichier important. Ajoutez une ligne qui ressemblera à ceci :

      export KARUTA_HOME=/Users/nom_de_votre_compte/apache-tomcat-9.0.87

      Pour ce qui est à droite du signe =, vous pouvez utiliser le Finder pour copier le chemin complet et le coller ensuite dans TextEdit :

      Copier un chemin complet dans le Finder de MacOsInformations[3]
    5. Enregistrer le fichier

    ConseilA partir de TextEdit

    TextEdit est un éditeur de textes par défaut (il est bien sûr possible d'en utiliser d'autres mais surtout pas un traitement de textes comme Page, LibreOffice Writer ou Word : cela modifierait la nature du fichier. Le fichier à modifier s'appelle .bash_profile (avec un point devant, c'est un fichier caché). Voici la méthode :

    1. Lancez TextEdit

    2. Allez dans FichierOuvrir

    3. Cliquez sur l'icône en haut à gauche (devant le nom de votre compte)

    4. pour faire apparaitre les fichiers cachés, appuyez sur les touches suivantes (en même temps) :

      ⌘ command + ⇧ shift + .

    5. double-cliquez sur le fichier .bash_profile pour l'ouvrir

    6. soyez maintenant très prudent, il s'agit d'un fichier sensible. Ajoutez une ligne qui ressemblera à ceci :

      export KARUTA_HOME=/Users/nom_de_votre_compte/apache-tomcat-9.0.87

      Pour ce qui est à droite du signe =, vous pouvez utiliser le Finder pour copier le chemin complet et le coller ensuite dans TextEdit :

      Copier un chemin complet dans le Finder de MacOsInformations[3]
    7. Enregistrer le fichier