Installation du serveur d’applications

Cette section vous explique comment installer Adobe Experience Manager (AEM) avec un serveur d’applications. Consultez la section Plates-formes prises en charge pour afficher les niveaux de prise en charge relatifs aux différents serveurs d’applications.

La procédure d’installation est décrite pour les serveurs d’applications suivants :

• /WebSphere 8.5
• JBoss EAP 6.3.0/6.4.0
• Oracle WebLogic 12.1.3/12.2
• Tomcat 8/8.5

Pour plus d’informations sur l’installation d’applications web, sur les configurations serveur et sur le démarrage et l’arrêt du serveur, consultez la documentation du serveur d’applications approprié.

Description générale

Comportement par défaut lors de l’installation d’AEM dans un serveur d’applications

AEM se présente sous la forme d’un seul fichier war à déployer.

En cas de déploiement, le comportement par défaut est le suivant :

• le mode d’exécution est author

• l’instance (référentiel, environnement Felix OSGI, lots, etc.) est installé dans ${user.dir}/crx-quickstartoù ${user.dir} est le répertoire de travail actuel, ce chemin d’accès à crx-quickstart est appelé sling.home

• la racine du contexte est le nom du fichier war, par exemple : aem-6

Configuration

Vous pouvez changer le comportement par défaut comme suit :

• mode d’exécution : configurez le paramètre sling.run.modes dans le fichier WEB-INF/web.xml du fichier war AEM avant le déploiement.

• : configurez le paramètre sling.homesling.home dans le fichier WEB-INF/web.xml du fichier war AEM avant le déploiement.

• racine du contexte : renommez le fichier war AEM.

Installation de l’instance de publication

Pour qu’une instance de publication soit déployée, vous devez définir le mode d’exécution sur publish :

• Décompressez le fichier WEB-INF/web.xml à partir du fichier war AEM.
• Définissez le paramètre sling.run.modes sur publish.
• Recompressez le fichier web.xml dans le fichier war AEM.
• Déployez le fichier war AEM.

Vérification de l’installation

Pour vérifier que tous les éléments ont été installés, vous pouvez :

• parcourir le fichier error.log jusqu’à la fin pour vous assurer que tout le contenu est installé ;
• Vérifiez dans /system/console que tous les lots sont installés.

Deux instances sur le même serveur d’applications

À des fins de démonstration, il peut s’avérer utile d’installer les instances de création et de publication sur un seul serveur d’applications. Pour ce faire, procédez comme suit :

1. Modifiez les variables sling.home et sling.run.modes de l’instance de publication.
2. Décompressez le fichier WEB-INF/web.xml du fichier war AEM.
3. Définissez le paramètre sling.home sur un autre chemin d’accès (les chemins d’accès absolus et relatifs sont possibles).
4. Modifiez sling.run.modes pour publier pour l’instance de publication.
5. Recompressez le fichier web.xml.
6. Renommez les fichiers war afin qu’ils portent des noms différents : Par exemple, renommez-le aemauthor.war et renommez-le aempublish.war.
7. Utilisez des paramètres de mémoire plus élevés, par exemple pour les instances d’AEM par défaut, utilisez par exemple : -Xmx3072m
8. Déployez les deux applications web.
9. Une fois le déploiement effectué, arrêtez les deux applications web.
10. Dans les instances de création et de publication, assurez-vous que la propriété felix.service.urlhandlers=false est définie dans les fichiers sling.properties (par défaut, elle est définie sur true).
11. Redémarrez les deux applications web.

Procédures d’installation des serveurs d’applications

/WebSphere 8.5

Avant de procéder à un déploiement, lisez la Description générale ci-dessus.

Préparation du serveur

• Laissez passer les en-têtes d’authentification de base :

  • Pour laisser à AEM le soin d’authentifier un utilisateur, une méthode consiste à désactiver la sécurité d’administration globale du serveur WebSphere. Pour ce faire, accédez à Sécurity > Global Security et désactivez la case à cocher « Enable administrative security », enregistrez et redémarrez le serveur.

• set "JAVA_OPTS= -Xmx2048m"

• Si vous souhaitez installer AEM à l’aide de la racine du contexte = /, vous devez tout d’abord modifier la racine de contexte de l’application web par défaut existante.

Déploiement de l’application web AEM

• Téléchargez le fichier war AEM.

• Au besoin, effectuez vos configurations dans le fichier web.xml (voir ci-dessus, sous Description générale).

  • Décompressez le fichier WEB-INF/web.xml
  • Modifiez le paramètre sling.run.modes pour publier
  • décommentez le paramètre initial sling.home et définissez ce chemin selon vos besoins.
  • Réparation du fichier web.xml

• Déployez le fichier war AEM.

  • Choisissez une racine de context (si vous souhaitez définir les modes d’exécution sling, vous devez sélectionner les étapes détaillées de l’assistant de déploiement, puis le spécifier à l’étape 6 de l’assistant).

• Démarrez l’application web AEM.

JBoss EAP 6.3.0/6.4.0

Avant de procéder à un déploiement, lisez la Description générale ci-dessus.

Préparation du serveur JBoss

Définissez des arguments de mémoire dans votre fichier conf (par exemple, standalone.conf)

• JAVA_OPTS="-Xms64m -Xmx2048m"

si vous utilisez le scanner de déploiement pour installer l’application web AEM, il peut être utile d’augmenter le deployment-timeout, pour que l’attribut deployment-timeout soit défini dans le fichier xml de votre instance (par exemple configuration/standalone.xml) :

