|
|
| Home > Apache 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.
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
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
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
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
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
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.
