Installer une version de test de BDF sous Debian ou Ubuntu

1) Installation de Tomcat 9

Comme cela ne peut pas faire de mal, commencez par mettre à jour vos dépôts :

sudo apt update

Puis installez le paquet tomcat9

sudo apt install tomcat9

Toutes les dépendances nécessaires sont installées. L’installation crèe un utilisateur tomcat et un service appelé tomcat9. Celui est lancé dès l’installation : en ouvrant l’adresse http://localhost:8080/, vous devriez voir apparaitre une page annonçant It works !.

Si le service n’est pas lancé, la commande de lancement est la suivante :

sudo systemctl start tomcat9

2) Déployer le fichier .war

Rendez-vous dans le répertoire par défaut des applications Tomcat :

cd /var/lib/tomcat9/webapps/

Consultez les étiquettes du dépôt du projet BDF, repérez le numéro de la version qui vous intéresse et récupérez le fichier .war correspondant à l’adresse bdf.exemole.fr/archives/ (les plus aventureux pourront prendre la dernière version compilée dans bdf.exemole.fr/latest/).

Téléchargez le fichier directement dans le répertoire /var/lib/tomcat9/webapps/.

sudo wget https://bdf.exemole.fr/latest/bdf##****.war

Vous pouvez aussi obtenir le fichier .war en compilant à partir des sources comme indiqué dans le dépôt (framagit.org/fichotheque/bdf).

Vérifier que le fichier .war peut bien être lu par l’utilisateur tomcat. Au bout de quelques instants, Tomcat devrait repérer la présence du fichier, le lire et déployer l’application dans un répertoire du nom du fichier.

3) Initialisation et première fichothèque

Il faut ensuite ouvrir dans son navigateur l’adresse http://localhost:8080/bdf/multi-admin pour faire apparaitre le formulaire d’initialisation. Pour un test, vous pouvez laisser les valeurs par défaut. Cochez Créer une première fichothèque pour qu’une première fichothèque soit créé à l’initialisation (Attention, pour le champ Nom technique de la fichothèque, seules les minuscules et le tiret bas sont acceptés). Après validation, vous aurez le lien vers votre première fichothèque. Pour vous connecter, il faut utiliser comme identifiant ce que vous aurez mis dans le champ Identifiant de la première personne (par défaut, « Admin »). Votre fichothèque est évidemment vide, il ne vous restera plus qu’à créer un corpus, un bouton vous invite à le faire.

4) Stockage des données

Avec cette installation rapide, les données de votre fichothèque vont être stockées dans le répertoire /var/lib/tomcat9/webapps/_var_/bdf/. Ce n’est pas très orthodoxe puisque /var/lib/tomcat9/webapps/ est le répertoire des applications. Cela a l’avantage de limiter les étapes de configuration Tomcat puisque dans la configuration du service tomcat9 proposée par les paquets de Debian et d’Ubuntu, c’est l’un des seuls répertoires accessibles en écriture par le service.

Il faudra une meilleure configuration pour une installation plus pérenne. Dans nos serveurs, nous utilisons le paquet complémentaire tomcat-user qui permet d’utiliser Tomcat par un utilisateur de son choix (Voir la présentation du paquet sur le site de Debian.