Solución de problemas de instalación con AEM troubleshooting

Esta sección incluye información detallada sobre los registros disponibles para ayudarle a solucionar problemas, así como información sobre algunos de los problemas que puede tener con AEM.

Solucionar problemas de rendimiento de autor troubleshoot-author-performance

El análisis de un rendimiento lento en la instancia de creación puede resultar complejo. Como primer paso, es necesario averiguar en qué nivel de la pila de tecnología está disminuyendo el rendimiento.

El siguiente árbol de decisión proporciona instrucciones para reducir el cuello de botella.

Optimización básica basic-optimization

Configuración de archivos de registro y registros de auditoría configuring-log-files-and-audit-logs

AEM registra los registros detallados que es posible que desee configurar para solucionar los problemas de instalación. Para obtener más información, vea la sección Trabajar con registros de auditoría y archivos de registro.

Uso de la opción Detallada using-the-verbose-option

Al iniciar AEM WCM, puede agregar la opción -v (detallada) a la línea de comandos como en: java -jar cq-wcm-quickstart-<version>.jar -v.

La opción detallada muestra parte de la salida del registro de inicio rápido en la consola, por lo que se puede utilizar para solucionar problemas.

Problemas comunes de instalación common-installation-issues

En la siguiente sección se describen algunos problemas de instalación y sus soluciones.

Al hacer doble clic en Quickstart jar no se producirá ningún efecto o se abrirá el archivo jar con otro programa (por ejemplo, archive manager) double-clicking-the-quickstart-jar-does-not-have-any-effect-or-opens-the-jar-file-with-another-program-for-example-archive-manager

Este problema normalmente indica un problema con la forma en que el entorno de escritorio de su sistema operativo está configurado para abrir los archivos con la extensión .jar. También puede indicar que no tiene Java™ instalado o que está utilizando una versión incompatible de Java™.

Como los archivos jar utilizan el omnipresente formato ZIP, algunos de los programas de archivado pueden configurar automáticamente el escritorio para abrir archivos jar como archivos de archivado.

Para solucionar problemas, haga lo siguiente:

Mi aplicación que se ejecuta en CRX genera errores de memoria insuficiente my-application-running-on-crx-throws-out-of-memory-errors

El propio CRX tiene un espacio de memoria bajo. Si la aplicación que se ejecuta en CRX tiene requisitos de memoria mayores o solicita operaciones con gran cantidad de memoria (por ejemplo, transacciones grandes), la instancia de JVM en la que se ejecuta CRX debe iniciarse con la configuración de memoria adecuada.

Utilice las opciones de comandos de Java™ para definir la configuración de memoria de JVM (por ejemplo, java -Xmx512m -jar crx*.jar para establecer el tamaño de pila en 512 MB).

Especifique la opción de configuración de memoria al iniciar AEM WCM desde la línea de comandos. Los scripts de inicio y parada de WCM de AEM o los scripts personalizados para administrar el inicio de WCM de AEM también se pueden modificar para definir la configuración de memoria necesaria.

Si ya ha definido el tamaño de la pila en 512 MB, puede que desee analizar más el problema de memoria creando un volcado.

Para crear automáticamente un volcado de la pila cuando se agote la memoria, utilice el siguiente comando:

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar

Este método genera un archivo de volcado de la pila (java_…hprof) cada vez que el proceso se queda sin memoria. El proceso puede seguir ejecutándose después de que se haya generado el volcado de la pila.

A menudo, se requieren tres archivos de volcado de la pila, recopilados durante un período de tiempo, para analizar el problema:

Se pueden comparar para ver los cambios y cómo los objetos utilizan la memoria.

La pantalla de bienvenida de AEM no se muestra en el explorador después de hacer doble clic en Inicio rápido de AEM the-aem-welcome-screen-does-not-display-in-the-browser-after-double-clicking-aem-quickstart

En determinadas situaciones, las pantallas de bienvenida de AEM WCM no se muestran automáticamente aunque el repositorio en sí se esté ejecutando correctamente. Este problema puede depender de la configuración del sistema operativo, del explorador o de factores similares.

El síntoma habitual es que la ventana Inicio rápido de AEM WCM muestra "AEM WCM iniciándose, esperando al inicio del servidor"… Si ese mensaje se muestra durante un tiempo relativamente largo, introduzca manualmente la dirección URL de AEM WCM en la ventana del explorador, utilizando el puerto 4502 predeterminado o el puerto en el que se está ejecutando la instancia: http://localhost:4502/.

Además, los registros pueden revelar el motivo por el que el explorador no se inicia.

En ocasiones, la ventana Inicio rápido de AEM WCM muestra el mensaje "AEM WCM running on http://localhost:port/" y el explorador no se inicia automáticamente. En este caso, haga clic en la dirección URL en la ventana de inicio rápido de AEM WCM (es un hipervínculo) o introduzca manualmente la dirección URL en el explorador.

Si todo lo demás falla, consulte los registros para averiguar qué ha sucedido.

El sitio web no se carga o falla intermitentemente con Java™ 11 the-website-does-not-load-or-fails-intermittently-with-java11

Hay un problema conocido con AEM 6.5 en ejecución en Java™ 11 en el que el sitio web puede no cargarse o fallar intermitentemente.

Si se produce este problema, haga lo siguiente:

Solución de problemas de instalaciones con un servidor de aplicaciones troubleshooting-installations-with-an-application-server

Página no encontrada devuelta al solicitar una página de geometrixx-outdoor page-not-found-returned-when-requesting-a-geometrixx-outdoor-page

Se aplica a WebLogic 10.3.5 y JBoss® 5.1

Cuando una solicitud a la página geometrixx-outdoors/es devuelve un error 404 (página no encontrada), puede volver a comprobar que ha establecido la propiedad sling adicional en el archivo sling.properties necesario para estos servidores de aplicaciones específicos.

Consulte los pasos de Implementar la aplicación web de AEM para obtener más información.

El tamaño del encabezado de respuesta puede ser superior a 4 KB response-header-size-can-be-greater-than-kb

Los errores 502 pueden indicar que el servidor web no puede gestionar el tamaño del encabezado de respuesta HTTP de AEM. AEM puede generar encabezados de respuesta HTTP que incluyan cookies de tamaño superior a 4 KB. Asegúrese de que el contenedor del servlet esté configurado para que el tamaño máximo del encabezado de respuesta pueda superar los 4 KB.

Por ejemplo, para Tomcat 7.0, el atributo maxHttpHeaderSize del conector HTTP controla las limitaciones en el tamaño del encabezado.

Desinstalación de Adobe Experience Manager uninstalling-adobe-experience-manager

Como AEM se instala en un solo directorio, no es necesario desinstalar ninguna utilidad. La desinstalación puede ser tan sencilla como eliminar todo el directorio de instalación, aunque la forma de desinstalar AEM depende de lo que desee lograr y del almacenamiento persistente que utilice.

Si el almacenamiento persistente está incrustado en el directorio de instalación, por ejemplo, en la instalación predeterminada de TarPM, al eliminar carpetas también se eliminan datos.

Si la instalación de AEM utiliza almacenamiento externo, por ejemplo, un servidor de base de datos, al eliminar la carpeta no se eliminan los datos automáticamente, pero sí la configuración de almacenamiento, lo que dificulta la restauración del contenido JCR.