Este artículo es un intento de cubrir tantas tareas administrativas que sean posibles, comunes como no tan comunes. El artículo se agrupa en cuatro secciones principales, teniendo un flujo similar a lo que encontrarías ante el uso de la Consola de Administración Geronimo, facilitándote la familiarización tanto en tareas como consola.

Este artículo esta organizado con la secciones siguientes:

• #Administrando el Servidor Apache Geronimo
  • #Elegiendo al contenedor Web (Jetty ó Tomcat)
  • #Iniciando y deteniendo al servidor
  • #Configurar el nivel de bitácora
  • #Monitoreando rendimiento
  • #Agregando nuevos oyentes (listeners) para los contenedores Web
  • #Configurando al servidor JMS
• #Configurando Servicios
  • #Agregando artefactos al repositorio Geronimo
  • #Configurando pools de bases de datos
  • #Crear una base de datos
  • #Configurando JMS
• #Administrando aplicaciones
  • #Instalando y eliminando aplicaciones
  • #Iniciando y deteniendo módulos de aplicación
• #Administrando seguridad
  • #Administrando usuarios y grupos
  • #Agregando realms de seguridad
  • #Administrando certificados
  • Configurando LDAP

Referencia adicional:

• Configurando al Datasource DB2

Administrando el Servidor Apache Geronimo

En esta sección se cubren las tareas administrativas más comunes, diarias, y relacionadas con el servidor, con las cuales te podrías topar. Secciones subsecuentes se enfocarán en la configuración de servicios, administración de aplicaciones y configuración de seguridad.

Eligiendo al contenedor Web (Jetty ó Tomcat)

Cuando descargas y construyes Apache Geronimo a partir del código fuente (proporcionado por svn), obtendrías una estructura de directorios similar a la siguiente:

• applications
• assemblies
• configs
• docs_nopublish
• etc
• modules
• openejb
• plugins
• sandbox
• xdocs

Si navegas dentro del directorio assemblies encontrarás los siguientes subdirectorios:

• j2ee-installer
• j2ee-jetty-server
• j2ee-tomcat-server

Nos enfocaremos en los dos últimos directorios que, como seguramente esperas, contienen imágenes independientes de Apache Geronimo, configuradas para usar alguno de los dos contenedores Web.

Dependiendo de que desees usar Jetty ó Tomcat, ingresarás al directorio respectivo (j2ee-jetty-server ó j2ee-tomcat-server), y la estructura interna de subdirectorios será la misma. Una vez que te encuentres dentro del directorio específico del contenedor Web, ingresa al directorio target/geronimo-1.0. Este directorio es tu servidor Apache Geronimo, independiente y totalmente completo. Podrías copiar este directorio a una ubicación distinta. A lo largo de estas series de artículos, las referencias a este directorio serán hechas con <geronimo_home>

Entonces, eligiendo al contenedor Web ya no consiste en cambiar archivos de configuración, más bien ahota es la elección de una estructura de directorio para assemblies diferentes. Dentro de esta estructura encontraras al directorio /bin; la siguiente sección explica los comandos almacenados en dicho directorio y el cómo iniciar y detener al servidor.

Regresar a la sección superior

Iniciando y deteniendo al servidor

Existen dos formas, mediante la línea de comandos, para iniciar al servidor. Desde una ventana de la línea de comandos ó una terminal, ingresa al directorio <geronimo_home>/bin. Desde ahí puedes teclear:

java -jar server.jar

ó simplemente

startup

Consulta las secciones Startup y Geronimo para obtener todas las opciones del comando en cuestión.

Para detener al servidor tendrás que abrir una nueva ventana de la línea de comandos ó una terminal, ingresar al directorio <geronimo_home>/bin y ejecutar al comando shutdown. Se te solicitará usuario (username) y contraseña (password). Consulta las secciones Shutdown y Geronimo para obtener las opciones disponibles del comando en cuestión.

Si el servidor ya se encuentra en ejecución, tienes la opción de emplear la Consola de Administración Geronimo para detenerlo (shutdown) de forma remota. Con el servidor arriba y en ejecución, abre un explorador Web e ingresa a la siguiente URL para tener acceso a la consola:

