DocumentationAEM 6.5Guide de l’utilisateur

Procédure de mise à niveau pour les installations de serveur d’applications upgrade-steps-for-application-server-installations

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Administration

Cette section décrit la procédure à suivre pour mettre à jour AEM pour les installations de serveur d’applications.

Tous les exemples de cette procédure utilisent Tomcat comme serveur d’applications et présument que vous disposez d’une version de travail 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 le faire en exécutant le script de démarrage ./catalina.sh, en exécutant cette commande à partir du terminal :

    code language-shell 
    $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 à :

    code language-shell 
    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. À présent, 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.

    code language-shell 
    SLING_HOME= $AEM-HOME/crx-quickstart java -Xmx4096m -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 les dossiers qui ne sont plus nécessaires. Les éléments à supprimer sont les 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

    • 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 magasins de nœuds et de données qui sont 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 pour qu’il utilise un magasin de nœuds TarMK et un magasin de données de fichiers.

  8. Modifiez les fichiers de configuration pour qu’ils soient 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 :

      code language-none 
      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ébergera 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 :

    code language-none 
    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 :

    code language-bash 
    <param-value >author</param-value>

  11. Modifiez la valeur author ci-dessus et définissez les modes d’exécution sur : author,crx3,crx3tar. Le bloc de code final devrait ressembler à ceci :

    code language-none 
    <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 :

    code language-bash 
    jar cvf aem65.war

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2