Installation de Vitam 4.0.3

Informations importantes

Notice :

Cette documentation couvre uniquement l'installation de Vitam 4.0.3 sur une machine Ubuntu 18.04 basé sur Debian 10 (Buster).

Seules deux distributions Linux suivantes sont supportées à ce jour :

• CentOS 7
• Debian 10 (Buster)

Veuillez vérifier la version de Debian utilisé par votre système d'exploitation.

Debian	Ubuntu
Debian 11 (Bullseye)	Ubuntu 20.04 (Focal)
Debian 10 (Buster)	Ubuntu 18.04 (Bionic)
Debian 9 (Stretch)	Ubuntu 16.04 (Xenial)
Debian 8 (Jessie)	Ubuntu 14.04 (Trusty)

Pré-requis

Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents :

• packages nécessaires :
  • ansible (version 2.9 minimale et conseillée)
  • openssh-client
  • JDK 11
  • Maven (version 3.3.9 minimale)
  • golang (version 1.6 minimale)
  • npm

Pour builder le projet VITAM, il est nécessaire de builder la librarie elasticsearch-metrics-reporter-java :

1. Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git
2. Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante : $ mvn clean install

La solution VITAM sera déployé dans un conteneur docker, veuillez vérifier qu'il est bien installé dans votre poste via la commande suivante : $ docker version

Pour ne pas avoir de soucis de droits, veuillez taper la commande suivante : $ sudo chmod 666 /var/run/docker.sock

Installation

Important :

Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM.

Pour installer VITAM, veuillez suivre les étapes suivantes :

1. Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git
2. Placez vous dans le répertoire de votre dépôt et tapez la commande suivante afin de builder le projet VITAM : $ mvn clean install -DskipITs -f sources/pom.xml -P-vitam
3.  Pour construire les packages deb dédiés, veuillez taper la commande suivante :$ ./deb/vitam-product/build-all.sh
4. Pour construire le cache des packages externes : $ ./deb/vitam-external/build_repo.sh

Déploiement au sein d'un conteneur docker

Vitam peut être construit et déployé docker de manière presque automatique, ce dernier héberge l'intégralité des outils requis pour construire et déployer la solution.

Pré-requis

• Docker 1.12 minimum avec driver "devicemapper"
• OS récent comme Ubuntu 18.04 ou Ubuntu 20.04
• Répertoire contenant un clone du dépôt git vitam/vitam
• Utilisateur autre que root, soit appartenant au group docker, soit ayant des capacités de sudo
• Le répertoire ${HOME}/.m2 existe et accessible en écriture
• Les ports "classiques" MongoDB (27017), Elasticsearch (9200, 9201), apache (80), SSL (8443) ne sont pas déjà attribués sur l'hôte

Procédure

1. Afin de démarrer le conteneur docker, il faut lancer le script : /vitam/dev-deployement/run.sh <environnement>, où <environnement> peut être rpm ou deb, dans notre cas deb.
2. Une fois le shell ouvert dans le conteneur, placez vous dans le dossier code et executez $ vitam-build-repo pour construire l'integralité des packages.
3. Veuillez lancer la commande vitam-recreate-repo afin de recreer la base de données associé au repo "local".
4. Pour déployer vitam, veuillez lancer la commande vitam-deploy