B. Iniciando y deteniendo mÃ³dulos de aplicaciÃ³n

Puedes cambiar el estado de una aplicaciÃ³n de dos formas distintas. Puedes usar la Herramienta de activaciÃ³n Ã³ la Consola de AdminsitraciÃ³n de Geronimo.

Como se mencionÃ³ previamente, la *Herramienta de activaciÃ³n* tiene varios comandos. En la secciÃ³n A. Instalando y eliminando aplicaciones, principalmente exploramos los comandos deploy (activar) y undeploy (desactivar), y brevemente a list-modules _(enlistar-mÃ³dulos)_. Esta secciÃ³n se enfoca en el Ãºltimo comando para obtener al nombre del mÃ³dulo del cual queremos cambiar el estado, e introduciremos dos nuevos comandos, start (iniciar) y stop (detener). MÃ¡s adelante discutiremos el uso de la Consola de AdministraciÃ³n de Geronimo como el mÃ©todo alternativo.

El comando list-module acepta a los tres siguientes parÃ¡metros:

--all : es usado por defecto cuando no se especifica otra opciÃ³n. EnlistarÃ¡ a todo mÃ³dulo disponible.
--started : esta opciÃ³n enlistarÃ¡ sÃ³lo a los mÃ³dulos que se encuentren en ejecuciÃ³n.
--stopped : esta opciÃ³n enlistarÃ¡ sÃ³lo a los mÃ³dulos que no se encuentren en ejecuciÃ³n.

Es Ãºtil el identificar el estado de un nÃ³dulo particular junto con su ID de mÃ³dulo. Emplearemos este comando para identificar a la aplicaciÃ³n HolaMundo y poder cambiar su estado.

Desde una ventana de lÃnea de comandos, ejecuta al siguiente comando desde el directorio <geronimo_home>\bin para enlistar a todo mÃ³dulo:

deploy --user system --password manager list-modules

RecibirÃ¡s una lista de todo mÃ³dulo instalado en el servidor. Nota que los mÃ³dulos iniciados se distinguen con un signo + a su izquierda y son los que se despliegan primero en la lista.

I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager list-modules
Using GERONIMO_BASE:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_HOME:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_TMPDIR: I:\GERONIMO\geronimo-1.1\var\temp
Using JRE_HOME:        C:\j2sdk1.4.2_10
Found 33 modules
  + aplicaciones.ejemplo/ApHolaMundo/1.1/war @ http://localhost:8080/hola
  + geronimo/activemq/1.1/car
  + geronimo/activemq-broker/1.1/car
  + geronimo/axis/1.1/car
  + geronimo/axis-deployer/1.1/car
  + geronimo/client-deployer/1.1/car
  + geronimo/geronimo-gbean-deployer/1.1/car
  + geronimo/hot-deployer/1.1/car
  + geronimo/j2ee-deployer/1.1/car
  + geronimo/j2ee-security/1.1/car
  + geronimo/j2ee-server/1.1/car
  + geronimo/j2ee-system/1.1/car
  + geronimo/jetty/1.1/car
  + geronimo/jetty-deployer/1.1/car
  + geronimo/openejb/1.1/car
  + geronimo/openejb-deployer/1.1/car
  + geronimo/remote-deploy-jetty/1.1/car @ http://localhost:8080/remote-deploy
  + geronimo/rmi-naming/1.1/car
  + geronimo/sharedlib/1.1/car
  + geronimo/system-database/1.1/car
  + geronimo/webconsole-jetty/1.1/car
      `-> framework.war @ http://localhost:8080/console
      `-> standard.war @ http://localhost:8080/console-standard
  + geronimo/welcome-jetty/1.1/car @ http://localhost:8080/
    geronimo/client/1.1/car
    geronimo/client-corba/1.1/car
    geronimo/client-security/1.1/car
    geronimo/client-system/1.1/car
    geronimo/j2ee-corba/1.1/car
    geronimo/javamail/1.1/car
    geronimo/online-deployer/1.1/car
    geronimo/shutdown/1.1/car
    geronimo/uddi-jetty/1.1/car
    geronimo/upgrade/1.1/car
    geronimo/upgrade-cli/1.1/car

Nuestro objetivo es "+ aplicaciones.ejemplo/ApHolaMundo/1.1/war @ http://localhost:8080/hola", ya que el estado de ese mÃ³dulo es started (iniciado) al tener al signo + a su izquierda. Como alternativa, puedes ejecutar al siguiente comando para enlistar sÃ³lo a los mÃ³dulos iniciados:

