4.2.6. Notes et procédures spécifiques V6¶
4.2.6.1. Procédures à exécuter AVANT la montée de version¶
4.2.6.1.1. Duplication des packages lors de la mise à jour¶
Prudence
Cette procédure doit être exécutée uniquement en cas de migration depuis une version 6.2- (v6.2 ou inférieur) vers une version 6.3+ (v6.3 ou supérieure).
Prudence
Cette opération doit être effectuée uniquement pour les systèmes d’exploitation à base de RPM (CentOS 7 & AlmaLinux 9) sur un vitam éteint.
Un bug a été introduit dans la construction des packages RPM à partir de la V6RC. Si vous effectuez une montée de version depuis la V6RC ou de la V6, vous devrez appliquer la commande suivante pour supprimer les précédents packages. Sinon lors de de la mise à jour, le package précédent ne sera pas désinstallé conduisant à la présence de plusieurs versions du même package.
Exemple d’erreur:
/var/tmp/rpm-tmp.fGwZMk: ligne 1 : fg: pas de contrôle de tâche
erreur : %preun(vitam-offer-6.2-1.noarch) scriptlet échoué, état de sortie 1
Error in PREUN scriptlet in rpm package vitam-offer
erreur : vitam-offer-6.2-1.noarch: effacer échoué
Voici la commande à exécuter pour permettre la désinstallation des packages de la version précédente:
ansible vitam --ask-vault-pass -v -a "yum --setopt=tsflags=noscripts remove -y vitam-*.noarch" -i environments/<inventaire>
4.2.6.2. Procédures à exécuter APRÈS la montée de version¶
4.2.6.2.1. Migration des mappings elasticsearch¶
Prudence
Cette procédure doit être exécutée uniquement en cas de migration depuis une version 6.1- (v6.1 ou inférieur) vers une version 6.2+ (6.2 ou supérieure).
Cette migration de données consiste à mettre à jour le modèle d’indexation elasticsearch-data.
Elle est réalisée en exécutant la procédure suivante sur tous les sites (primaire et secondaire(s)) :
- Les jobs Vitam et les services externals de Vitam doivent être arrêtés sur tous les sites :
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/stop_external.yml --ask-vault-pass
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/stop_vitam_scheduling.yml --ask-vault-pass
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/stop_vitam_scheduler.yml --ask-vault-pass
- Réindexation des référentiels sur elasticsearch :
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/reindex_es_data.yml --ask-vault-pass --tags "securityprofile, context, ontology, ingestcontract, agencies, accessionregisterdetail, archiveunitprofile, accessionregistersummary, accesscontract, fileformat, filerules, profile, griffin, preservationscenario, managementcontract"
- Lancement de la migration du modèles d’indexation des métadonnées sur elasticsearch-data :
ansible-playbook -i environments/<inventaire> ansible-vitam-migration/migration_elasticsearch_mapping.yml --ask-vault-pass
- Réactivation des services externals ainsi que les timers sur tous les sites :
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/start_external.yml --ask-vault-pass
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/start_vitam_scheduler.yml --ask-vault-pass
ansible-playbook -i environments/<inventaire> ansible-vitam-exploitation/start_vitam_scheduling.yml --ask-vault-pass
4.2.6.2.2. Migration unités archivistiques avec demande de transfert non complétée¶
Cette migration permet de corriger des erreurs de sécurisation ou d’audit sur des unités archivistiques pour lesquelles une demande de transfert a été initiée, mais dont le transfert effectif n’a pas été finalisée.
Prudence
Cette procédure doit être exécutée uniquement en cas de migration mineure depuis une version 6.3.1- (v6.3.1 ou inférieure) vers une version 6.4+ (v6.4 ou supérieure).
Prudence
Cette migration est à effectuer APRES l’installation et uniquement sur le site primaire.
Prudence
Dans le cas où un tenant comporte un très grand nombre d’unités archivistiques dont la demande de transfert a été initiée pour un tenant donné (plus de 100 000 unités archivistiques), la migration ne pourra alors s’opérer. Le support Vitam devra alors être contacté.
Pour lancer la migration, le playbook suivant doit être exécuté :
ansible-playbook -i environments/<inventaire> ansible-vitam-migration/migration_metadata_transfer_request_traceability.yml --ask-vault-pass