Article translated by: Waldo Ramírez Montaño
Artículo donado por: Hernan Cunico

Apache Geronimo proporciona diversas herramientas para la administración del servidor. Estas herramientas están disponibles vía la línea de comandos y algunas vía una consola basada en Web. La consola Geronimo basada en Web es explicada a detalle en la siguiente sección Consola de Administración Geronimo. Las herramientas de línea de comandos, que actualmente están disponibles, se localizan en el directorio <geronimo_home>/bin y son enumeradas en la lista siguiente:

Aunque el nombre de las herramientas es propiamente explicativo, probablemente no sea el mismo caso con los parámetros de las herramientas. La siguiente sección explica más a detalle el uso de los comandos.

startup

Este comando es indudablemente empleado para iniciar (start) al servidor Apache Geronimo. Puedes iniciar al servidor Apache Geronimo de dos formas distintas, mediante la ejecución de los comandos siguientes:

<geronimo_home>/bin/java -jar server.jar

ó simplemente,

<geronimo_home>/bin/startup

El comando startup invoca al server.jar.

En ambos casos, el comando acepta los mismos parámetros. Los parámetros disponibles son:

--quiet
Evade la barra habitual del progreso de inicio. Es típicamente usado cuando se redirige la salida de consola a un archivo, ó cuando se inicia al servidor desde una IDE ú otra herramienta.

--long
Escribe el progreso de inicio en la consola, en un formato que es apto para la redirección de la salida de consola a un archivo, ó cuando se inicia al servidor desde una IDE ú otra herramienta (no emplea líneas de texto para actualizar la información del progreso, que es usada por defecto, si no especificas --quiet ó --long).

-v --verbose
Indica que el nivel de bitácora (log) en la consola sea INFO, resultando en mayor salida en la consola, de la cual normalmente se presenta.

-vv --veryverbose
Indica que el nivel de bitácora (log) en la consola sea DEBUG, resultando en aún mayor salida en la consola.

-override [configId]
Ignora las configuraciones en <geronimo_home>/var/config.list, tal que sólo sean iniciadas las configuraciones enlistadas en la línea de comandos. Nótese que varias características J2EE dependen de que ciertas configuraciones sean iniciadas, por lo cual debes ser muy cuidadoso en decidir qué omitir. Cualquier argumento posterior a -override, se asume como nombre de configuración.

Cuando ejecutas este comando desde una línea de comandos Microsoft Windows, dicha ventana se queda bloqueada con los resultados del inicio (startup) en la pantalla. En un sistema operativo basado en Linux, puedes ejecutar este comando de trasfondo, recuperando el control de dicha ventana de terminal de consola.

Si ejecutas al comando de inicio sin parámetro alguno, obtendrás una pantalla similar a la siguiente.

Booting Geronimo Kernel (in Java 1.4.2-02)...
Started configuration  1/22   0s geronimo/rmi-naming/1.0/car
Started configuration  2/22   1s geronimo/j2ee-server/1.0/car
Started configuration  3/22   1s geronimo/j2ee-security/1.0/car
Started configuration  4/22   5s geronimo/activemq-broker/1.0/car
Started configuration  5/22   0s geronimo/activemq/1.0/car
Started configuration  6/22   0s geronimo/system-database/1.0/car
Started configuration  7/22   2s geronimo/directory/1.0/car
Started configuration  8/22   0s geronimo/ldap-realm/1.0/car
Started configuration  9/22   1s geronimo/jetty/1.0/car
Started configuration 10/22   0s geronimo/geronimo-gbean-deployer/1.0/car
Started configuration 11/22   1s geronimo/j2ee-deployer/1.0/car
Started configuration 12/22   0s geronimo/jetty-deployer/1.0/car
Started configuration 13/22   1s geronimo/welcome-jetty/1.0/car
Started configuration 14/22   0s geronimo/ldap-demo-jetty/1.0/car
Started configuration 15/22   1s geronimo/servlets-examples-jetty/1.0/car
Started configuration 16/22   2s geronimo/jsp-examples-jetty/1.0/car
Started configuration 17/22   2s geronimo/webconsole-jetty/1.0/car
Started configuration 18/22   1s geronimo/uddi-jetty/1.0/car
Started configuration 19/22   1s geronimo/jmxdebug-jetty/1.0/car
Started configuration 20/22   7s geronimo/daytrader-derby-jetty/1.0/car
Started configuration 21/22   0s geronimo/remote-deploy-jetty/1.0/car
Started configuration 22/22   0s geronimo/hot-deployer/1.0/car
Startup completed in 28 seconds
  Listening on Ports:
    1099 0.0.0.0   RMI Naming
    1389 0.0.0.0   Apache Directory LDAP
    1527 0.0.0.0   Derby Connector
    4201 0.0.0.0   ActiveIO Connector EJB
    4242 0.0.0.0   Remote Login Listener
    8019 127.0.0.1 Jetty Connector AJP13
    8080 0.0.0.0   Jetty Connector HTTP
    8443 0.0.0.0   Jetty Connector HTTPS
   61616 0.0.0.0   ActiveMQ Message Broker Connector

  Started Application Modules:
    WAR: geronimo/welcome-jetty/1.0/car
    WAR: geronimo/servlets-examples-jetty/1.0/car
    EAR: geronimo/daytrader-derby-jetty/1.0/car
    EAR: geronimo/webconsole-jetty/1.0/car
    WAR: geronimo/jmxdebug-jetty/1.0/car
    RAR: geronimo/activemq/1.0/car
    WAR: geronimo/ldap-demo-jetty/1.0/car
    WAR: geronimo/jsp-examples-jetty/1.0/car
    WAR: geronimo/remote-deploy-jetty/1.0/car
    RAR: geronimo/system-database/1.0/car
    EAR: geronimo/uddi-jetty/1.0/car

  Web Applications:
    http://Gentux:8080/
    http://Gentux:8080/console
    http://Gentux:8080/console-standard
    http://Gentux:8080/daytrader
    http://Gentux:8080/debug-tool
    http://Gentux:8080/jsp-examples
    http://Gentux:8080/juddi
    http://Gentux:8080/ldap-demo
    http://Gentux:8080/remote-deploy
    http://Gentux:8080/servlets-examples

