La Consola de Administración de Geronimo es una interfaz basada en Web que te proporciona una manera conveniente y amigable para administrar varios aspectos del Servidor Geronimo. Cuando tengas iniciado al servidor Apache Geronimo (consulta H. Herramientas y comandos), puedes tener acceso a la Consola de Administración mediante el ingreso a la siguiente URL:

http://localhost:8080/console

La página de acceso a la Consola de Administración se muestra en la siguiente figura.

Ingresa especificando system como el nombre de usuario y manager como la contraseña. Unz vez que has ingresado, serás redirigido a la página de bienvenida. La consola tiene dos áreas principales: un panel de navegación a mano izquierda, y un área de contenido principal a mano derecha.

El panel de navegación a mano izquiera te proporciona fácil acceso a tareas individuales; siempre esta presente y te permite una fácil transición de tarea a tarea. El área de contenido principal a mano derecha es donde el trabajo real sucede: esta área cambiará de acuerdo a tus elecciones de tareas en el panel izquierdo. Cada vista contiene uno o más portlets que típicamente incluyen una liga de ayuda en el encabezado; observa la siguiente figura como ejemplo.

Regresar a la sección superior

Navegación de Consola (panel izquierdo)

Como se explicó brevemente en la sección previa, el panel de navegación te proporciona acceso a las diversas tareas para la administración de recursos en Geronimo. Este panel de navegación esta organizado con los grupos principales siguientes:

#Welcome (Bienvenida)
#Server (Servidor)
#Services (Servicios)
#Applications (Aplicaciones)
#Security (Seguridad)
#Embedded DB (BD Embebida)

Welcome (Bienvenida)

Esta es la página de bienvenida que recibirás al tener acceso. Te propociona una descripción general de que es la Consola de Administración de Geronimo, así como algunas ligas de atajo a tareas comunes, como:

Acciones Comunes de Consola

• Database Pools (Pools de Bases de Datos)
• Security Realms (Reinos de Seguridad)
• JMS Resources (Recursos JMS)
• Deploy Applications (Activar Aplicaciones)
• Web Server Ports (Puertos del Servidor Web)
• Memory & Uptime (Memoria y Tiempo Activo)

Esta página también te proporciona ligas a:

Geronimo en línea

• Página Hogar de Geronimo
• Base de Datos del Seguimiento de Problemas
• Lista de Correo de Usuarios
• Lista de Correo de Desarrolladores
• Chat IRC de Geronimo

Documentación de Geronimo

• FAQ
• Wiki
• Documentación de Geronimo
• Documentación Adicional

Regresar a la sección superior

Server (Servidor)

Encontrarás información estadística bajo el grupo Servidor, así como ligas para la configuración y administración de los distintos servidores. El grupo se organiza de la siguiente manera:

#Information (Información)
#JVM
#Server Logs (Bitácoras de Servidor)
#Shutdown (Apagar)
#Web Server (Servidor Web)
#JMS Server (Servidor JMS)
#Thread Pools (Pools de "Hilos" de ejecución)
#Apache HTTP (HTTP Apache)

Regresar a la sección superior

Information (Información)

Este portlet te despliega el tiempo activo del servidor junto con los diversos recursos en uso por la JVM.

JVM

Este portlet te despliega los valores de las propiedades de sistema que están disponibles al proceso del servidor.

Server Logs (Bitácoras de Servidor)

Esta opción te proporciona cuatro portlets, Log Manager (Administrador de Bitácora), Server Log Viewer (Visor de Bitácora de Servidor), Derby Log Viewer (Visor de Bitácora Derby) y Web Access Log Viewer (Visor de Bitácora de Acceso Web).

• Log Manager
  Este portlet permite al usuario el elegir un archivo de configuración para el registro de bitácora y/ó el nivel de bitácora junto con el periodo de actualización. Por defecto el "Config file" (archivo de configuración) es un archivo log4j estándar y define la ubicación donde el Servidor Geronimo registrará bitácora. El archivo de configuración también define el nivel de bitácora, el tamaño máximo del archivo bitácora, así como otros atributos asociados con el registro de bitácora.

• Server Log Viewer
  Este portlet te despliega la bitácora del servidor Geronimo y es útil para depurar problemas con la Consola de Geronimo, así como con aplicaciones activas.

• Derby Log Viewer
  Este portlet te despliega al archivo de bitácora para la base de datos interna de Geronimo, Derby.

• Web Access Log Viewer
  Este portlet te despliega y filtra al archivo bitácora del contenedor Web. Este archivo de bitácota contiene accesos HTTP, mensajes de JSP, así como de aplicaciones servlet que están en ejecución sobre Geronimo. Por defecto, este portlet te despliega el contenido del archivo de bitácora para la fecha actual. Puedes aplicar criterio de filtrado distinto para ver sólo los datos de tu interés.

Regresar a la sección superior

Shutdown (Apagar)

