HomeApache Geronimo v1.1 > Documentation > Apache Geronimo v1.1 - Guía de Usuario > Administrando Geronimo > H. Herramientas y comandos

Apache Geronimo proporciona diversas herramientas para la administración del servidor. Estas herramientas estan disponibles vía la línea de comandos y algunas vía la consola basada en Web. La consola basada en Web de Geronimo se explica a detalle en la sección siguiente, Consola de Administración de Geronimo. Las herramientas de línea de comandos que se encuentran disponibles actualmente, se ubican en el directorio <geronimo_home>/bin y se enumeran en la lista siguiente:

Aunque el nombre de las herramientas es propiamente explicativo, puede ser que no suceda lo mismo con sus parámetros. Las secciones siguientes explican más a detalle a dichas herramientas y el uso de los comandos.

startup

Este comando se emplea con certeza para iniciar al servidor Apache Geronimo. Puedes iniciar al servidor Apache Geronimo en dos formas distintas, mediante la ejecución de los comandos siguientes:

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

o simplemente

<geronimo_home>/bin/startup

El comando startup invoca a server.jar.

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

--quiet
Omite la presencia de la barra normal de progreso de inicio. Esto se usa típicamente cuando se redirige la salida de consola a un archivo, ó cuando se inicia al servidor de una IDE u otra herramienta.

--long
Escribe la barra de progreso de inicio en la consola, con un formato que sea viable para redirigirle a un archivo, ó iniciar al servidor desde una IDE u otra herramienta (no usa "líneas" para actualizar al progreso de información que se emplea por defecto, si no especificas --quiet ó --long).

-v --verbose
Establece como INFO al nivel de bitácora de la consola, causando más salida en consola de la comúnmente presente.

-vv --veryverbose
Establece como DEBUG al nivel de bitácora de la consola, causando en mucho mayor salida en consola.

-override [configId]
Omite las configuraciones en <geronimo_home>/var/config.list por lo que sólo las configuraciones listadas en la línea de comandos serán las iniciadas. Nota que muchas características J2EE dependen en el inicio de ciertas configuraciones, con lo que deberías ser muy cuidadoso en que decides omitir. Cualquier argumento después de -override se asume como nombre de configuración.

Cuando corres a este comando desde una línea de comandos de Microsoft Windows, dicha ventana quedará bloqueada con los resultados de inicio en pantalla. En un sistema operativo basado en Linux, puedes correr este comando como proceso de fondo, retomando el control de esa ventana de terminal.

Si ejecutas al comando de inicio sin parámetros, observarás una pantalla similar a la siguiente,

Booting Geronimo Kernel (in Java 1.5.0_06)...
Starting Geronimo Application Server v1.1
[***********************] 100%  38s Startup complete
  Listening on Ports:
    1099 0.0.0.0 RMI Naming
    1527 0.0.0.0 Derby Connector
    4201 0.0.0.0 ActiveIO Connector EJB
    4242 0.0.0.0 Remote Login Listener
    8009 0.0.0.0 Jetty Connector AJP13
    8080 0.0.0.0 Jetty Connector HTTP
    8443 0.0.0.0 Jetty Connector HTTPS
    9999 0.0.0.0 JMX Remoting Connector
   61616 0.0.0.0 ActiveMQ Message Broker Connector

  Started Application Modules:
    EAR: geronimo/webconsole-jetty/1.1/car
    RAR: geronimo/activemq/1.1/car
    RAR: geronimo/system-database/1.1/car
    WAR: aplicaciones.ejemplo/ApHolaMundo/1.1/war
    WAR: geronimo/remote-deploy-jetty/1.1/car
    WAR: geronimo/welcome-jetty/1.1/car

  Web Applications:
    http://localhost:8080/
    http://localhost:8080/console
    http://localhost:8080/console-standard
    http://localhost:8080/hola
    http://localhost:8080/remote-deploy

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 el cual se solicita detener al servidor. Por defecto se emplea system como nombre de usuario.

--password [contraseña]
Especifica la contraseña para el nombre de usuario que se especificó. Por defecto normalmente se emplea manager como la contraseña.

--port [número_de_puerto]
Especifica al puerto RMI a través del cual conectarse al servidor (por ejemplo, el puerto de conexiones JMX). Por defecto se emplea al puerto 1099.

Si no especificas algún parámetro, el comando te solicitará el nombre de usuario y contraseña, y asumirá el uso del puerto 1099 sin pedirte confirmación.

Regresar a la sección superior

geronimo

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

<geronimo_home>/bin/geronimo [opciones]

Las opciones disponibles son:

debug
Esta opción iniciará al servidor como debugger JDB.

jpda run
Esta opción iniciará al servidor como prioritario sobre debugger JPDA.

jpda start
Esta opción iniciará al servidor con baja prioridad sobre debugger JPDA.

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

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

stop
Esta opción detendrá al servidor.

Las opciones start y stop en este comando, tendrán el mismo grupo de parámetros como los comandos startup y shutdown.

Regresar a la sección superior

deploy

La herramienta de activación es usada para la instalación, desintalación, reinstalación, el iniciar y el detener aplicaciones y módulos, así como para la instalación y desinstalación de configuraciones (por ejemplo, algunos planes de activación en específico, realms de seguridad, pools de conexionesde base de datos, etc.). Debido al número de opciones en este caso, esta herramienta esta cubierta a detalle en la sección de Herramienta de activación.

Esta es una herramienta poderosa con muchos parámetros y opciones pero no es muy complicado su uso.

Como con el comando startup, la herramienta de activación también puede ser invocada en dos formas distintas:

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

o simplemente

deploy [opciones_generales] <comando> [opciones_del_comando]

Por favor, consulte Herramienta de activación para una descripción completamente detallado de esta herramienta y su uso.

Regresar a la sección superior

client.jar

El archivo client.jar lanza al contenedor de aplicación cliente. Este 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 deseas correr. El resto de los argumentos serán pasados como argumentos de la aplicación cliente cuando sea iniciada.

Regresar a la sección superior

upgrade.jar

Esta herramienta te ayuda a migrar planes de activación de Apache Geronimo v1.0, consulta Migrando aplicaciones de Geronimo v1.0 para mayor detalle.

Regresar a la sección superior