Instalación del servidor de aplicaciones application-server-install

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.
NOTE
JAR y WAR son los tipos de archivo en los que AEM se libera. Estos formatos están sometidos a un control de calidad para adaptarse a los niveles de soporte que el Adobe se ha comprometido a cumplir.

En esta sección se explica cómo instalar Adobe Experience Manager (AEM) con un servidor de aplicaciones. Consulte la Plataformas compatibles para ver los niveles de soporte específicos proporcionados para los servidores de aplicaciones individuales.

Se describen los pasos de instalación de los siguientes servidores de aplicaciones:

Consulte la documentación apropiada del servidor de aplicaciones para obtener más información sobre la instalación de aplicaciones web, configuraciones de servidor y cómo iniciar y detener el servidor.

NOTE
Si utiliza Dynamic Media en una implementación WAR, consulte la documentación de dynamic media.

Descripción general general-description

Comportamiento predeterminado al instalar AEM en un servidor de aplicaciones default-behaviour-when-installing-aem-in-an-application-server

AEM se presenta como un único archivo de guerra que se va a desplegar.

Si se implementa, sucederá lo siguiente de forma predeterminada:

  • el modo de ejecución es author

  • la instancia (Repositorio, entorno Felix OSGI, paquetes, etc.) está instalado en ${user.dir}/crx-quickstartdonde ${user.dir} es el directorio de trabajo actual, esta ruta a crx-quickstart se llama sling.home

  • la raíz del contexto es el nombre del archivo war, por ejemplo: aem-6

Configuración configuration

Puede cambiar el comportamiento predeterminado de la siguiente manera:

  • modo de ejecución : configure el sling.run.modes en el WEB-INF/web.xml archivo del archivo de guerra de AEM antes de la implementación

  • sling.home: configure el sling.home en el WEB-INF/web.xmlarchivo del archivo de guerra de AEM antes de la implementación

  • raíz de contexto: cambiar el nombre del archivo de guerra de AEM

Publicar instalación publish-installation

Para implementar una instancia de publicación, debe establecer el modo de ejecución para publicar:

  • Desempaquete el WEB-INF/web.xml del archivo de guerra de AEM
  • Cambiar el parámetro sling.run.modes a publicar
  • Reempaquete el archivo web.xml en AEM archivo war
  • Implementar AEM archivo war

Comprobación de la instalación installation-check

Para comprobar si todo está instalado, puede:

  • cola error.logpara ver que todo el contenido está instalado
  • mirar en /system/console que todos los paquetes están instalados

Dos instancias en el mismo servidor de aplicaciones two-instances-on-the-same-application-server

Para fines de demostración, puede ser apropiado instalar la instancia de autor y publicación en un servidor de aplicaciones. Para ello, haga lo siguiente:

  1. Cambie las variables sling.home y sling.run.modes de la instancia de publicación.
  2. Desempaquete el archivo WEB-INF/web.xml del archivo war AEM.
  3. Cambie el parámetro sling.home a una ruta diferente (las rutas absolutas y relativas son posibles).
  4. Cambie sling.run.modes para publicar para la instancia de publicación.
  5. Vuelva a empaquetar el archivo web.xml.
  6. Cambie el nombre de los archivos de guerra, de modo que tengan nombres diferentes: Por ejemplo, un nombre a aemauthor.war y otro a aempublish.war.
  7. Utilizar configuraciones de memoria más altas, por ejemplo, para instancias de AEM predeterminadas, usar, por ejemplo: -Xmx3072m
  8. Implemente las dos aplicaciones web.
  9. Después de la implementación, detenga las dos aplicaciones web.
  10. Tanto en la instancia de autor como en la de publicación, se asegura de que en los archivos sling.properties la propiedad felix.service.urlhandlers=false se establezca en false (de forma predeterminada se establece en true).
  11. Vuelva a iniciar las dos aplicaciones web.

Procedimientos de instalación de los servidores de aplicaciones application-servers-installation-procedures

WebSphere 8.5 websphere

Antes de una implementación, lea la Descripción general arriba.

Preparación del servidor

  • Permita que pasen los encabezados de autenticación básicos:

    • Una forma de permitir que AEM autenticar a un usuario es deshabilitar la seguridad administrativa global del servidor WebSphere, para hacerlo: vaya a Seguridad -> Seguridad global y desmarque la casilla Activar seguridad administrativa , guarde y reinicie el servidor.
  • set "JAVA_OPTS= -Xmx2048m"

  • Si desea instalar AEM usando context root = / entonces primero debe cambiar la raíz de contexto de la aplicación web predeterminada existente

Implementación AEM aplicación web

  • Descargar AEM archivo de guerra

  • Realice sus configuraciones en web.xml si es necesario (consulte más arriba en la Descripción general)

    • Desempaquete WEB-INF/web.xml archivo
    • cambiar el parámetro sling.run.modes a publicar
    • quite el comentario del parámetro inicial sling.home y establezca esta ruta como sea necesario
    • Volver a empaquetar el archivo web.xml
  • Implementar AEM archivo war

    • Elija una raíz de contexto (si desea establecer los modos de ejecución de Sling, debe seleccionar los pasos detallados del asistente de implementación y, a continuación, especificarlos en el paso 6 del asistente)
  • Iniciar AEM aplicación web

