Exécution d’une mise à niveau statique

REMARQUE

Cette page décrit la procédure de mise à niveau pour AEM 6.4. Si une installation est déployée sur un serveur d’application, reportez-vous à la section Procédure de mise à niveau pour les installations du serveur d’application.

Procédure pré-mise à niveau

Avant d’effectuer la mise à niveau, différentes étapes doivent être exécutées. Pour plus d’informations, reportez-vous aux sections Mise à niveau du code et personnalisations et Tâches de maintenance pré-mise à niveau. De plus, assurez-vous que le système répond à la configuration requise pour la nouvelle version d’AEM. Découvrez comment l’outil de détection des motifs peut vous aider à évaluer la complexité de votre mise à niveau. Pour plus d’informations, vous pouvez également consulter la section Portée et exigences de la mise à niveau de la rubrique Planification de la mise à niveau.

Prérequis pour la migration

Version Java minimale requise : L’outil de migration ne fonctionne qu’avec Java 7 et version ultérieure. Notez que pour AEM 6.3, et versions ultérieures, l’environnement JRE 8 d’Oracle et les environnements JRE 7 et 8 d’IBM sont les seules versions prises en charge.
Instance mise à niveau : si vous effectuez une mise à niveau d’une version antérieure à la version 5.6, assurez-vous que vous avez effectué une mise à niveau statique vers AEM 6.0 en suivant la procédure décrite dans la version 6.0 de la documentation de mise à niveau.

Préparation du fichier jar de démarrage rapide AEM

Arrêtez l’instance si elle est en cours d’exécution.
Téléchargez le nouveau fichier JAR d’AEM et utilisez-le pour remplacer l’ancien en dehors du dossier crx-quickstart.
Décompressez le nouveau fichier jar de démarrage rapide en exécutant :
```
java -Xmx4096m -jar aem-quickstart.jar -unpack
```

Migration du référentiel de contenu

Cette migration n’est pas requise si vous effectuez une mise à niveau à partir d’AEM 6.3. Pour les versions antérieures à 6.3, Adobe fournit un outil qui permet de faire migrer le référentiel vers la nouvelle version du fichier Oak Segment Tar présente dans AEM 6.3. Fourni dans le cadre du module de démarrage rapide, cet outil est obligatoire pour toutes les mises à niveau qui utilisent TarMK. Les mises à niveau pour les environnements qui utilisent MongoMK n’impliquent pas de migrer le référentiel. Pour plus d’informations sur les avantages du nouveau format de fichier TAR Segment, reportez-vous à la section Questions fréquentes sur la migration vers le fichier TAR d’Oak Segment.

La migration réelle est effectuée à l’aide du fichier JAR de démarrage rapide d’AEM, exécuté avec une nouvelle option -x crx2oak, qui exécute l’outil crx2oak afin de simplifier la mise à niveau et de la rendre plus robuste.

REMARQUE

Si vous effectuez une migration du contenu du référentiel TarMK avec l’extension de démarrage rapide CRX2Oak, vous pouvez supprimer le mode d’exécution samplecontent en ajoutant la commande suivante à la ligne de commande de migration :

--promote-runmode nosamplecontent

Pour déterminer la commande à exécuter, utilisez la commande suivante :

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

Où <<YOUR_PROFILE>> et <<ADDITIONAL_FLAGS>> sont remplacés par le profil et les indicateurs figurant dans le tableau suivant :

Référentiel source	Référentiel cible	Profil	Indicateurs supplémentaires
crx2 ou TarMK avec `FileDataStore`	TarMK	segment-fds	Reportez-vous à la section Dépannage ci-dessous.
crx2	MongoMK	mongo-from-crx2	`-T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name`
TarMK ou crx2 avec `S3DataStore`	TarMK	segment-custom-ds	Reportez-vous à la section Dépannage ci-dessous.
TarMK sans magasin de données	TarMK	segment-no-ds
MongoMK	MongoMK	Aucune migration n’est nécessaire

Où :

mongo-host correspond à l’IP du serveur MongoDB (par exemple, 127.0.0.1) ;
mongo-port correspond au port du serveur MongoDB (par exemple, 27017) ;
mongo-database-name représente le nom de la base de données (par exemple : aem-auteur).

Vous pouvez également avoir besoin de commutateurs supplémentaires pour les scénarios suivants :

Si vous effectuez la mise à niveau sur un système Windows, sur lequel le mappage de la mémoire Java n’est pas géré correctement, ajoutez le paramètre --disable-mmap à la commande.
Si vous utilisez Java 7, ajoutez le paramètre -XX:MaxPermSize=2048m juste après le paramètre -Xmx.

