Tâches de maintenance avant la mise à niveau pre-upgrade-maintenance-tasks

Avant de commencer la mise à niveau, il est important d’effectuer ces tâches de maintenance pour vous assurer que le système est prêt et peut être restauré en cas de problème :

Définitions d’index index-definitions

Assurez-vous d’avoir installé les définitions d’index requises publiées avec le dernier pack de services AEM 6.5. (Pour plus d’informations consultez les notes de mise à jour du pack de services AEM 6.5).

Vérification de la disponibilité de l’espace disque nécessaire ensure-sufficient-disk-space

Lors de l’exécution de la mise à niveau, assurez-vous que l’espace disque est suffisant.

Sauvegarde complète d’AEM fully-back-up-aem

AEM doit être entièrement sauvegardé avant le début de la mise à niveau. Veillez à sauvegarder votre référentiel, l’installation de l’application, le magasin de données et les instances Mongo, le cas échéant. Pour plus d’informations sur la sauvegarde et la restauration d’une instance AEM, reportez-vous à la section Sauvegarde et restauration.

Générer le fichier quickstart.properties generate-quickstart-properties

Lors du démarrage d’AEM depuis le fichier jar, un fichier quickstart.properties est généré sous crx-quickstart/conf. Si AEM a uniquement été démarré avec le script de démarrage dans le passé, ce fichier n’est pas présent et la mise à niveau échoue. Assurez-vous de vérifier l’existence de ce fichier et redémarrez AEM à partir du fichier jar s’il n’est pas présent.

Configuration de la purge du workflow et du journal d’audit configure-wf-audit-purging

Les tâches WorkflowPurgeTask et com.day.cq.audit.impl.AuditLogMaintenanceTask nécessitent des configurations OSGi distinctes et ne fonctionneront pas sans celles-ci. Si elles échouent lors de l’exécution de la tâche avant la mise à niveau, des configurations manquantes en sont la raison la plus probable. Par conséquent, veillez à ajouter des configurations OSGi pour ces tâches ou à les supprimer complètement de la liste des tâches d’optimisation avant la mise à niveau si vous ne souhaitez pas les exécuter. Vous trouverez la documentation relative à la configuration des tâches de purge des workflows dans la section Administration des instances de workflow et la configuration de la tâche de maintenance du journal d’audit dans la section Maintenance du journal d’audit dans AEM 6.

Installation, configuration et exécution des tâches précédant la mise à niveau install-configure-run-pre-upgrade-tasks

Les tâches de maintenance préalables à la mise à niveau qui devaient auparavant être effectuées manuellement sont optimisées et automatisées. L’optimisation de la maintenance avant la mise à niveau permet de déclencher ces tâches de manière unifiée et d’examiner leur résultat à la demande.

Utilisation how-to-use-it

Le composant OSGi PreUpgradeTasksMBean est préconfiguré avec une liste de tâches de maintenance bénéficiant déjà de la mise à niveau, pouvant toutes être exécutées simultanément. Vous pouvez configurer les tâches en suivant la procédure ci-dessous :

Vous trouverez ci-dessous une description du mode d’exécution pour lequel chaque tâche de maintenance est conçue.

Configuration par défaut des contrôles de l’intégrité avant la mise à niveau default-configuration-of-the-pre-upgrade-health-checks

Le composant OSGi PreUpgradeTasksMBeanImpl est préconfiguré avec une liste de balises de vérification de l’intégrité précédant la mise à niveau à exécuter lorsque la méthode runAllPreUpgradeHealthChecks est appelée :

Méthodes MBean

La fonctionnalité Bean gérée est accessible à l’aide de la console JMX.

Vous pouvez accéder aux MBeans en procédant comme suit :

Vous trouverez ci-dessous la liste de toutes les méthodes disponibles offertes par PreUpgradeTasksMBeanImpl :

Suppression des mises à jour du répertoire /install remove-updates-install-directory

Supprimez tous les packs de services, les packs de fonctionnalités ou les correctifs logiciels qui ont été déployés via le répertoire crx-quickstart/install sur le système de fichiers local. Cela évite l’installation accidentelle d’anciens correctifs et packs de services en plus de la nouvelle version d’AEM une fois la mise à jour terminée.

Arrêt de toutes les instances Cold Standby stop-tarmk-coldstandby-instance

Si vous utilisez un secours différé TarMK, arrêtez tous les secours différés. Cela garantit un moyen efficace de revenir en ligne en cas de problèmes lors de la mise à niveau. Une fois la mise à niveau terminée, les secours différés doivent être reconstruits à partir des instances principales mises à niveau.

Désactivation des tâches planifiées personnalisées disable-custom-scheduled-jobs

Désactivez toutes les tâches OSGi planifiées incluses dans le code de votre application.

Exécution d’un nettoyage des révisions hors ligne execute-offline-revision-cleanup

Si vous utilisez TarMK, vous devez exécuter le nettoyage des révisions hors ligne avant la mise à niveau. Cela permet à l’étape de migration du référentiel et aux tâches de mise à niveau suivantes de s’exécuter beaucoup plus rapidement et de garantir que le nettoyage des révisions en ligne peut s’exécuter correctement une fois la mise à niveau terminée. Pour plus d’informations sur l’exécution du nettoyage des révisions hors ligne, reportez-vous à la section Exécution du nettoyage des révisions hors ligne.

Exécution de la récupération de l’espace mémoire du magasin de données execute-datastore-garbage-collection

Après avoir exécuté le nettoyage des révisions sur les instances CRX3, vous devez exécuter la récupération de l’espace mémoire du magasin de données pour supprimer tous les objets blob non référencés dans le magasin de données. Pour obtenir des instructions, consultez la documentation sur la récupération de l’espace mémoire du magasin de données.

Rotation des fichiers journaux rotate-log-files

Nous vous recommande d’archiver vos fichiers journaux actuels avant de commencer la mise à niveau. Cela facilite la surveillance et l’analyse de vos fichiers journaux pendant et après la mise à niveau pour identifier et résoudre les problèmes qui peuvent surgir.