La Consola de Administración Geronimo es una interfaz basada en Web, que proporciona un modo conveniente y amigable para administrar muchos aspectos del Servidor Geronimo. Una vez que tengas al servidor Apache Geronimo iniciado (véase H. Herramientas y comandos), puedes tener acceso a la Consola de Administración con sólo apuntar a tu explorador Web a la siguiente URL:

http://localhost:8080/console

La página de acceso a la Consola de Aministración se ejemplifica con la siguiente figura.

Obtén acceso al especificar system como nombre de usuario (username) y manager como su contraseña (password). Al obtener acceso, serás redirigido a la página de bienvenida (welcome page) de la consola. La consola tiene dos áreas principales: un panel de navegación a la izquierda y un área de contenido principal a la derecha.

El panel de navegación a la izquierda proporciona acceso sencillo a las tareas individuales, siempre esta presente y te permite una sencilla transición de tarea a tarea. El área de contenido principal a la derecha es donde el trabajo real sucede: esta área cambiará de acuerdo a tu selección de tareas distintas en el panel de navegación a la izquierda. Cada vista contiene uno ó más portlets que típicamente incluyen, en su encabezado, una liga para ayuda; observa la siguiente figura como ejemplo.

Regresar a la sección superior

Consola de Navegación (panel a la izquierda)

Como brevemente se explicó en la sección previa, un panel de navegación proporciona acceso a diferentes tareas para la administración de recursos en Geronimo. El panel de navegación está organizado de acuerdo a los grupos principales siguientes:

Welcome (Bienvenida(o))
Server (Servidor)
Services (Servicios)
Applications (Aplicaciones)
Security (Seguridad)
Misc (Misceláneo)

Welcome (Bienvenida(o))

Se trata de la página de bienvenida que observas al tener acceso. Te proporciona una descripción general de lo que és la Consola de Administración Geronimo, así como algunas ligas atajo a tareas comunes, tales como:

Common Console Actions (Acciones de Consola Comunes)

• Database Pools (Pools de Bases de Datos)
• Security Realms (Dominios 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 Online _(Geronimo En-línea)_

• The Geronimo Home Page (La Página Hogar de Geronimo)
• Problem Tracking Database (Base de datos para el Seguimiento de Problemas)
• Users Mailing List (Listas de Correo de Usuarios)
• Developers Mailing List (Listas de Correo de Desarrolladores)
• Geronimo IRC chat (Chat IRC de Geronimo)

Geronimo Documentation _(Documentación de Geronimo)_

• FAQ (Preguntas Frecuentes)
• Wiki
• Geronimo Documentation _(Documentación de Geronimo)_
• Additional Documentation _(Documentación Adicional)_

Regresar a la sección superior

Server (Servidor)

Dentro del grupo Servidor, encontrarás información estadística de forma organizada, así como ligas para la configuración y administración de los distintos servidores. El grupo se organiza como se indica a continuación:

Information _(Información)_
JVM
Server Logs (Bitácoras de Servidor)
Shutdown (Apagar)
Web Server (Servidor Web)
JMS Server (Servidor JMS)

Regresar a la sección superior

Information _(Información)_

Este portlet te despliega el tiempo activo del servidor así como los recursos que están siendo usados por la JVM.

JVM

Este portlet te despliega los valoes de las propiedades del sistema que estén disponibles para el 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 del Servidor), Derby Log Viewer (Visro de Bitácora de Derby) y Web Access Log Viewer (Visor de Bitácora de Acceso Web).

• Log Manager (Administrador de Bitácora)
  Este portlet permite al usuario el elegir un archivo de configuración para la obtención de bitácora y/ó cambiar el nivel de bitácora, así como su periodo de Captura (Refresh period). El "Config file" por defecto es un archivo log4j estándar y define la ubicación donde el Servidor Geronimo almacenará los datos de salida de la bitácora de Geronimo. El archivo de configuración también define al nivel de bitácora, su tamaño máximo, y otros atributos asociados a la obtención de bitácora.

• Server Log Viewer (Visor de Bitácora del Servidor)
  Este portlet te despliega la bitácora del servidor Geronimo y es útil para depurar problemas con la Consola Geronimo y con aplicaciones activas.

• Derby Log Viewer (Visro de Bitácora de Derby)
  Este portlet te despliega el archivo de bitácora para la base de datos interna de Geronimo, Derby.