Geronimo Application Server started

Regresar a la sección superior

shutdown

Si el comando startup inicia al servidor Apache Geronimo, shutdown definitivamente lo detendrá. Este comando tiene la sintaxis siguiente:

<geronimo_home>/bin/shutdown [opciones]

Las opciones disponibles son:

--user [nombre_de_usuario]
Especifica el nombre de usuario con autoridad para detener al servidor. Por defecto, deberías normalmente usar system como nombre de usuario.

--password [constraseña]
Especifica la contraseña para el nombre de usuario que ingresas. Por defecto, deberías normalmente usar manager como contraseña.

--port [número_de_puerto]
Especifica al puerto RML para conectarse al servidor (por ejemplo, el puerto de conexión JMX). Por defecto, deberías normalmente usar al puerto 1099.

Si no especificas parámetro alguno, el comando te solicitará un nombre de usuario y contraseña, asumiendo al puerto 1099 por defecto, sin solicitarte puerto alguno.

Regresar a la sección superior

geronimo

El comando geronimo te permite ejecutar las dos acciones previas, esto es iniciar (start) y detener (stop) al servidor en distintos modos, dependiendo de los parámetros que especifiques. El comando tiene la siguiente sintaxis:

<geronimo_home>/bin/geronimo [opciones]

Las opciones disponibles son:

debug
Esta opción iniciará al servidor en depuración JDB.

jpda start
Esta opción iniciará al servidor en depuración JPDA.

run
Esta opción iniciará al servidor en la ventana actual.

start
Esta opción iniciará al servidor en una ventana separada, tal como el comando #startup.

stop
Esta opción detendrá al servidor.

Tanto start y stop como opciones para este comando, tienen el mismo conjunto de parámetros de los comandos #startup y #shutdown.

Regresar a la sección superior

deploy

La herramienta de activación (deploy) es usada para instalar, desinstalar, iniciar y detener aplicaciones y módulos, y para instalar y desinstalar configuraciones (por ejemplo, algunos planes de activación con configuración específica, ajustes de seguridad, etc.). Debido al número de opciones en este caso, la herramienta de activación se cubre a detalle en la Sección de activación - Herramienta de activación.

Esta es una herramienta poderosa con muchos parámetros y opciones, pero su uso no es tan complicado del todo.

Así como el comando de inicio (startup), la herramienta de activación puede ser invocada de dos formas:

java -jar deployer.jar [opciones_generales] <comando> [opciones_de_comando]

ó simplemente

deploy [opciones_generales] <comando> [opciones_de_comando]

Por favor, consulte la Herramienta de activación para una descripción completamente detallada de las opciones y uso de esta herramienta.

Regresar a la sección superior

client.jar

El client.jar ejecuta al contenedor de la aplicación cliente. El comando tiene la sintaxis siguiente:

java -jar client.jar config-name [app arg] [app arg] ...

El primer argumento identifica la configuración Geronimo que contiene la aplicación cliente que desees ejecutar. El resto de argumentos serán pasados como argumentos para la aplicación cliente cuando ésta sea iniciada.

Regresar a la sección superior