<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

Déploiement de l’application web AEM

• Téléchargez l’application web AEM dans JBoss Administration Console.

• Activez l'application web AEM.

Oracle WebLogic 12.1.3/12.2

Avant de procéder à un déploiement, lisez la Description générale ci-dessus.

Dans ce cas, une simple disposition serveur est utilisée avec uniquement un serveur d’administration.

Préparation de WebLogic Server

• Dans ${myDomain}/config/config.xmlajoutez à la section security-configuration :

  • <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> voir sur https://xmlns.oracle.com/weblogic/domain/1.0/domain. xsdpour connaître la position correcte (par défaut, la position à la fin de la section est ok).

• Augmentez les paramètres mémoire de la machine virtuelle :

  • Ouvrez ${myDomain}/bin/setDomainEnv.cmd (resp.sh) recherchez WLS_MEM_ARGS, définissez par exemple WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • Redémarrez WebLogic Server

• Créez dans ${myDomain} un dossier de modules et à l’intérieur d’un dossier cq et, dans celui-ci, un dossier Plan

Déploiement de l’application web AEM

• Téléchargez le fichier war AEM.

• Placez le fichier war AEM dans le dossier ${myDomain}/packages/cq .

• Effectuez vos configurations dans WEB-INF/web.xml si nécessaire (voir ci-dessus dans la Description générale).

  • Décompressez le fichier WEB-INF/web.xml.
  • Modifiez le paramètre sling.run.modes pour publier
  • Supprimez les commentaires du paramètre initial sling.home et définissez ce chemin selon vos besoins (voir Description générale).
  • Réparation du fichier web.xml

• Déployez le fichier war AEM en tant qu’application (pour les autres paramètres, utilisez les valeurs par défaut).

• L’installation peut prendre un certain temps.

• Vérifiez que l’installation est bien terminée, comme indiqué ci-dessus dans la section Description générale (par exemple, en parcourant le fichier error.log jusqu’à la fin).

• Vous pouvez modifier la racine du contexte dans l’onglet Configuration de l’application web dans WebLogic /console

Tomcat 8/8.5

Avant de procéder à un déploiement, lisez la Description générale ci-dessus.

• Préparation du serveur Tomcat

  • Augmentez les paramètres mémoire de la machine virtuelle :

    • Dans bin/catalina.bat (resp catalina.sh sous unix), ajoutez le paramètre suivant :
    • set "JAVA_OPTS= -Xmx2048m

  • Tomcat n’active aucun accès de type administrateur ou gestionnaire au niveau de l’installation. Vous devez donc modifier manuellement le fichier tomcat-users.xml si vous souhaitez autoriser l’accès pour ces comptes :

    • Modifiez le fichier tomcat-users.xml afin d’inclure l’accès pour l’administrateur et le gestionnaire. La configuration doit être semblable à l’exemple suivant :

      <?xml version='1.0' encoding='utf-8'?>
       <tomcat-users>
       <role rolename="manager"/>
       <role rolename="tomcat"/>
       <role rolename="admin"/>
       <role rolename="role1"/>
       <role rolename="manager-gui"/>
       <user username="both" password="tomcat" roles="tomcat,role1"/>
       <user username="tomcat" password="tomcat" roles="tomcat"/>
       <user username="admin" password="admin" roles="admin,manager-gui"/>
       <user username="role1" password="tomcat" roles="role1"/>
       </tomcat-users>
    

  • Si vous souhaitez déployer AEM à l’aide de la racine du contexte « / », vous devez tout d’abord modifier la racine de contexte de l’application web ROOT existante :

    • Arrêtez et annulez le déploiement de l’application web ROOT.
    • Renommez le dossier ROOT.war dans le dossier webapps de Tomcat.
    • Redémarrez l’application web.

  • Si vous installez l’application web AEM à l’aide de l’interface utilisateur graphique du gestionnaire, vous devez augmenter la taille maximale d’un fichier chargé, étant donné que le paramètre par défaut autorise uniquement une taille de chargement de 50 Mo. Pour cela, ouvrez le fichier web.xml de l’application web manager,

    webapps/manager/WEB-INF/web.xml

    et augmentez la taille de fichier maximale et la taille de requête maximale sur une valeur d’au moins 500 Mo. Reportez-vous à l’exemple multipart-config ci-dessous d’un fichier web.xml de ce type :

    <multipart-config>
     <!-- 500MB max -->
     <max-file-size>524288000</max-file-size>
     <max-request-size>524288000</max-request-size>
     <file-size-threshold>0</file-size-threshold>
     </multipart-config>
    

• Déploiement de l’application web AEM

  • Téléchargez le fichier war AEM.

  • Au besoin, effectuez vos configurations dans le fichier web.xml (voir ci-dessus, sous Description générale).

    • Décompressez le fichier WEB-INF/web.xml
    • Modifiez le paramètre sling.run.modes pour publier
    • décommentez le paramètre initial sling.home et définissez ce chemin selon vos besoins.
    • Réparation du fichier web.xml

  • Renommez le fichier war AEM en ROOT.war si vous souhaitez effectuer un déploiement en tant qu’application web racine ; renommez-le en aemauthor.war, par exemple, si aemauthor doit être une racine de contexte.

  • Copiez-le dans le dossier webapps de Tomcat.

  • Attendez que l’application AEM soit installée.

Résolution des problèmes

Pour plus d’informations sur la résolution des problèmes qui peuvent survenir en cours d’installation, voir :

• Résolution des problèmes