• Web Access Log Viewer (Visor de Bitácora de Acceso Web)
  Este portlet te depliega y filtra al archivo de bitácora del contenedor Web. Este archivo de bitácora contiene los accesos HTTP y mensajes de JSP y aplicaciones servlet que se encuentran corriendo en Geronimo. Por defecto este portlet depliega al contenido del archivo de bitácora para la fecha actual. Puedes aplicar un criterio distinto para el filtrado de la bitácora, con el fin de ver los datos de tu interés.

Regresar a la sección superior

Shutdown (Apagar)

Este portlet te permite un reinicio tibio del servidor, o bien su apagado. Un reinicio tibio apagará a 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. Debes reconectarte después de que el servidor finalice su reinicio.

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

Regresar a la sección superior

Web Server (Servidor Web)

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

• Web Server Manager (Administrador de Servidor Web)
  Cuando se activa a este portlet, se encarga de obtener estadística de rendimiento del servidor. Los valores medidos son:

• • Requests (Peticiones)
  • Connections (Conexiones)
  • Errors (Errores)
  • Active Resquests (Peticiones Activas)
  • Request Duration _(Duración de Petición)_
  • Connections Open (Conexiones Abiertas)
  • Connection Requests _(Peticiones de Conexión)_
  • Connection Duration _(Duración de Conexión)_

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

• Network Listeners (Oidores de Actividad en Red)
  Este portlet te despliega todo oidor de conexión (HTTP, HTTPS y AJP) y el estado tanto para el contenedor Jetty como Web Tomcat. Desde este portlet puedes agregar nuevos oidores y cambiar el estado (stop detener, start iniciar, delete eliminar) de los conectores existentes.

Regresar a la sección superior

JMS Server (Servidor JMS)

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

• JMS Server Manager (Administrador del Servidor JMS)
  Este portlet te despliega a los JMS Brokers (Corredores JMS) disponibles junto con su estado. Desde este portlet también puedes iniciar, detener, editar, agregar y eliminar Corredores JMS.

• JMS Network Listeners (Oidores del Trabajo de Red JMS)
  Este portlet te despliega a todo conector de red configurado para los Corredores JMS disponibles. Desde este portlet también puedes iniciar, detener, editar, agregar y eliminar JMS network connectors (Conectores de actividad de red JMS).

Regresar a la sección superior

Services (Servicios)

Organizados dentro de este grupo, encontrarás ligas para la configuración de los sisguientes servicios:

Common Libraries _(Librerías Comunes)_
Database Pools (Pools de Bases de Datos)
JMS

Common Libraries _(Librerías Comunes)_

Este portlet te despliega los artefactos instalados en el repositorio del servidor. La estructura del repositorio es la misma que se usa por Apache Maven, lo cual hace posible el copiado directo 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 toda pool de base de datos disponible, así como su estado. Sólo las pools de base de datos disponibles a nivel servidor (server-wide) pueden ser editadas en este portlet, mientras que las pools de bases de datos que son activadas como parte de sólo una aplicación, no; en su lugar, requerirás el editar al plan de activación propio de la aplicación.

Desde este portlet puedes editar las pools de bases de datos disponibles, a nivel-sistema. También existe una liga usage (uso) con ejemplos al cómo usar al pool desde tu aplicación.

Este portlet también incluye un ayudante de creación de pool de base de datos (database pool creation wizard) para obtener nuevas pools, y también te permite importar pools de bases de datos propios de JBoss 4 y Weblogic 8.1.

Regresar a la sección superior

JMS

Esta opción te porpotciona dos portlets, JMS Connection Factories _(Fábricas de Conexión JMS)_ y JMS Destination Manager (Administrador de Destinos JMS).

• JMS Connection Factories _(Fábricas de Conexión JMS)_
  Este portlet te despliega los conectores JMS que están configurados en el servidor. Desde este portlet puedes ver el estado de los conectores, desplegar sus detalles, probar la conexión y agregar nuevas Fábricas de Conexión JMS.

• JMS Destination Manager (Administrador de Destinos JMS)
  Este portlet es usado para crear y eliminar queues/topics _(colas/tópicos)_.

Regresar a la sección superior

Applications (Aplicaciones)

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