Este portlet te permite un "reinicio tibio" del servidor o su apagado. Un reinicio tibio apagará toda aplicación y servicio, para después reiniciar al kernel de Geronimo dentro del mismo proceso. La sesión de la Consola de Administración será desconectada. Necesitarás reconectarte después de que el servidor regrese a actividad.

Un apagado terminará al servidor y causará fin de la JVM. Para continuar el uso de la Consola de Geronimo después de un apagado, Geronimo debe ser reiniciado completamente.

Regresar a la sección superior

Web Server (Servidor Web)

Esta opción te proporciona dos portlets, Web Server Manager (Administrador del Servidor Web) y Network Listeners (Oyentes de Red).

• Web Server Manager
  Cuando se encuentra habilitado este portlet, te recolectará estadística de rendimiento del servidor. Los valores medidos son:

• • Peticiones (Requests)
  • Conexiones
  • Errores
  • Peticiones Activas
  • Duración de Petición
  • Conexiones Abiertas
  • Peticiones de Conexión
  • Duración de Conexión

    Para los últimos cinco valores, también se desplegarán Count (Cantidad), Average (Promedio) y Maximum (Máximo).

• Network Listeners
  Este portlet te despliega a todo oyente de conexiones (HTTP, HTTPS y AJP), así como el estado para los contenedores Web, Jetty y Tomcat. Desde este portlet puedes agregar nuevos oyentes y cambiar el estado (detener, iniciar, borrar) de los existentes.

Regresar a la sección superior

JMS Server (Servidor JMS)

Esta opción te proporciona dos portlets, JMS Server Manager (Administrador de Servidor JMS) y JMS Network Listeners (Oyentes de Red JMS).

• JMS Server Manager
  Este portlet te despliega los Brokers JMS disponibles junto con su estado. Desde este portlet puedes iniciar, detener, editar, agregar y borrar Brokers JMS.

• JMS Network Listeners
  Este portlet te despliega todo conector de red configurado para los Brokers JMS disponibles. Desde este portlet también puedes iniciar, detener, editar, agregar y borrar conectores de red JMS.

Regresar a la sección superior

Thread Pools (Pools de "Hilos" de ejecución)

Este portlet te enlistará a toda pool de hilos de ejecución definida en el servidor. Te muestra el tamaño de la pool y te permite hacer monitor individual de cada pool enlistada. Mediante los monitores de los hilos de ejecución, puedes reunir información estadística como el máximo en pool, cantidad menor, cantidad mayor e hilos en uso.

Regresar a la sección superior

Apache HTTP (HTTP Apache)

Este portlet es un ayudante que te guía a través del proceso de configuración de Apache Geronimo para el uso de un servidor Apache 2 HTTP remoto. Para configurar al servidor HTTP remoto necesitarás instalar al módulo mod_jk Apache en el servidor remoto. Con ello, el ayudante se basa en una serie de preguntas para guiarte durante el proceso de configuración.

Regresar a la sección superior

Services (Servicios)

Bajo este grupo, encontrarás ligas para la configuración de los servicios siguientes:

#Common Libs (Librerías Comunes)
#Database Pools (Pools de Bases de Datos)
#JMS Resources (Recursos JMS)

Common Libs (Librerías Comunes)

Este portlet te despliega los artefactos instalados en el repositorio del servidor. El despliegue del repositorio es el mismo que emplea Apache Maven, permitiéndote el fácil copiado de archivos. Desde este portlet también puedes instalar nuevos artefactos.

Regresar a la sección superior

Database Pools (Pools de Bases de Datos)

Este portlet te despliega a toda pool de base de datos disponible, junto con su estado. Sólo es posible editar pools de bases de datos disponibles a nivel de todo el servidor, mientras que no es posible para pools de bases de datos que se activan como parte de una sóla aplicación, ya que en esos casos requieres aplicar cambios en el plan de activación de la aplicación.

También existe una liga de usage (uso) con ejemplos de cómo usar la pool desde tu aplicación.

Este portlet incluye un ayudante para la creación de pool de base de datos para nuevas pools, permitiéndote también importar pools de bases de datos de JBoss 4 y Weblogic 8.1.

Regresar a la sección superior

JMS Resources (Recursos JMS)

Este portlet te enlistará todo grupo de recursos JMS disponible en el servidor Geronimo, esto es, colas (queues) y fábricas (factories). Desde este portlet puedes crear nuevos grupos de recursos JMS, ya que te proporciona dos ayudantes, uno para ActiveMQ y otro para un proveedor JMS distinto. Para este último, necesitarás proporcionar al adaptador específico de recurso RAR, necesario para conectarse a ese proveedor en particular.

Regresar a la sección superior

<!-- CONTINUA AQUI -->

Applications (Aplicaciones)

Bajo este grupo, encontrarás ligas para la instalación y administración de aplicaciones.

#Deploy New (Activar Nueva)
#Application EARs (EARs de Aplicación)
#Web App WARs (WARs de Aplicación Web)
#EJB JARs
J2EE Connectors (Conectores J2EE)
#App Clients (Clientes de Aplicación)
#System Modules (Módulos de Sistema)
#Plugins