http://localhost:8080/console

Ingresa a la Consola de Administración Geronimo y haz clic en Shutdown, ubicado en el menú de Navegación de la Consola (Console Navigation), en la sección izquierda.

Al hacer clic en el botón Shutdown en el fragmento del Administrador del Servidor (Server Manager portlet), se te solicitará una o más veces la confirmación de la petición de detener al servidor. Haz clic en el botón Shutdown para confirmar y detener al servidor. No es necesario mencionar que, como consecuencia, se perderá la conexión con la Consola de Administración y necesitarás reiniciar al servidor desde una terminal ó desde una ventana de línea de comandos para retomar la conexión.

Regresar a la sección superior

Configurar el nivel de bitácora

Como se explicó en la sección Consola de Administración Geronimo, la Consola de Administración proporciona cuatro fragmentos (portlets) para la configuración e inspección de las bitácoras del servidor; dichos fragmentos son Log Manager, Server Log Viewer, Derby Log Viewer y Web Access Log Viewer.

Regresar a la sección superior

Log Manager

Las opciones del fragmento Log Manager (Administrador de Bitácora) son ilustradas en la siguiente figura. Desde este fragmento puedes especificar la ubicación del archivo de configuración de bitácora. Por defecto, dicho valor se establece con var/log/server-log4j.properties.

Otro valor que puedes modificar en este fragmento es Refresh Period _(Periodo de actualización)_. Este valor le dice a Geronimo con que frecuencia (en segundos) debería buscar cualquier cambio en el archivo de configuración. Por defecto, dicho valor se establece con 60 segundos.

Desde este fragmento también puedes cambiar el Log Level (Nivel de Bitácora). Por defecto su valor es INFO, y los valores posibles a elegir son All, DEBUG, INFO, WARN, ERROR, FATAL, TRACE and OFF.

Regresar a la sección superior

Server Log Viewer

Las opciones del portlet Server Log Viewer (Visor de la Bitácora del Servidor) se ilustran en la siguiente figura. Desde este portlet puedes ver las bitácoras del servidor Geronimo así como establecer filtros para redefinir al despliegue de resultados.

La liga Refresh (Refrescar) en la esquina superior izquierda, limpiará a todo criterio de filtrado que podrías haber especificado en los valores predefinidos de la Consola de Administración Geronimo, y desplegará las últimas 10 líneas (si existen) de la bitácora actual del servidor Geronimo.

El área Filter Results: (Resultados del Filtro) te permitirá especificar un criterio distinto de filtrado, para mayor particularidad en tu búsqueda. El menú de opciones File (Archivo) te permite elegir qué archivo de bitácora observar. Las bitácoras enlistadas en dicho menú se rigen por el Config File _(Archivo de Configuración)_ (server-log4j.properties por defecto) especificado en el portlet #Log Manager. El número de archivos de bitácora a elegir en el mení File dependerá del número de archivos de bitácora definidos en el archivo de configuración server-log4j.properties.

Lines.. to.. _(Líneas.. a..)_ te permite especificar el rango de líneas de bitácora a analizar. Max Results (Máximos Resultados) limita la cantidad de líneas a ser desplegadas. Level (Nivel) sólo despliega los errores ocurridos para dicho Nivel de Bitácora. Containing text (Conteniendo texto) te permite especificar una cadena a buscar a lo largo de la bitácora del servidor. Al habilitar al checkbox With Exceptions (Con Excepciones) te desplegará tanto al error como su excepción, tomando en cuenta que el despliegue del stack trace será limitado a la cantidad de líneas establecidas en el valor Max Results.

Regresar a la sección superior

Derby Log Viewer

Las opciones del portlet Derby Log Viewer (Visor de Bitácora Derby) se ilustran en la siguiente figura. Desde este portlet puedes observar las bitácoras del servidor Derby, así como establecer los filtros para refinar los resultados desplegados.

