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