Show Menu
TEMAS×

Solución de problemas

Esta sección incluye información detallada sobre los registros disponibles para ayudarle a solucionar problemas y también incluye información sobre algunos de los problemas que podría encontrar con AEM.

Resolución de problemas de rendimiento del autor

Analizar el rendimiento lento en la instancia de creación puede resultar bastante complejo. Como primer paso, es necesario averiguar en qué nivel de pila de tecnología disminuye el rendimiento.
El siguiente árbol de decisión proporciona orientación para reducir el cuello de botella.

Optimización básica

Configuración de archivos de registro y registros de auditoría

AEM registra registros detallados que puede que desee configurar para solucionar problemas de instalación. Para obtener más información, consulte la sección Trabajo con registros de auditoría y archivos de registro.

Uso de la opción Verbose

Al iniciar AEM WCM, puede agregar la opción -v (detallado) a la línea de comandos como en: java -jar cq-wcm-quickstart-<version>.jar -v.
La opción "verbose" muestra algunos de los resultados del registro de inicio rápido en la consola, para que se puedan utilizar en la resolución de problemas.

Problemas comunes de instalación

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

Al hacer doble clic en el frasco de inicio rápido no se produce ningún efecto o se abre el archivo jar con otro programa (por ejemplo, el administrador de archivos)

Esto suele indicar un problema con la configuración del entorno de escritorio del sistema operativo para abrir archivos con la extensión .jar. También puede indicar que no tiene Java instalado o que está utilizando una versión no compatible de Java.
Dado que los archivos jar utilizan el formato ZIP omnipresente, algunos de los programas de archivado pueden configurar automáticamente el escritorio para abrir archivos jar como archivos de archivo.
Para solucionar problemas, haga lo siguiente:
  • Compruebe que tiene al menos Java versión 1.6 instalada.
  • Pruebe un menú contextual (generalmente con el botón secundario del mouse) en el inicio rápido de AEM WCM y seleccione "Abrir con...."
  • Compruebe si Java o Sun Java están en la lista e intente ejecutar AEM WCM con él. Si tiene varias versiones de Java instaladas, seleccione la admitida.
    Si tiene éxito con este paso, y sus sistemas operativos ofrecen una opción para utilizar siempre el programa seleccionado para ejecutar los archivos .jar, selecciónelo. Hacer doble clic debería funcionar a partir de ahora.
  • A veces, la reinstalación de la versión de Java admitida ayuda a restaurar la asociación correcta.
  • Siempre puede ejecutar CRX mediante la línea de comandos o las secuencias de comandos start/stop como se describe anteriormente en este documento.

Mi aplicación que se ejecuta en CRX genera errores de memoria insuficiente

Consulte también Analizar problemas de memoria.
El propio CRX tiene una huella de memoria muy baja. Si la aplicación que se ejecuta dentro de 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 comando de Java para definir la configuración de memoria de JVM (por ejemplo, java -Xmx512m -jar crx&ast;.jar para establecer el tamaño máximo en 512MB).
Especifique la opción de configuración de memoria al iniciar AEM WCM desde la línea de comandos. Los scripts de inicio/parada de AEM WCM o los scripts personalizados para administrar el inicio de AEM WCM también se pueden modificar para definir la configuración de memoria necesaria.
Si ya ha definido su tamaño de pila en 512 MB, puede que desee analizar el problema de la memoria creando un volcado de pila:
Para crear automáticamente un volcado de pila al agotarse la memoria, utilice el siguiente comando:
java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.jar
Esto genera un archivo de volcado de pila ( java_...hprof ) siempre que el proceso se quede sin memoria. El proceso puede continuar ejecutándose después de que se generara el volcado de pila. Normalmente, un archivo de volcado de pila es suficiente para analizar el problema.

La pantalla de bienvenida de AEM no se muestra en el navegador después de hacer doble clic en el inicio rápido de AEM

En determinadas situaciones, las pantallas de bienvenida de AEM WCM no se muestran automáticamente aunque el repositorio se esté ejecutando correctamente. Esto puede depender de la configuración del sistema operativo, de la configuración del explorador o de factores similares.
El síntoma habitual es que la ventana de inicio rápido de AEM WCM muestra "AEM WCM en inicio, esperando el inicio del servidor...." Si ese mensaje se muestra durante un tiempo relativamente largo, introduzca la URL de AEM WCM en la ventana del navegador de forma manual, utilizando el puerto predeterminado 4502 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 de inicio rápido de AEM WCM tiene el mensaje "AEM WCM se ejecuta en http://localhost:port/" y el navegador no se inicia automáticamente. En este caso, haga clic en la URL en la ventana de inicio rápido de AEM WCM (es un hipervínculo) o introduzca manualmente la URL en el navegador.
Si todo lo demás falla, compruebe los registros para averiguar qué ha pasado.

Resolución de problemas de instalación con un servidor de aplicaciones

Página no encontrada devuelta al solicitar una página de geometrixx-exterior

Se aplica a WebLogic 10.3.5 y JBoss 5.1
Cuando una solicitud a la página geometrixx-outdoors/en devuelve un valor 404 (Página no encontrada), puede volver a comprobar que ha establecido la propiedad sling adicional en el archivo sling.properties necesaria para estos servidores de aplicaciones específicos.
Consulte los detalles en los pasos de Implementación de la aplicación web AEM.

El tamaño del encabezado de respuesta puede ser mayor que 4 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 de 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.html HTTP controla las limitaciones del tamaño del encabezado.

Uninstalling Adobe Experience Manager

Debido a que AEM se instala en un único directorio, no es necesario disponer de una utilidad de desinstalación. La desinstalación puede ser tan simple como eliminar todo el directorio de instalación, aunque la forma en que desinstale 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.
Adobe recomienda realizar una copia de seguridad del repositorio antes de eliminar AEM. Si elimina todo el <cq-installation-directory>, eliminará el repositorio. Para conservar los datos del repositorio antes de eliminarlos, mueva o copie la carpeta <cq-installation-directory>/crx-quickstart/repository antes de eliminar las otras carpetas.
Si la instalación de AEM utiliza almacenamiento externo, por ejemplo, un servidor de bases de datos, la eliminación de carpetas no elimina los datos automáticamente, pero sí elimina la configuración de almacenamiento, lo que dificulta la restauración del contenido de JCR.

Los archivos JSP no se compilan en JBoss

Si instala o actualiza archivos JSP a Experience Manager en JBoss y no se compilan los servlets correspondientes, asegúrese de que el compilador JBoss JSP esté correctamente configurado. Para obtener más información, consulte el artículo Problemas de compilación del JSP en JBoss .