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.3 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 au préalable :

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

Build

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 -DskipTests -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é sur un environnement 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. Pour déployer vitam, veuillez lancer la commande vitam-deploy
4. Si vous souhaitez installer un apache reverse proxy qui met à disposition une page d'accueil avec les liens sur les différentes interfaces graphiques, veuillez taper la commande vitam-deploy-extra

Post déploiement

Une fois que le déploiement a été effectué avec succés, vous pouvez accèder a la page d'accueil via le localhost : 127.0.0.1

Dans cette page d'accueil, vous avez différents liens vers les différents services de VITAM. Le lien qui nous intéresse est celui de VITAM métier :

• VITAM IHM Demo : http://127.0.0.1/ihm-demo/#/login

Voici les informations de connexion pour s'identifier en tant qu'administrateur a VITAM :

• Identifiant : aadmin
• Mot de passe : aadmin1234

Pour bien comprendre les différents termes metiers employés par la documentation de VITAM, veuillez visiter ce lien : https://www.programmevitam.fr/ressources/Doc0.11.1/20170116_Design_SIP_beta_V1.4.pdf

Soucis de documentation lors du déploiement

Notice :

Le document concerné est le suivant : https://github.com/ProgrammeVitam/vitam/tree/master_4.0.x/deployment.

Le point II du chapitre 3 est sensé s’exécuter en premier, voici comment il faut procéder :

I. Générer les certificats : pki/scripts/generate_certs.sh environments/<fichier d'inventaire>

II. Configurer le vault référençant les mots de passe de chiffrement des clés privées des certificats : ansible-vault edit environments/certs/vault-certs.yml --vault-password-file vault_pass.txt

Il est important d’exécuter les commandes dans cet ordre pour le chapitre 4 :

I. Générer les keystores ./generate_stores.sh

II. Si besoin ansible-vault edit environments/group_vars/all/vault-keystores.yml --vault-password-file vault_pass.txt