JAR
et WAR
sont les types de fichiers dans lesquels AEM est publié. Ces formats font l’objet d’une assurance qualité afin d’offrir les niveaux d’assistance qu’Adobe s’est engagé à fournir.
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 :
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é.
Si vous utilisez Dynamic Media dans un déploiement WAR, consultez la documentation de Dynamic Media.
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-quickstart
où ${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 de guerre, par exemple : aem-6
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.home
sling.home dans le fichier WEB-INF/web.xml
du fichier war AEM avant le déploiement.
racine du contexte : renommez le fichier war AEM.
Pour qu’une instance de publication soit déployée, vous devez définir le mode d’exécution sur publish :
Pour vérifier que tous les éléments ont été installés, vous pouvez :
error.log
jusqu’à la fin pour vous assurer que tout le contenu est installé ;/system/console
que tous les lots sont installés.À 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 :
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 :
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éployez le fichier war AEM.
Démarrez l’application web AEM.
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 (ex. standalone.conf
)
si vous utilisez l'analyseur de déploiement pour installer l'application Web AEM, il peut être utile d'augmenter l'attribut deployment-timeout,
pour ce jeu d'attributs deployment-timeout
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.
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.xml
ajouter à 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 :
${myDomain}/bin/setDomainEnv.cmd
(resp .sh) recherchez WLS_MEM_ARGS, définissez par exemple set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
Créer dans ${myDomain}
un dossier de packages et dans un dossier cq et y créer un dossier Plan
Déploiement de l’application web AEM
Téléchargez le fichier war AEM.
Placez le fichier d'AEM guerre 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).
WEB-INF/web.xml
fichierDé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 de contexte dans l’onglet Configuration de l’application Web dans WebLogic /console
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 :
bin/catalina.bat
(resp catalina.sh
sur 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 :
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 :
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).
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.
Pour plus d’informations sur la résolution des problèmes qui peuvent survenir en cours d’installation, voir :