JBoss EAP 6.3.0/6.4.0 jboss-eap

Antes de una implementación, lea la Descripción general arriba.

Preparación del servidor JBoss

Establezca los argumentos de memoria en el archivo conf (por ejemplo, standalone.conf)

  • JAVA_OPTS="-Xms64m -Xmx2048m"

si utiliza el analizador de implementación para para instalar la aplicación web de AEM, puede que sea conveniente aumentar el deployment-timeout, para ese conjunto, deployment-timeout en el archivo xml de su instancia (p. ej. 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>

Implementación AEM aplicación web

  • Cargue la aplicación web AEM en la consola de administración de JBoss.

  • Active la aplicación web AEM.

Oracle WebLogic 12.1.3/12.2 oracle-weblogic

Antes de una implementación, lea la Descripción general arriba.

Utiliza un diseño de servidor simple con solo un servidor de administración.

Preparación del servidor WebLogic

  • En ${myDomain}/config/config.xmlagregue a la sección configuración de seguridad :

  • Aumente la configuración de memoria de VM:

    • open ${myDomain}/bin/setDomainEnv.cmd (resp.sh)busque WLS_MEM_ARGS, establezca, por ejemplo, WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • reiniciar servidor WebLogic
  • Crear en ${myDomain} una carpeta de paquetes y dentro de una carpeta cq y en ella una carpeta Plan

Implementación AEM aplicación web

  • Descargar AEM archivo de guerra

  • Coloque el archivo de guerra AEM en la carpeta ${myDomain}/packages/cq

  • Realice las configuraciones en WEB-INF/web.xml si es necesario (véase más arriba en la descripción general)

    • Desempaquete WEB-INF/web.xmlfile
    • cambiar el parámetro sling.run.modes a publicar
    • quite el comentario del parámetro inicial sling.home y establezca esta ruta como sea necesario (consulte Descripción general)
    • Volver a empaquetar el archivo web.xml
  • Implementar AEM archivo war como una aplicación (para el resto de configuraciones, utilice la configuración predeterminada)

  • La instalación puede llevar tiempo…

  • Compruebe que la instalación ha finalizado como se mencionó anteriormente en la Descripción general (por ejemplo, al seguir el archivo error.log)

  • Puede cambiar la raíz de contexto en la pestaña Configuración de la aplicación web en WebLogic /console

Tomcat 8/8.5 tomcat

Antes de una implementación, lea la Descripción general arriba.

  • Preparar el servidor Tomcat

    • Aumente la configuración de memoria de VM:

      • En bin/catalina.bat (resp catalina.sh en unix) agregue la siguiente configuración:
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat no permite acceso de administrador ni de administrador en la instalación. Por lo tanto, debe editar manualmente tomcat-users.xml para permitir el acceso a estas cuentas:

      • Editar tomcat-users.xml para incluir el acceso para el administrador y el administrador. La configuración debe ser similar al siguiente ejemplo:
      code language-xml
        <?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 desea implementar AEM con la raíz de contexto "/", debe cambiar la raíz de contexto de la aplicación web ROOT existente:

      • Detener y cancelar la implementación de la aplicación web ROOT
      • Cambie el nombre de la carpeta ROOT.war en la carpeta webapps de tomcat.
      • Inicie webapp de nuevo
    • Si instala la aplicación web AEM utilizando el administrador-gui, debe aumentar el tamaño máximo de un archivo cargado, ya que el tamaño predeterminado solo permite un tamaño de carga de 50 MB. Para que se abra el web.xml de la aplicación web del administrador,

      webapps/manager/WEB-INF/web.xml

      y aumente el tamaño máximo del archivo y el tamaño máximo de la solicitud a al menos 500 MB, consulte lo siguiente multipart-config ejemplo de una web.xml archivo:

      code language-none
      <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>
      
  • Implementación AEM aplicación web

    • Descargar AEM archivo de guerra

    • Realice sus configuraciones en web.xml si es necesario (consulte más arriba en la Descripción general)

      • Desempaquete WEB-INF/web.xml archivo
      • cambiar el parámetro sling.run.modes a publicar
      • quite el comentario del parámetro inicial sling.home y establezca esta ruta como sea necesario
      • Volver a empaquetar el archivo web.xml
    • Cambie el nombre AEM archivo war a ROOT.war si desea implementarlo como webapp raíz, cámbielo por ejemplo aemauthor.war si desea tener aemauthor como raíz de contexto

    • cópielo en la carpeta webapps de tomcat.

    • espera hasta que AEM esté instalado

Solución de problemas troubleshooting

Para obtener información sobre cómo tratar los problemas que pueden surgir durante la instalación, consulte:

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56