Pour plus d’informations sur l’utilisation de l’outil crx2oak, reportez-vous à la section Utilisation de l’outil de migration CRX2Oak. Le fichier JAR auxiliaire de crx2oak peut être mis à niveau manuellement, si nécessaire, en le remplaçant manuellement par des versions récentes après la décompression du démarrage rapide. Son emplacement dans le dossier d’installation AEM est le suivant : <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. La dernière version de l’outil de migration CRX2Oak peut être téléchargée sur Adobe Repository, à l’adresse : https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Si la migration a réussi, l’outil quitte avec un code de sortie égal à 0. Cherchez également des messages AVERTISSEMENT et ERREUR dans le fichier upgrade.log, disponible sous crx-quickstart/logs dans le répertoire d’installation d’AEM, car ils peuvent indiquer des erreurs non fatales qui se sont produites lors de la migration.

Vérifiez les fichiers de configuration dans le dossier crx-quickstart/install. Si une migration est nécessaire, ils sont mis à jour de manière à refléter le référentiel cible.

REMARQUE

Lorsque FileDataStore est la nouvelle valeur par défaut pour des installations AEM 6.3, l’utilisation d’un magasin de données externe n’est pas nécessaire. Même si les meilleures pratiques recommandent d’utiliser un magasin de données externe pour les déploiements en environnement de production, cela n’est pas un prérequis pour la mise à niveau. En raison de la complexité existante lors de la mise à niveau d’AEM, il est recommandé d’effectuer la mise à niveau sans migrer le magasin de données. Si vous le souhaitez, vous pouvez effectuer la migration du magasin de données séparément.

Dépannage des problèmes de migration

Veuillez ignorer cette section si vous effectuez une mise à niveau à partir de la version 6.3. Même si les profils crx2oak fournis doivent répondre aux besoins de la plupart des clients, des paramètres supplémentaires sont parfois nécessaires. Si une erreur se produit lors de la migration, certains aspects de l’environnement peuvent nécessiter des options de configuration supplémentaires. Si c’est le cas, l’erreur qui se produit est probablement la suivante :

Les points de contrôle ne sont pas copiés, car aucun magasin de données externe n’a été spécifié. De ce fait, le référentiel sera entièrement réindexé au premier démarrage. Utilisez --skip-checkpoints pour forcer la migration ou reportez-vous à https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration pour plus d’informations.

Pour une raison quelconque, la procédure de migration doit accéder aux fichiers binaires du magasin de données et ne le trouve pas. Pour spécifier la configuration du magasin de données, incluez les indicateurs ci-dessous dans la partie <<ADDITIONAL_FLAGS>> de la commande de migration :

Pour les magasins de données S3 :

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Où /path/to/SharedS3DataStore.config représente le chemin d’accès au fichier de configuration de votre magasin de données S3, et /path/to/datastore représente le chemin d’accès à votre magasin de données S3.

Pour les magasins de données de fichier :

--src-datastore=/path/to/datastore

Où /path/to/datastore représente le chemin d’accès à votre magasin de données de fichier.

Exécution de la mise à niveau

Si vous utilisez S3 :

Supprimez les fichiers JAR sous crx-quickstart/install associés à une version antérieure du connecteur S3.
Téléchargez la dernière version du connecteur S3 1.8.x à partir de https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/
Extrayez le module dans un dossier temporaire et copiez le contenu de jcr_root/libs/system/install dans le dossier crx-quickstart/install.

Détermination de la commande de démarrage de mise à niveau appropriée

Pour effectuer la mise à niveau, il est important de démarrer AEM à l’aide du fichier JAR pour activer l’instance. Pour passer à la version 6.4, veuillez également consulter d’autres options de migration et de restructuration de contenu dans la Migration de contenu différée que vous pouvez sélectionner avec la commande de mise à niveau.

Notez que le démarrage d’AEM à partir du script de démarrage ne lance pas la mise à niveau. La plupart des clients démarrent AEM à l’aide du script de démarrage et ont personnalisé ce script de démarrage de manière à inclure des commutateurs pour les configurations d’environnement, comme les paramètres de mémoire, les certificats de sécurité, etc. Pour cette raison, il est recommandé de suivre cette procédure pour déterminer la commande de mise à niveau appropriée :

Sur une instance d’AEM en cours d’exécution, exécutez les opérations ci-dessous dans une ligne de commande :
```
ps -ef | grep java
```

Recherchez le processus AEM. Le code se présente comme suit :

/usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties

Modifiez la commande en remplaçant le chemin d’accès dans le fichier JAR existant (crx-quickstart/app/aem-quickstart*.jar dans ce cas) par le nouveau fichier JAR qui est un frère du dossier crx-quickstart. Avec la commande précédente comme exemple, la commande serait la suivante :
```
/usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
```
Cela permet de s’assurer que tous les paramètres de mémoire appropriés, modes d’exécution personnalisés et autres paramètres d’environnement sont appliqués pour la mise à niveau. Une fois que la mise à niveau est terminée, l’instance peut être démarrée à partir du script de démarrage lors des démarrages ultérieurs.

Déploiement de la base de code mise à niveau

Une fois que la procédure de mise à niveau statique est terminée, la base de code mise à jour doit être déployé. La procédure de mise à jour de la base de code pour qu’elle fonctionne dans la version cible d’AEM est disponible dans la page Mise à niveau du code et personnalisations.