La liga Refresh (Refrescar) en la esquina superior izquierda, limpiará a todo criterio de filtrado que podrías haber especificado en los valores predefinidos de la Consola de Administración Geronimo, y desplegará las últimas 10 líneas (si existen) de la bitácora actual de servidor Derby.

Similar al portlet #Server Log Viewer, el área Filter Results: (Resultados del Filtro) te permitirá especificar un criterio distinto de filtrado para mayor particularidad en tu búsqueda. Lines.. to.. _(Líneas.. a..)_ te permite especificar el rango de líneas de bitácora a analizar. Max Results (Máximos Resultados) limita la cantidad de líneas a ser desplegadas y Containing text (Conteniendo texto) te permite especificar una cadena a buscar a lo largo de la bitácora del servidor.

Regresar a la sección superior

Web Access Log Viewer

Las opciones del portlet Web Access Log Viewer (Visor de Bitácora de Acceso Web) se ilustran en la siguiente figura. Desde este portlet puedes observar las bitácoras del servidor Web, así como establecer los filtros para refinar los resultados desplegados.

La liga Refresh (Refrescar) en la esquina superior izquierda, limpiará a todo criterio de filtrado que podrías haber especificado en los valores predefinidos de la Consola de Administración Geronimo. A diferencia del resto de portlets, Web Access Log Viewer te desplegará todas las líneas en la bitácora, sólo será limitado por las capacidades de despliegue de tu navegador web.

El área Filter Results: (Resultados del Filtro) te permitirá especificar un criterio distinto de filtrado para mayor particularidad en tu búsqueda. Para Web Access Log Viewer, esta área esta dividida en tres grupos principales: Date (Fecha), Identity (Identidad) y Requests (Peticiones).

• Date:
  Te permite especificar al rango de fechas. Si se habilita al checkbox Ignore Dates (Ignorar Fechas), el filtrado no se hará discriminando las fechas. Todas las líneas de bitácora que cumplan con el resto de criterios de filtrado, serán desplegados sin importar su fecha.

• Identity:
  Te permite especificar la Remote Address _(Dirección Remota)_ (p.e. 192.168.0.1) y Authenticated User (Usuario Autenticado) (p.e. system).

• Request:
  Te permite especificar al Request Method (Método de Solicitud) y la Requested URI (URI Solicitada). Puedes elegir al Requested Method de un menú de opciones, siendo los valores posibles ANY, POST y GET. Para filtrar mediante Requested URI, sólo ingresa la URI, por ejemplo http://localhost:8080/console/login.jsp.

Regresar a la sección superior

Monitoreando rendimiento

Para monitorear el rendimiento del servidor Web, el portlet Web Server Manager (Administrador del Servidor Web) esta disponible al elegir Web Server (Servidor Web) del menú Console Navigation _(Navegación de Consola)_ ubicado en la sección izquierda. Por defecto, este portlet no esta habilitado; da clic al botón enable (habilitar) para iniciar la captura de estadísticas.

Al habilitarle, iniciarás la captura de información en la cantidad de peticiones, conexiones concurrentes, duración de peticiones, etc. La siguiente figura ilustra todos los valores que son recolectados.

Las tres ligas en la sección inferior te permiten refresh (actualizar) las estadísticas, disable (deshabilitar) al portlet y detener la captura de nuevos datos y reset (limpiar) los datos recolectados.

Regresar a la sección superior

Agregando nuevos oyentes (listeners) para los contenedores Web

Para la configuración de nuevos oyentes (HTTP, HTTPS y AJP) en el contenedor Web en uso (ya sea Jetty ó Tomcat), el portlet Network Listener (Oyente de Red) esta disponible al elegir Web Server (Servidor Web) en el menú de Console Navigation _(Navegación de Consola)_ situada a mano izquierda. Desde este portlet puedes agregar nuevos oyentes, así como cambiar el estado (stop, start, delete) (detener, iniciar, eliminar) de oyentes existentes.

Los procesos descritos a continuación son idénticos en ambos contenedores Web, tanto para Jetty como para Tomcat.

Agregar nuevo oyente (listener) HTTP

