.. _1.0.9_to_1.4.5: Montée de version 1.0.9 vers 1.4.5 ################################## La montée de version 1.0.9 (« R6.9 ») vers 1.4.5 (« R7.5 ») est réalisée par réinstallation de la solution logicielle :term:`VITAM` grâce aux playbooks ansible fournis, et selon la procédure d'installation classique décrite dans le Document d'INstallation (DIN). .. caution:: La migration doit être réalisée en partant de la version la plus récente de la version « R6 » (1.0.9). Prérequis à l'installation ========================== En prérequis, il est nécéssaire d'effectuer une reprise des données des contextes applicatifs (base MongoDB masterdata, collection Context). Cas de Consul ------------- Le composant ``vitam-consul`` a été monté de version ; le script suivant a pour but de mettre en conformité les fichiers de configuration de ce service afin qu'ils soient compatibles avec la nouvelle version. Pour jouer le(s) playbook(s) (VITAM et/ou extra), il faut rajouter à la commande de déploiement la directive : ``--tags consul_conf``. Exemple : ``ansible-playbook ansible-vitam/vitam.yml -i environments/ --vault-password-file vault_pass.txt --tags consul_conf`` ``ansible-playbook ansible-vitam-extra/extra.yml -i environments/ --ask-vault-pass --tags consul_conf`` A l'issue du passage de ce `playbook`, s'assurer que l'état des services Consul est OK. Si tel est le cas, la pré-migration pour la partie Consul a été effectuée avec succès. Cas des contextes applicatifs ----------------------------- En prérequis, il est égalemment nécéssaire d'effectuer une reprise des données des contextes applicatifs. Deux champs liés aux contextes applicatifs ont été mis à jour en version 1.4.1 (« R7.1 ») et doivent être migrés avant le déploiement de la nouvelle version de la solution logicielle :term:`VITAM`. Sous ``deployment``, il faut lancer la commande : ``ansible-playbook ansible-vitam-exploitation/preinstall_r7.yml --ask-vault-pass`` Si le playbook ne remonte pas d'erreur, la pré-migration des contextes applicatifs a été réalisée avec succès ; vous pouvez alors procéder au déploiement classique. Etapes post-installation ======================== Dans le cadre d'une montée de version 1.0.9 (« R6.9 ») vers 1.4.5 (« R7.5 »), il est nécessaire d'appliquer un `playbook` de migration de données à l'issue de réinstallation de la solution logicielle :term:`VITAM`. Ceci est dû à des changements de modèles de données suite à la mise en place de l’ontologie. .. caution:: Il existe une limitation connue de cette procédure de migration en version 1.4.5 (« R7.5 ») qui doit faire l'objet de correctifs attendus dans la prochaine version bugfix. Cette limitation concerne les tasks « Wait until service X is up » lorsque les composants vitam-functional-administration et vitam-metadata ne sont pas colocalisés, ainsi que l’utilisation du tag consul_conf pour la mise à jours du composant vitam-consul. Pour plus de précisions dans tel cas de figure, merci de contacter le support. Avant de procéder à la migration -------------------------------- Les commandes sont à lancer depuis le répertoire ``deployment`` sur les différents sites hébergeant la solution logicielle :term:`VITAM` : ``ansible-playbook -i environments/ ansible-vitam-exploitation/stop_vitam_timers.yml --vault-password-file vault_pass.txt`` ou, si vault_pass.txt n'a pas été renseigné : ``ansible-playbook -i environments/ ansible-vitam-exploitation/stop_vitam_timers.yml --ask-vault-pass`` A l'issue de ce playbook, les timer systemD ont été arrêtés, afin de ne pas perturber la migration. Il est également recommandé de ne lancer la procédure de migration qu'une fois s'être assuré qu'aucun `workflow` n'est actuellement en cours de traitement. Procédure de migration des données ---------------------------------- Il faut alors procéder à la migration des données avec la commande suivante (sur le site primaire uniquement) : ``ansible-playbook -i environments/ ansible-vitam-exploitation/migration_r6_r7.yml --vault-password-file vault_pass.txt`` ou, si vault_pass.txt n'a pas été renseigné : ``ansible-playbook -i environments/ ansible-vitam-exploitation/migration_r6_r7.yml --ask-vault-pass`` .. warning:: Selon la volumétrie des données précédement chargées, le `playbook` peut durer jusqu'à plusieurs heures. .. note:: Durant le temps des migrations, il est fortement recommandé de ne pas procéder à des injections de données. Le `playbook` se charge d'arrêter les composants "ingest-external" et "access-external", de réaliser les opérations de migration des données, puis de redémarrer les composants "ingest-external" et "access-external". Les opérations de migration réalisées impactent, entre autres : - graph / SEDA - mise à jour d'un champ des contextes applicatifs - réindexations Elasticsearch .. warning:: En cas de souci, contacter l'équipe support. Après la migration ------------------ A l'issue de la bonne exécution du `playbook`, il faut lancer la commande suivante pour réactiver les timers systemD sur les différents sites hébergeant la solution logicielle :term:`VITAM` : ``ansible-playbook -i environments/ ansible-vitam-exploitation/start_vitam_timers.yml --vault-password-file vault_pass.txt`` ou, si vault_pass.txt n'a pas été renseigné : ``ansible-playbook -i environments/ ansible-vitam-exploitation/start_vitam_timers.yml --ask-vault-pass`` Vérification de la bonne migration des données ---------------------------------------------- A l'issue de la migration, il est fortement conseillé de lancer un "Audit de cohérence" sur les différents tenants.