¿AEM web server no arranca? Reinicialo

Hace unos días me pasó que para resetear unas cachés de un servicio, tenía que reiniciar el web server Jetty de AEM. Normalmente en circunstancias como esta, hubiese sido mejor reiniciar el servidor y déjarse de rollos, pero no tenía acceso ssh por consola a la máquina remota y era la única forma. En cualquier caso, e independientemente de como hayas llegado a esta situación, este post te ayudará a salir del apuro si el AEM web server no arranca.

¿Qué ocurre si paras el bundle de Jetty?

Resulta que vas a la vista de bundles de la web console Apache Felix OSGi y paras el bundle de Jetty. Pues bien, que sepas que sin web server:

¡No hay web admin console! Suena obvio, pero si el web server está apagado no hay nadie que se encargue de servirte la consola de administración web ni ninguna interfaz web.
Aquí ya da igual que reinicies o no, ahórrate el tiempo porque si decides parar un bundle, cuando reinicies seguirá parado. Esto con el resto de bundles no es un problema, pero con el web server podrás pensar… ¿Y ahora cómo arreglo esto?

Apache Felix + Gogo al rescate

OK, no tenemos acceso a la consola de administración web, pero la plataforma OSGi Apache Felix sigue funcionando, lo único que ocurre, es que el bundle de Jetty no arranca. Aquí es cuando recordé, que un día trasteando con la documentación de Apache Felix, me encontré con Apache Gogo.

Apache Gogo es una shell para entornos basados en OSGi, que nos permitirá acceder y controlar Apache Felix por línea de comandos.

Estrategia

Nuestra estrategia consistirá en instalar Apache Gogo, acceder a OSGi por línea de comandos y reiniciar el bundle del servicio HTTP parado.

Instalación de Apache Gogo

Para instalar Apache Gogo haremos lo siguiente:

Descarga los siguientes módulos de Gogo:
1. Command: implementa un conjunto de comandos.
2. Runtime: implementa el entorno de proceso de comandos.
3. Shell: proporciona la interfaz para interactuar por línea de comandos.
Copia estos bundles en la carpeta crx-quickstart/install para que sean instalados automáticamente.
Descarga el bundle Remote Shell de Apache Felix y cópialo en la carpeta crx-quickstart/install.

Apache Gogo – OSGi en el shell

Una vez que ya tenemos instalado Gogo vamos a reiniciar el bundle de Jetty por línea de comandos.

Abre un shell o terminal e introduce telnet localhost 6666. Por defecto Gogo estará escuchando en el puerto 6666. El resultado será algo similar a lo que puedes ver a continuación. Lo importante es que el símbolo del Shell de Gogo g! nos aparezca para poder introducir comandos.

$ telnet localhost 6666

Trying ::1...

telnet: connect to address ::1: Connection refused

Trying 127.0.0.1...

Connected to localhost.

Escape character is '^]'.

____________________________

Welcome to Apache Felix Gogo

Introduce el comando lb http o lb jetty para que liste los bundles relacionados con http

g! lb http

START LEVEL 30

ID|State |Level|Name

27|Active | 5|Apache Felix Http Api (2.3.0.R1570612)

28|Resolved | 5|Apache Felix Http Jetty (2.3.0.R1579739)

29|Active | 5|Apache Felix Servlet API (0.0.1.R1570612)

30|Active | 5|Apache Felix Http Whiteboard (2.2.1.R1239578)

52|Active | 9|Apache Felix Http SSL Filter (0.0.1.R1394715)

137|Active | 20|Adobe Granite HTTP Cache - Core Bundle (1.0.0)

166|Active | 20|Day Commons Library - HTTP Client 3.1 Bundling (3.1.0.018)

396|Active | 20|Apache Felix Http SSL Filter (0.1.0)

Aquí podemos ver que el bundle de Apache Felix Http Jetty está parado (resolved), también vemos que su número de bundle es el 28, por lo cual ejecutaremos el siguiente comando para arrancarlo:

Shell

1

g! start 28

Para comprobar si Jetty ha vuelto a la vida ejecutaremos de nuevo lb http.