Instalación del servidor de aplicaciones

En esta sección se explica cómo instalar Adobe Experience Manager (AEM) con un servidor de aplicaciones. Consulte la sección Plataformas admitidas 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:

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

Consulte la documentación del servidor de aplicaciones correspondiente para obtener más información sobre la instalación de aplicaciones Web, configuraciones de servidor y cómo realizar el inicio y detener el servidor.

Descripción general

Comportamiento predeterminado al instalar AEM en un servidor de aplicaciones

AEM viene como un único archivo de guerra para desplegar.

Si se implementa lo siguiente sucederá de forma predeterminada:

• el modo de ejecución es author

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

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

Configuración

Puede cambiar el comportamiento predeterminado de la siguiente manera:

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

• sling.home: configure el parámetro sling.home en el archivo WEB-INF/web.xmldel archivo de guerra de AEM antes de la implementación

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

Instalación de publicación

Para implementar una instancia de publicación, debe definir el modo de ejecución para la publicación:

• Desempaquetar el WEB-INF/web.xml del archivo de guerra de AEM
• Cambiar el parámetro sling.run.mode para publicar
• Volver a empaquetar el archivo web.xml en AEM archivo de guerra
• Implementar AEM archivo de guerra

Comprobación de la instalación

Para comprobar si todo está instalado, puede:

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

Dos instancias en el mismo servidor de aplicaciones

A efectos de demostración, puede ser adecuado instalar la instancia de creación y publicación en un servidor de aplicaciones. Para ello, haga lo siguiente:

1. Cambie las variables sling.home y sling.run.mode de la instancia de publicación.
2. Descomprima el archivo WEB-INF/web.xml del archivo de guerra de AEM.
3. Cambie el parámetro sling.home a una ruta diferente (se pueden usar rutas absolutas y relativas).
4. Cambie sling.run.mode para publicar en la instancia de publicación.
5. Vuelva a empaquetar el archivo web.xml.
6. Cambie el nombre de los archivos de guerra para que tengan nombres diferentes: Por ejemplo, un nombre para aemauthor.war y otro para aempublish.war.
7. Utilice una configuración de memoria más alta, por ejemplo para las instancias de AEM predeterminadas, utilice, por ejemplo: -Xmx3072m
8. Implementar las dos aplicaciones web.
9. Después de la implementación, detenga las dos aplicaciones web.
10. Tanto en el caso de autor como en el de publicación se garantiza que en los archivos sling.properties la propiedad felix.service.urlhandlers=false se establece en false (el valor predeterminado es que se establece en true).
11. Vuelva a poner en inicio las dos aplicaciones web.

Procedimientos de instalación de los servidores de aplicaciones

WebSphere 8.5

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

Preparación del servidor

• Permita el paso de los encabezados de autenticación básicos:

  • Una manera de permitir que AEM autentique a un usuario es deshabilitar la seguridad administrativa global del servidor WebSphere, para ello: vaya a Seguridad -> Seguridad global y desmarque la casilla Activar seguridad administrativa, guarde y reinicie el servidor.

• configurar "JAVA_OPTS= -Xmx2048m"

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

Implementar AEM aplicación web

• Descargar AEM archivo de guerra

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

  • Desempaquetar WEB-INF/web.xml archivo
  • cambie el parámetro sling.run.mode para publicar
  • uncomment sling.home, parámetro inicial y establezca esta ruta como lo necesite
  • Volver a empaquetar archivo web.xml

• Implementar AEM archivo de guerra

  • 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 luego especificarlos en el paso 6 del asistente)

• Inicio AEM aplicación Web

EAP de JBoss 6.3.0/6.4.0

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

Preparar el servidor JBoss

Configure los argumentos de la memoria en el archivo conf (p. ej. standalone.conf)

• JAVA_OPTS="-Xms64m -Xmx2048m"

si utiliza el analizador de implementación para instalar la aplicación Web AEM, puede que sea conveniente aumentar el atributo deployment-timeout, para ese conjunto de atributos deployment-timeout en el archivo xml de la instancia (por ejemplo, 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>

Implementar AEM aplicación web

• Cargue la aplicación Web AEM en la Consola de administración de JBoss.

• Habilite la aplicación Web AEM.

Oracle WebLogic 12.1.3/12.2

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

Utiliza un diseño de servidor sencillo con un servidor de administración único.

Preparación del servidor WebLogic

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

  • <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> consulte en https://xmlns.oracle.com/weblogic/domain/1.0/domain. xsdpara ver la posición correcta (de forma predeterminada, la posición al final de la sección es correcta)

• Aumentar la configuración de memoria de VM:

  • abrir ${myDomain}/bin/setDomainEnv.cmd (resp.sh)buscar WLS_MEM_ARGS, establecer por ejemplo WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • reiniciar WebLogic Server

• Cree en ${myDomain} una carpeta de paquetes y dentro de una carpeta cq y en ella una carpeta Plan

Implementar AEM aplicación web

• Descargar AEM archivo de guerra

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

• Realice sus configuraciones en WEB-INF/web.xml si es necesario (consulte arriba en la Descripción general)

  • Desempaquetar WEB-INF/web.xmlarchivo
  • cambie el parámetro sling.run.mode para publicar
  • dejar de comentar el parámetro inicial sling.home y establecer esta ruta como sea necesario (consulte Descripción general)
  • Volver a empaquetar archivo web.xml

• Implementar AEM archivo de guerra como una aplicación (para el resto de configuraciones, use 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 (p. ej., cambiando el error.log)

• Puede cambiar la raíz de contexto en la ficha Configuración de la aplicación Web en WebLogic /console

Tomcat 8/8.5

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

• Preparar el servidor Tomcat

  • Aumentar 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 el acceso de administrador ni administrador durante la instalación. Por lo tanto, debe editar tomcat-users.xml manualmente para permitir el acceso a estas cuentas:

    • Edite tomcat-users.xml para incluir el acceso de administrador y administrador. La configuración debe tener un aspecto similar al siguiente ejemplo:

      <?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 anular la implementación de la aplicación web ROOT
    • Cambiar el nombre de la carpeta ROOT.war en la carpeta webapps de tomcat
    • aplicación web de inicio de nuevo

  • Si instala la aplicación web AEM con el manager-gui, deberá aumentar el tamaño máximo de un archivo cargado, ya que el valor predeterminado solo permite un tamaño de carga de 50 MB. Para ello, abra el archivo web.xml de la aplicación web del administrador,

    webapps/manager/WEB-INF/web.xml

    y aumente el tamaño máximo de archivo y el tamaño máximo de solicitud a al menos 500 MB, consulte el siguiente ejemplo multipart-config de un archivo web.xml de este tipo.

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

• Implementar AEM aplicación web

  • Descargar AEM archivo de guerra

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

    • Desempaquetar WEB-INF/web.xml archivo
    • cambie el parámetro sling.run.mode para publicar
    • uncomment sling.home, parámetro inicial y establezca esta ruta como lo necesite
    • Volver a empaquetar archivo web.xml

  • Cambie AEM archivo de guerra a ROOT.war si desea implementarlo como aplicación web raíz, cambie el nombre a aemauthor.war si desea que aemauthor sea context root

  • copiarlo en la carpeta de aplicaciones web de tomcat

  • esperar hasta que AEM instalado

Solución de problemas

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

• Solución de problemas