deploy --user system --password manager list-modules --started

Para detener al mÃ³dulo "aplicaciones.ejemplo/ApHolaMundo/1.1/war", emplea el siguiente comando:

deploy --user system --password manager stop aplicaciones.ejemplo/ApHolaMundo/1.1/war

RecibirÃ¡s un mensaje de confirmaciÃ³n similar al que presentamos a continuaciÃ³n, indicando que el mÃ³dulo ha sido detenido.

I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager stop aplicaciones.ejemplo/ApHolaMundo/1.1/war
Using GERONIMO_BASE:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_HOME:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_TMPDIR: I:\GERONIMO\geronimo-1.1\var\temp
Using JRE_HOME:        C:\j2sdk1.4.2_10

    Stopped aplicaciones.ejemplo/ApHolaMundo/1.1/war

Ahora al enlistar a todo mÃ³dulo detenido, deberÃas observar que se agregÃ³ a dicha lista al mÃ³dulo aplicaciones.ejemplo/ApHolaMundo/1.1/war. Observa al comando junto con sus resultados en el siguiente ejemplo.

I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager list-modules --stopped
Using GERONIMO_BASE:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_HOME:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_TMPDIR: I:\GERONIMO\geronimo-1.1\var\temp
Using JRE_HOME:        C:\j2sdk1.4.2_10
Found 12 modules
    aplicaciones.ejemplo/ApHolaMundo/1.1/war
    geronimo/client/1.1/car
    geronimo/client-corba/1.1/car
    geronimo/client-security/1.1/car
    geronimo/client-system/1.1/car
    geronimo/j2ee-corba/1.1/car
    geronimo/javamail/1.1/car
    geronimo/online-deployer/1.1/car
    geronimo/shutdown/1.1/car
    geronimo/uddi-jetty/1.1/car
    geronimo/upgrade/1.1/car
    geronimo/upgrade-cli/1.1/car

Para iniciar mÃ³dulos, sÃ³lo emplea start (iniciar) en lugar de stop (detener).

deploy --user system --password manager start aplicaciones.ejemplo/ApHolaMundo/1.1/war

RecibirÃ¡s un mensaje similar al siguiente:

I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager start aplicaciones.ejemplo/ApHolaMundo/1.1/war
Using GERONIMO_BASE:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_HOME:   I:\GERONIMO\geronimo-1.1
Using GERONIMO_TMPDIR: I:\GERONIMO\geronimo-1.1\var\temp
Using JRE_HOME:        C:\j2sdk1.4.2_10

    Started aplicaciones.ejemplo/ApHolaMundo/1.1/war @
    http://localhost:8080/hola

Como alternativa a la opciÃ³n de lÃnea de comandos, puedes emplear a la Consola de AministraciÃ³n de Geronimo para cambiar el estado de los mÃ³dulos. Abre la Consola de AdministraciÃ³n de Geronimo y navega en Applications (Aplicaciones) en el menÃº Console Navigation _(NavegaciÃ³n de Consola)_ ubicado a mano izquierda. AhÃ encontrarÃ¡s Application EARs (EARs de Aplicaciones) y Web App WARs (WARs de Web Aps) con lo que, dependiendo del tipo de aplicaciÃ³n a la cual quieras cambiar el estado, podrÃ¡s elegir alguna de esas dos opciones. Para este ejemplo continuaremos con el uso de HolaMundo.war como aplicaciÃ³n ejemplo, y con ello elegiremos Web App WARs.

Previamente usamos este portlet en la secciÃ³n A. Instalando y eliminando aplicaciones para instalar y eliminar aplicaciones mediante la Consola de AdministraciÃ³n de Geronimo. Desde este mismo portlet tambiÃ©n puedes cambiar el estado de aplicaciones. Los comandos disponibles dentro de este portlet dependen del estado de cada aplicaciÃ³n. Si la aplicaciÃ³n se encuentra en estado running (iniciada), sÃ³lo se despliega al comando Stop (Detener). Si la aplicaciÃ³n esta stopped (detenida), sÃ³lo se despliega al comando Start (Iniciar). El comando Uninstall (Desinstalar) siempre serÃ¡ desplegado, independientemente del estado de la aplicaciÃ³n. Para cambiar el estado de la aplicaciÃ³n sÃ³lo requieres hacer clic al comando (Start Ã³ Stop).