Deploy New

Este portlet te permite activar nuevas aplicaciones en el servidor Apache Geronimo. Aplicaciones Web requieren planes de activación, los cuales pueden estar empacados en el archivo war ó mantenerlos en un archivo separado, el cual típicamente se llama geronimo-web.xml.

Regresar a la sección superior

Application EARs

Este portlet te despliega los EARs de Aplicaciones instaladas y su estado. Desde este portlet también puedes detener, iniciar y desinstalar los EARs de Aplicaciones disponibles.

Regresar a la sección superior

Web App WARs

Este portlet te despliega las Aplicaciones Web instaladas y su estado. Desde este portlet también puedes detener, iniciar y desinstalar las Aplicaciones Web disponibles.

Regresar a la sección superior

EJB JARs

Este portlet te despliega los JARs de EJBs instalados y su estado. Desde este portlet también puedes detener, iniciar y desinstalar los JARs de EJBs disponibles.

Regresar a la sección superior

J2EE Connectors

Este portlet te despliega los Conextores J2EE instalados y su estado. Desde este portlet también puedes detener, iniciar y desinstalar los Conectores J2EE disponibles.

Regresar a la sección superior

App Clients

Este portlet te despliega los Clientes de Aplicación instalados, y su estado. Desde este portlet también puedes detener, iniciar y desinstalar los Clientes de Aplicaciones disponibles.

Regresar a la sección superior

System Modules

Este portlet te despliega los Módulos de Sistema instalados y su estado. Desde este portlet también puedes detener, iniciar y desinstalar los Módulos de Sistema disponibles.

Regresar a la sección superior

Plugins

Este portlet te permite iniciar ó crear plugins para Geronimo. Desde este portlet puedes elegir un repositorio remoto de plugins e iniciar la búsqueda de plugins disponibles e instalarlos, ó bien exportar como plugin a cualquier módulo que ya tengas instalado en Geronimo.

Regresar a la sección superior

Security

#Console Realm (Reino de Consola)
#Security Realm (Reino de Seguridad)
#Keystores
#Old Keystore

Console Realm

Esta opción te proporciona dos portlets, Console Realm Users (Usuarios del Reino de Consola) y Console Realm Groups (Grupos del Reino de Consola).

• Console Realm Users
  Este portlet te despliega a todo Usuario del Reino de Consola y te permite agregar, cambiar contraseña ó eliminarlo(s).

• Console Realm Groups
  Este portlet te despliega todo Grupo del Reino de Consola y te permite el agregar, modificar ó eliminarlo(s).

Regresar a la sección superior

Security Realm

Este portlet despliega a todo reino de seguridad disponible junto con su estado. Sólo es posible editar a los reinos de seguridad de nivel-servidor, mientras que los reinos de seguridad que son parte de sólo una aplicación no; en su lugar, necesitarías cambiar al plan de activación de dicha aplicación.

También existe una liga de usage (uso) con ejemplos de cómo emplear al reino desde tu aplicación.

Este portlet también incluye un ayudante de creación de nuevos reinos de seguridad.

Regresar a la sección superior

Keystores

Este portlet te encamina en el proceso de la configuración de keystores a usar en conectores SSL. Desde este portlet puedes agregar ó editar keystores, agregar Certificados de Confianza y crear llaves privadas.

Regresar a la sección superior

Old Keystores

Este portlet te despliega los certificados instalados; te permite importar certificados confiables y generar un par de llaves.

Regresar a la sección superior

Embedded DB

Bajo este grupo encontrarás las ligas:

• #DB Info
• #DB Manager

DB Info

Este portlet te despliega información sobre la base de datos interna, como:

• Nombre y versión del Producto Base de Datos.
• Controlador y su versión.
• URL de conexión.
• Funciones soportadas y los comandos SQL soportados.

Regresar a la sección superior

DB Manager

Esta opción te proporciona dos portlets, DB VIewer (Visor de BD) y Run SQL (Ejecutar SQL).

• DB Viewer
  Este portlet te despliega toda base de datos disponible junto con sus tablas, y despliega el contenido de sus tablas. Para ver las tablas de una base de datos en particular, haz clic en la liga de la base de datos: lo anterior te mostrará toda tabla en la base de datos. Para ver el contenido de las tablas, haz clic en la liga View Contents (Ver Contenidos). En la parte inferior del portlet DB Viewer existen ligas que te permiten regresar a View Databases ó View Tables.

• Run SQL
  Este portlet te permite ejecutar comandos SQL para manipular los datos en las tablas, crear una nueva base de datos ó borrar una base de datos. Puedes ingresar al comando SQL en la caja de texto SQL Command(s) (Comando(s) SQL) para después elegir la base de datos a usar y finalmente hacer clic en Run SQL (Ejecuta SQL) para ejecutar al comando.

Regresar a la sección superior