Cette section décrit la procédure qui doit être suivie afin de mettre à jour AEM pour les installations de serveur d’applications.
Tous les exemples de cette procédure utilisent Tomcat comme serveur d’applications et impliquent que vous disposez d’une version fonctionnelle d’AEM déjà déployée. La procédure est destinée à documenter les mises à niveau d’AEM version 6.4 vers la version 6.5.
D'abord, démarrez TomCat. Dans la plupart des cas, vous pouvez effectuer cette opération en exécutant l’événement ./catalina.sh
démarrez le script de démarrage en exécutant cette commande à partir du terminal :
$CATALINA_HOME/bin/catalina.sh start
Si AEM 6.4 est déjà déployé, vérifiez que les lots fonctionnent correctement en accédant à :
https://<serveraddress:port>/cq/system/console/bundles
Ensuite, annulez le déploiement d’AEM 6.4. Pour ce faire, utilisez le gestionnaire d’applications TomCat (http://serveraddress:serverport/manager/html
)
Maintenant, migrez le référentiel à l’aide de l’outil de migration crx2oak. Pour ce faire, téléchargez la dernière version de crx2oak à partir de cet emplacement.
SLING_HOME= $AEM-HOME/crx-quickstart java -Xmx4096m -XX:MaxPermSize=2048M -jar crx2oak.jar --load-profile segment-fds
Supprimez les propriétés requises du fichier sling.properties en procédant comme suit :
Ouvrez le fichier situé à l’adresse crx-quickstart/launchpad/sling.properties
Supprimez les propriétés suivantes et enregistrez le fichier :
sling.installer.dir
felix.cm.dir
granite.product.version
org.osgi.framework.system.packages
osgi-core-packages
osgi-compendium-services
jre-*
sling.run.mode.install.options
Supprimez les fichiers et dossiers qui ne sont plus nécessaires. Vous devez précisément supprimer les éléments suivants :
Le dossier launchpad/startup. Vous pouvez le supprimer en exécutant la commande suivante dans le terminal :rm -rf crx-quickstart/launchpad/startup
Le fichier base.jar: find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \
Le Fichier BootstrapCommandFile_timestamp.txt: rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
Supprimer sling.options.file en exécutant : find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf
Créez à présent les entrepôts de nœuds et de données qui seront utilisés avec AEM 6.5. Pour ce faire, vous devez créer deux fichiers portant les noms suivants sous crx-quickstart\install
:
org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.cfg
org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.cfg
Ces deux fichiers configureront AEM de façon à ce qu’ils utilisent un entrepôt de nœuds TarMK et un entrepôt de données File.
Modifiez les fichiers de configuration pour les rendre prêts à l’emploi. Plus précisément :
Ajoutez la ligne suivante à org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config
:
customBlobStore=true
Puis, ajoutez les lignes suivantes à org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config
:
path=./crx-quickstart/repository/datastore
minRecordLength=4096
Vous pouvez maintenant modifier les modes d’exécution du fichier war d’AEM 6.5. Pour ce faire, créez tout d’abord un dossier temporaire qui héberge le fichier war d’AEM 6.5. Le nom du dossier dans cet exemple est temp
. Une fois le fichier war copié, extrayez son contenu en exécutant la commande suivante depuis le dossier temp :
jar xvf aem-quickstart-6.5.0.war
Une fois le contenu extrait, accédez au dossier WEB-INF et modifiez le fichier web.xml afin de modifier les modes d’exécution. Pour trouver l’emplacement où ils sont définis dans le fichier XML, recherchez la chaîne sling.run.modes
. Une fois que vous l’avez trouvée, définissez les modes d’exécution sur la ligne de code suivante qui, par défaut, est définie sur author :
<param-value >author</param-value>
Modifiez la valeur d’auteur ci-dessus et définissez les modes d’exécution sur : author,crx3,crx3tar
. Le bloc de code final doit se présenter comme suit :
<init-param>
<param-name>sling.run.modes</param-name>
<param-value>author,crx3,crx3tar</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>
Créez à nouveau le fichier jar avec les contenus modifiés :
jar cvf aem65.war
Enfin, déployez le nouveau fichier war dans TomCat.