Procédure de mise à niveau pour les installations de serveur d’applications

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.

1. D'abord, démarrez TomCat. Dans la plupart des cas, vous pouvez effectuer cette opération en exécutant le script de démarrage ./catalina.sh en exécutant cette commande à partir du terminal :

   $CATALINA_HOME/bin/catalina.sh start
   

2. 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
   

3. Ensuite, annulez le déploiement d’AEM 6.4. Pour ce faire, utilisez le gestionnaire d’applications TomCat (http://serveraddress:serverport/manager/html).

4. 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
   

5. Supprimez les propriétés requises du fichier sling.properties en procédant comme suit :

   1. Ouvrez le fichier situé à l’emplacement crx-quickstart/launchpad/sling.properties.

   2. Supprimez les propriétés suivantes et enregistrez le fichier :

      1. sling.installer.dir

      2. felix.cm.dir

      3. granite.product.version

      4. org.osgi.framework.system.packages

      5. osgi-core-packages

      6. osgi-compendium-services

      7. jre-*

      8. sling.run.mode.install.options

6. 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 {} \

   • Fichier BootstrapCommandFile_timestamp.txt : rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

   • Supprimez sling.options.file en exécutant : find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf

7. 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.

8. 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
     

9. 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
   

10. 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>
    

11. 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>
    

12. Créez à nouveau le fichier jar avec les contenus modifiés :

    jar cvf aem65.war
    

13. Enfin, déployez le nouveau fichier war dans TomCat.