Il y a 389 articles et 19 utilisateurs inscrits (ce bandeau est défini dans MediaWiki:Sitenotice)

« Installation de Vitam 4.0.3 » : différence entre les versions

De AJLSM
Aller à la navigation Aller à la recherche
← Modification précédente

Ymazouar (discussion | contributions)

273 modifications
annuler
VisuelWikicode
Ymazouar (discussion | contributions)
273 modifications
Aucun résumé des modifications
Ymazouar (discussion | contributions)
273 modifications
 
(40 versions intermédiaires par le même utilisateur non affichées)
Ligne 22 : Ligne 22 :
Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents :
Sachant que le déploiement est orchestré depuis un serveur d'administration, les pré-requis suivants doivent y être présents :
* packages nécessaires :
* packages nécessaires :
** '''ansible''' (version 2.9 minimale et conseillée)
** '''ansible''' (version 2.3 minimale et conseillée)
** '''openssh-client'''
** '''openssh-client'''
** '''JDK 11'''
** '''JDK 11'''
** '''Maven''' (version 3.3.9 minimale)
** '''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''' :
Pour builder le projet VITAM, il est nécessaire de builder la librarie '''elasticsearch-metrics-reporter-java''' au préalable :
# Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git
# Commencez par cloner le depôt git : https://github.com/ProgrammeVitam/elasticsearch-metrics-reporter-java.git
# Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante : '''{{cmd|$ mvn clean install}}'''
# Une fois que le dépôt a été cloné, veuillez le builder avec la commande suivante : '''{{cmd|$ 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 : '''{{cmd|$ docker version}}'''.
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 : '''{{cmd|$ docker version}}'''


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


=== Installation ===
=== Build ===
{{important|Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM}}
{{important|Toutes les étapes sont obligatoires afin d'assurer l'installation ainsi que le déploiement de VITAM}}
Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git
Pour installer VITAM, veuillez suivre les étapes suivantes :
# Tout d'abord, commencez par cloner le dépôt VITAM : https://github.com/ProgrammeVitam/vitam.git
# Placez vous dans le répertoire de votre dépôt et tapez la commande suivante afin de builder le projet VITAM : '''{{cmd|$ mvn clean install -DskipTests -f sources/pom.xml -P-vitam}}'''
# Pour construire les packages deb dédiés, veuillez taper la commande suivante :'''{{cmd|$ ./deb/vitam-product/build-all.sh}}'''
# Pour construire le cache des packages externes : '''{{cmd|$ ./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 {{path|${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 ====
# Afin de démarrer le conteneur docker, il faut lancer le script : '''{{cmd|/vitam/dev-deployement/run.sh <environnement>}}''', où <environnement> peut être rpm ou deb, dans notre cas '''deb'''.
# Une fois le shell ouvert dans le conteneur, placez vous dans le dossier '''code''' et executez '''{{cmd|$ vitam-build-repo}}''' pour construire l'integralité des packages.
# Pour déployer vitam, veuillez lancer la commande '''{{cmd|vitam-deploy}}'''
# 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 '''{{cmd|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 a la main ===
{{important|La méthode de déploiement concerné est la 2 : https://github.com/ProgrammeVitam/vitam}}
{{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 : {{cmd|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 : {{cmd|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 {{cmd|./generate_stores.sh}}
 
'''II.''' Si besoin {{cmd|ansible-vault edit environments/group_vars/all/vault-keystores.yml --vault-password-file vault_pass.txt}}

Dernière version du 30 septembre 2021 à 13:59

Informations importantes

[modifier | modifier le wikicode]
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

[modifier | modifier le wikicode]

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

[modifier | modifier le wikicode]
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

[modifier | modifier le wikicode]

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

[modifier | modifier le wikicode]
  • 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

[modifier | modifier le wikicode]
  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

[modifier | modifier le wikicode]

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 :

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 a la main

[modifier | modifier le wikicode]
Important :
La méthode de déploiement concerné est la 2 : https://github.com/ProgrammeVitam/vitam.
Notice :

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

Récupérée de "https://mediawiki.ajlsm.com/index.php?title=Installation_de_Vitam_4.0.3&oldid=4412"