Para agregar un nuevo oyente HTTP, haz clic en la liga respectiva. La siguiente figura ilustra los distintos parámetros necesarios para la creación de un nuevo oyente HTTP. Este proceso es muy simple y los parámetros se explican por sí mismos; llena los valores y haz clic en Save (Guardar).

Regresar a la sección superior

Agregar nuevo oyente (listener) HTTPS

Para agregar un nuevo oyente HTTPS, haz clic en la liga respectiva. La siguiente figura ilustra los distintos parámetros necesarios para la creación de un nuevo oyente HTTPS. Este proceso es muy simple y los parámetros se explican por sí mismos; llena los valores y haz clic en Save (Guardar).

Regresar a la sección superior

Agregar nuevo oyente (listener) AJP

Para agregar un nuevo oyente AJP, haz clic en la liga respectiva. La siguiente figura ilustra los distintos parámetros necesarios para la creación de un nuevo oyente AJP. Este proceso es muy simple y los parámetros se explican por sí mismos; llena los valores y haz clic en Save (Guardar).

Regresar a la sección superior

Configurando al servidor JMS

Para la configuración del servidor JMS, el portlet de JMS Network Listeners (Oyentes de Red JMS) está disponible mediante la selección de JMS Server (Servidor JMS) en el menú de la Console Navigation _(Navegación de Consola)_ situada a mano izquierda. Al hacer clic en JSM Server también obtendrás al portlet JMS Server Manager (Administrador del Servidor JMS), el cual despliega los agentes (brokers) disponibles en el servidor, así como su estado. Las siguientes figuras ilustran ambos portlets y sus opciones.

Desde el portlet JMS Network Listeners puedes agregar nuevos oyentes, así como cambiar el estado (stop, start, delete) (detener, iniciar, eliminar) de los existentes. Las opciones disponibles para agregar conectores a ActiveMQ ya se han mostrado en la figura.

Para agregar un nuevo conector a ActiveMQ has clic en la liga apropiada. La siguiente figura ilustra a los distintos parámetros necesarios para la creación de estos conectores. Este proceso es muy simple y los parámetros se explican por sí mismos; llena los valores y haz clic en Save (Guardar).

Nota que las mismas opciones te serán presentadas, independientemente de cual oyente desees agregar.

Detalles en como configurar fábricas de conexiones, colas, tópicos y destinos son cubiertos en la siguiente sección #Configurando JMS.

Regresar a la sección superior

Configurando Servicios

Existen tres tareas mayores a ser cubiertas en esta sección, las cuales son:

• Agregando artefactos al repositorio Geronimo
• Configurando pools de bases de datos
• Configurando JMS

Agregando artefactos al repositorio Geronimo

Para agregar artefactos al repositorio, el portlet Repository Viewer (Visor de Repositorio) esta disponible al elegir Common Libraries _(Librerías en Común)_ en el menú de Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. El portlet Repository Viewer que se ilustra en la figura siguiente, despliega los artefactos instalados en el repositorio del servidor. La presentación del repositorio es la misma que se usa en Apache Maven, lo cual facilita el copiado de archivos.

Para usar un artefacto en una aplicación, agrega un elemento de dependencia en su plan de activación (deployment plan). Por ejemplo, para usar Castor XML, agrega el siguiente código XML al plan:

<dependency>
        <uri>castor/jars/castor-0.9.5.3.jar</uri>
</dependency>

Regresar a la sección superior

Configurando pools de bases de datos

Regresar a la sección superior

Crear una base de datos

Regresar a la sección superior

Configurando JMS

Regresar a la sección superior

Administrando aplicaciones

Regresar a la sección superior

Instalando y eliminando aplicaciones

Regresar a la sección superior

Iniciando y deteniendo módulos de aplicación

Regresar a la sección superior

Administrando seguridad

Regresar a la sección superior

Administrando usuarios y grupos

Regresar a la sección superior

Agregando realms de seguridad

Regresar a la sección superior

Administrando certificados

Regresar a la sección superior

Configurando LDAP

Regresar a la sección superior