Deploy New (Activar Nueva)
Application EARs (Aplicaciones EARs)
Web App WARs (Aplicaciones Web WARs)
EJB JARs
J2EE Connectors (Conectores J2EE)
App Clients (Aplicaciones Cliente)
System Modules _(Módulos de Sistema)_

Deploy New (Activar Nueva)

Este portlet te permite el activar nuevas aplicaciones en el servidor Geronimo. Aplicaciones Web requieren planes de activación, los cuales se deben encontrar empacados en el archivo war ó almacenados en un archivo separado, el cual es típicamente llamado geronimo-web.xml.

Regresar a la sección superior

Application EARs (Aplicaciones EARs)

Este portlet te depliega las Aplicaciones EARs instalads así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a toda Aplicación EARs disponible.

Regresar a la sección superior

Web App WARs (Aplicaciones Web WARs)

Este portlet te despliega a las Aplicaciones Web instaladas así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a toda Aplicación Web disponible.

Regresar a la sección superior

EJB JARs

Este portlet te despliega a los EJB JARS instalados así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a todo EJB JARs disponible.

Regresar a la sección superior

J2EE Connectors (Conectores J2EE)

Este portlet te despliega los Conectores J2EE instalados así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a todo Conector J2EE disponible.

Regresar a la sección superior

App Clients (Aplicaciones Cliente)

Este portlet te despliega las Aplicaciones Cliente instaladas así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a toda Apliación Cliente disponible.

Regresar a la sección superior

System Modules _(Módulos de Sistema)_

Este portlet te despliega los Módulos de Sistema instalados así como su estado. Desde este portlet también puedes detener, iniciar y desinstalar a todo Módulos de Sistema disponible.

Regresar a la sección superior

Security (Seguridad)

Console Realm
Security Realm
Keystore

Console Realm (Dominio de Consola)

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

• Console Realm Users (Usuarios del Dominio de Consola)
  Este portlet te despliega a todo Usuario del Dominio de la Consola, y te permite agregar, cambiar su contraseña y eliminarle(s).

• Console Realm Groups (Grupos del Dominio de Consola)
  Este portlet te despliega a todo Grupo del Dominio de la Consola, y te permite agregar, modificar y eliminarle(s).

Regresar a la sección superior

Security Realm (Dominio de Seguridad)

Este portlet te despliega a todo dominio de seguridad disponible, así como su estado. Sólo los dominios de seguridad nivel-servidor (server-wide) pueden ser editados en éste portlet, mientras que para los dominios de seguridad activados como parte de una aplicación no es posible; en su lugar, deberás aplicar cambios al plan de activación en dicha aplicación.

Desde este portlet puedes editar los dominios de seguridad, nivel-sistema (system-wide), disponibles. También existe una liga de usage (uso) con ejemplos en el cómo usar al dominio para tu aplicación.

Este portlet también incluye un ayudante de creación de dominio de seguridad (security realm creation wizard) para la creación de nuevos dominios.

Regresar a la sección superior

Keystore

Este portlet te despliega a los certificados instalados; te permite importar certificados confiables y generar un par de llaves (key pair).

Regresar a la sección superior

Misc (Misceláneo)

En estos momentos, este grupo tiene sólo una entrada y es para la administración de la base de datos embebida. El desglose de éste grupo es como sigue.

Embedded DB (BD Embebida)

• DB Info
• DB Manager

DB Info _(Información de BD)_

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

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

Regresar a la sección superior

DB Manager (Administrador de BD)

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

• DB Viewer (Visor de BD)
  Este portlet te despliega a toda base de datos disponible junto con sus tablas, y también el contenido de las tablas. Para ver las tablas de una base de datos particular, debes hacer clic a la liga de la base de datos. Lo anterior te mostrará a toda tabla en dicha base de datos. Para observar el contenido de las tablas, debes hacer click en la liga View Contents (Ver Contenidos). En la parte inferior del portlet Visor de BD, existen ligas para que puedas regresar a View Databases (Ver Bases de Datos) ó View Tables (Ver Tablas).

• Run SQL (Ejecutar SQL)
  Este portlet te permite ejecutar comandos SQL para manipular los datos en tablas, crear nueva base de datos ó eliminar una base de datos. Puedes ingresar los comandos SQL en la caja de texto SQL Command(s) (Comando(s) SQL), seleccionar la base de datos que será usada y después hacer clic en Run SQL (Ejecutar SQL) para ejecutar al comando.

Regresar a la sección superior