Versions Compared

Old Version 6

changes.mady.by.user Waldo Ramírez Montaño

Saved on

compared with

New Version 7

changes.mady.by.user Waldo Ramírez Montaño

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Adición de la sección "Administrando aplicaciones"

...

Administrando aplicaciones

Regresar a la sección superior

Instalando y eliminando aplicaciones

Regresar a la sección superior

...

Esta sección se concentra en las alternativas disponibles para la administración de aplicaciones, y te mostrará el como aplicar las actividades de administración de aplicaciones, usando tanto la Consola de Administración Geronimo y opciones de línea de comandos. Para los ejemplos mostrados en esta sección, estaremos usando la aplicación ejemplo HolaMundo.war creada en la sección Guía rápida - Apache Geronimo para el impaciente.

Instalando y eliminando aplicaciones

Para ejecutar estas actividades actualmente tienes tres opciones disponibles, las cuales usan:

Cuando empaques tu aplicación, podrías incluir o no incluir al plan de activación (deployment plan) en el paquete. Al momento de activación, Geronimo buscará los planes de activación geronimo-web.xml y web.xml, en el directorio WEB-INF dentro de tu aplicación empaquetada. Si Geronimo no puede encontrar dichos descriptores, intentará activar a la aplicación usando configuraciones por defecto. Si al emplear configuraciones por defecto falla, necesitarás proporcionar un plan de activación, ya sea re-empaquetando la aplicación ó como plan de activación externo; en las siguientes secciones discutiremos más a fondo dichas alternativas.

Consola de Administración Geronimo
Anchor
CAG
CAG

Para instalar una nueva aplicación mediante la Consola de Administración Geronimo, el portlet Install New Applications (Instalar Aplicaciones Nuevas) esta disponible al elegir Deploy New (Activar Nuevo) en el menú de la Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. Este portlet también te permite el iniciar automáticamente a la aplicación justo después de su activación.

Image Added

Como se mencionó previamente, para este ejemplo emplearemos la aplicación JSP simple HolaMundo, creada en la sección Guía rápida - Apache Geronimo para el impaciente. Para ese ejemplo, los planes de activación ya están incluidos en el paquete.

Desde el portlet Install New Applications haz clic en Browse (Navegar) para especificar la ruta al HolaMundo.war en la sección Archive: ( Archivo: ). Asegurate de habilitar (por defecto, está habilitado) la opción Start app after install _(Iniciar aplicación después de instalar)_ y después haz clic en Install (Instalar).

Deberías obtener al mensaje de confirmación " The application was successfully deployed. " _(La aplicación fue activada exitosamente)_ en la sección superior del portlet.

Otra forma de comprobar que la aplicación fue instalada e iniciada exitosamente, se logra mediante la verificación del portlet Installed Web Applications (Aplicaciones Web Instaladas), el cual esta disponible mediante al elegir Web App WARs (WARs de Aplicaciones Web) en el menú de la Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. Deberías observar a la aplicación listada como HolaMundo y con el estado running (ejecutando).

Como la aplicación que instalamos es HolaMundo.WAR, usamos ese portlet; cuando instalas un EAR podrías verificar su estado mediante el portlet Installed Application EARs (Aplicaciones EAR Instaladas), el cual esta disponible al elegir Application EARs (EARs de Aplicaciones) en el menú de la Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. El procedimiento de instalación es el mismo, tanto para aplicaciones WAR como EAR.

Para eliminar a las aplicaciones mediante la Consola de Administración Geronimo usarás los dos últimos portlets, ya sea Installed Web Applicacions ó Installed Application EARs, dependiendo de la aplicación a desinstalar.

Image Added

Para nuestro ejemplo, ingresa al portlet de Aplicaciones Web Instaladas y haz clic en Uninstall (Desinstalar) para el Component Name (Nombre del Componente) HolaMundo. Lo anterior detendrá a la aplicación como primer paso y después la desintalará. El mensaje de confirmación " Uninstalled application " _(Aplicación desintalada)_ debería aparecer en la parte inferior del portlet.

Estos son los pasos básicos para la instalación y desinstalación de aplicaciones mediante la Consola de Administración Geronimo; las dos secciones siguientes se concentarán en opciones de línea de comandos.

Regresar a la sección superior

Herramienta de Activación

La herramienta de activación te permitirá, entre otras cosas, el instalar y desinstalar aplicaciones mediante la línea de comandos. En esta sección analizaremos esas dos tareas para la aplicación ejemplo; esta herramienta es completamente cubierta en la sección Herramienta de activación.

Para activar la aplicación ejemplo HolaMundo.war con la Herramienta de Activación, abre una ventana de línea de comandos y desde el directorio <geronimo_home>\bin teclea el siguiente comando:

deploy --user system --password manager deploy <app_home>\HolaMundo.war

Una vez activada la aplicación, deberías observar un mensaje de confirmación similar al siguiente:

No Format
bgColor#000000
borderStylesolid

E:\geronimo-1.0_Jetty\bin>deploy --user system --password manager deploy ..\..\HolaMundo\HolaMundo.war
    Deployed HolaMundo @ http://localhost:8080/hola

A diferencia de la activación mediante la Consola de Administración Geronimo, la herramienta de línea de comandos te proporciona mayor información en el mensaje de confirmación. Por ejemplo, recibes el Component Name (Nombre del Componente) (también conocido como ConfigId) y también recibes la raíz del contexto (context root) en donde la aplicación fue activada. Esto es muy útil cuando se instala, prueba y desinstala a distintas aplicaciones donde sería complicado el recordar todos esos valores.

También puedes usar la Herramienta de activación para listar a toda aplicación instalada. El comando list-modules _(listar-módulos)_ te permite el listar a toda aplicación, e incluso te permite filtrar la petición mediante la solicitud de sólo las aplicaciones started (iniciadas) ó stopped (detenidas). El comando list-modules sin parámetro adicional, por defecto te listará a toda aplicación iniciada.

Para desintalar una aplicación, podrías requerir el listarla para obtener el Nombre del Componente (ó ConfigId) correcto. Ejecuta al siguiente comando desde el directorio <geronimo_home>\bin :

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

Recibirás una lista similar a la mostrada en el ejemplo siguiente:

No Format
bgColor#000000
borderStylesolid

E:\geronimo-1.0_Jetty\bin>deploy --user system --password manager list-modules
Found 33 modules
  + geronimo/j2ee-deployer/1.0/car
  + geronimo/webconsole-jetty/1.0/car
      `-> geronimo-console-standard-1.0.war @ http://localhost:8080/console-standard
      `-> geronimo-console-framework-1.0.war @ http://localhost:8080/console
  + geronimo/welcome-jetty/1.0/car @ http://localhost:8080/
  + geronimo/daytrader-derby-jetty/1.0/car
      `-> daytrader-web-1.0.war @ http://localhost:8080/daytrader
      `-> daytrader-ejb-1.0.jar
      `-> daytrader-streamer-1.0.jar
      `-> daytrader-wsappclient-1.0.jar
      `-> TradeDataSource
      `-> TradeJMS
  + geronimo/jetty-deployer/1.0/car
  + geronimo/directory/1.0/car
  + geronimo/ldap-realm/1.0/car
  + geronimo/j2ee-system/1.0/car
  + geronimo/activemq/1.0/car
  + geronimo/j2ee-server/1.0/car
  + geronimo/ldap-demo-jetty/1.0/car @ http://localhost:8080/ldap-demo
  + geronimo/jetty/1.0/car
  + geronimo/geronimo-gbean-deployer/1.0/car
  + geronimo/jsp-examples-jetty/1.0/car @ http://localhost:8080/jsp-examples
  + geronimo/rmi-naming/1.0/car
  + geronimo/servlets-examples-jetty/1.0/car @ http://localhost:8080/servlets-examples
  + geronimo/remote-deploy-jetty/1.0/car @ http://localhost:8080/remote-deploy
  + geronimo/system-database/1.0/car
  + geronimo/j2ee-security/1.0/car
  + HolaMundo @ http://localhost:8080/hola
  + geronimo/activemq-broker/1.0/car
  + geronimo/jmxdebug-jetty/1.0/car @ http://localhost:8080/debug-tool
  + geronimo/hot-deployer/1.0/car
  + geronimo/uddi-jetty/1.0/car
      `-> uddi-jetty @ http://localhost:8080/juddi
      `-> uddi-db
    geronimo/client-system/1.0/car
    geronimo/online-deployer/1.0/car
    geronimo/client-corba/1.0/car
    geronimo/daytrader-derby-jetty-streamer-client/1.0/car
    geronimo/client-security/1.0/car
    geronimo/shutdown/1.0/car
    geronimo/client/1.0/car
    geronimo/javamail/1.0/car
    geronimo/j2ee-corba/1.0/car

Busca el registro HolaMundo, el cual es el valor que deberás emplear cuando intentes desinstalar a la aplicación.

Para desinstalar la aplicación, ejecuta el siguiente comando desde el directorio <geronimo_home>\bin usando al Nombre del Componente que identificaste ante el listado de los módulos.

deploy --user system --password manager undeploy HelloWorld

El comando primero intentará detener a la aplicación en ejecución y después la desinstalará. Deberías ver un mensaje de confirmación similar al siguiente:

No Format
bgColor#000000
borderStylesolid

E:\geronimo-1.0_Jetty\bin>deploy --user system --password manager undeploy HolaMundo
    Module HolaMundo unloaded.

    Module HolaMundo uninstalled.


    Undeployed HolaMundo

En este ejemplo has usado la misma herramienta con tres comandos distintos:

  • deploy
  • list-modules
  • undeploy

Estas no son las únicas opciones y comandos disponibles para esta herramienta; por favor visita la sección Herramienta de activación para obtener detalles adicionales.

Regresar a la sección superior

Activación en vivo

Apache Geronimo soporta Hot Deployment _(Activación en Vivo)_. Esto significa que puedes copiar un archivo JAR de aplicación al directorio <geronimo_home>/deploy y la aplicación será activada automáticamente. Lo anterior también funcionará para la desinstalación ó actualización de aplicaciones previamente activadas mediante este método. Como alternativa, también podrías copiar al directorio (umpacked - "desempacado") del módulo aplicación en lugar de copiar al JAR como archivo.

Nota que con este método de activación debes incluir al deployment plan _(plan de activación)_ en el paquete de la aplicación; este método no soporta planes de activación externos. También nota que aplicaciones activadas mediante la Herramienta de activación ó la Consola de Administración Geronimo, no estarán listadas en el directorio <geronimo_home>/deploy.

Cuando copies una aplicación al directorio deploy, digamos HolaMundo.war, observarás un mensaje de confirmación en la consola donde Geronimo este ejecutándose, indicando que la aplicación fue activada y el contexto para tener acceso a la aplicación.

No Format
bgColor#000000
borderStylesolid

00:35:59,421 INFO  [Hot Deployer] Deploying HolaMundo.war
    Deployed HolaMundo @ http://localhost:8080/hola

Para eliminar la aplicación, sólo borra al archivo (ó carpeta) WAR ó EAR del directorio deploy. Cuando la aplicación ha sido eliminada, deberías observar un mensaje de confirmación en la consola donde Geronimo esté ejecutándose, indicando que la aplicación fue desactivada.

No Format
bgColor#000000
borderStylesolid

00:39:42,521 INFO  [Hot Deployer] Undeploying HolaMundo.war
    Undeployed HolaMundo

Regresar a la sección superior

Iniciando y deteniendo módulos de aplicación

Puedes cambiar el estado de una aplicación en dos formas distintas. Puedes usar la Herramienta de activación ó la Consola de Administración Geronimo.

Como se mencionó previamente, la *Herramienta de activación* tiene muchos comandos. Al momento hemos explorado primordialmente a deploy y undeploy, y brevemente a list-modules. Esta sección se concentrará en el último comando para obtener el nombre del módulo del cual queremos cambiar el estado, e introducirá dos nuevos comandos: start (iniciar) y stop (detener). Más adelante discutiremos el uso de la Consola de Administración Geronimo como método alternativo.

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

  • --all : se usa por defecto cuando no otra opción se especifica. Listará a todo módulo disponible.
  • --started : esta opción listará sólo a los módulos que se encuentren en ejecución.
  • --stopped : esta opción listará sólo a los módulos que no se encuentren en ejecución.

Esto es útil para identificar el estado de un módulo particular y al ID propio del módulo. Usaremos este comando para identificar a la aplicación HolaMundo y cambiar su estado.

Desde una ventana de la línea de comandos, ejecuta al siguiente comando desde el directorio <geronimo_home>\bin para listar 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 son distinguidos con el signo + ubicado a su izquierda, y dichos módulos también se colocan como inicio de la lista.

No Format
bgColor#000000
borderStylesolid

E:\geronimo-1.0_Jetty\bin>deploy --user system --password manager list-modules
Found 33 modules
  + geronimo/j2ee-deployer/1.0/car
  + geronimo/webconsole-jetty/1.0/car
      `-> geronimo-console-standard-1.0.war @ http://localhost:8080/console-standard
      `-> geronimo-console-framework-1.0.war @ http://localhost:8080/console
  + geronimo/welcome-jetty/1.0/car @ http://localhost:8080/
  + geronimo/daytrader-derby-jetty/1.0/car
      `-> daytrader-web-1.0.war @ http://localhost:8080/daytrader
      `-> daytrader-ejb-1.0.jar
      `-> daytrader-streamer-1.0.jar
      `-> daytrader-wsappclient-1.0.jar
      `-> TradeDataSource
      `-> TradeJMS
  + geronimo/jetty-deployer/1.0/car
  + geronimo/directory/1.0/car
  + geronimo/ldap-realm/1.0/car
  + geronimo/j2ee-system/1.0/car
  + geronimo/activemq/1.0/car
  + geronimo/j2ee-server/1.0/car
  + geronimo/ldap-demo-jetty/1.0/car @ http://localhost:8080/ldap-demo
  + geronimo/jetty/1.0/car
  + geronimo/geronimo-gbean-deployer/1.0/car
  + geronimo/jsp-examples-jetty/1.0/car @ http://localhost:8080/jsp-examples
  + geronimo/rmi-naming/1.0/car
  + geronimo/servlets-examples-jetty/1.0/car @ http://localhost:8080/servlets-examples
  + geronimo/remote-deploy-jetty/1.0/car @ http://localhost:8080/remote-deploy
  + geronimo/system-database/1.0/car
  + geronimo/j2ee-security/1.0/car
  + HolaMundo @ http://localhost:8080/hola
  + geronimo/activemq-broker/1.0/car
  + geronimo/jmxdebug-jetty/1.0/car @ http://localhost:8080/debug-tool
  + geronimo/hot-deployer/1.0/car
  + geronimo/uddi-jetty/1.0/car
      `-> uddi-jetty @ http://localhost:8080/juddi
      `-> uddi-db
    geronimo/client-system/1.0/car
    geronimo/online-deployer/1.0/car
    geronimo/client-corba/1.0/car
    geronimo/daytrader-derby-jetty-streamer-client/1.0/car
    geronimo/client-security/1.0/car
    geronimo/shutdown/1.0/car
    geronimo/client/1.0/car
    geronimo/javamail/1.0/car
    geronimo/j2ee-corba/1.0/car

Ahora nuestro objetivo es " + HolaMundo @ http://localhost:8080/holaImage Added " , el cual presenta estado started (iniciado) ya que cuenta con + a su izquierda. Como alternativa, puedes ejecutar al siguiente comando para listar sólo a módulos iniciados:

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

Para detener al módulo HolaMundo, teclea el siguiente comando:

deploy --user system --password manager stop HelloWorld

Recibirás un mensaje de confirmación para indicar que el módulo ha sido detenido.

Cuando listas a todo módulo detenido, ahora deberías observar que a esa lista se agregó al módulo HolaMundo. Observa al comando y sus resultados en el siguiente ejemplo.

No Format
bgColor#000000
borderStylesolid

E:\geronimo-1.0_Jetty\bin>deploy --user system --password manager list-modules --stopped
Found 10 modules
    geronimo/client-system/1.0/car
    geronimo/online-deployer/1.0/car
    geronimo/client-corba/1.0/car
    geronimo/daytrader-derby-jetty-streamer-client/1.0/car
    geronimo/client-security/1.0/car
    geronimo/shutdown/1.0/car
    HolaMundo
    geronimo/client/1.0/car
    geronimo/javamail/1.0/car
    geronimo/j2ee-corba/1.0/car

Para iniciar los módulos, sólo necesitas emplear start en lugar de stop.

Como alternativa a la línea de comandos, puedes usar la Consola de Administración Geronimo para cambiar el estado de los módulos. Abre la Consola de Administración Geronimo y navega a Applications (Aplicaciones) en el menú de la Console Navigation _(Navegación de Consola)_ ubicado a mano izquierda. Ahí encontrarás Application EARs _(EARs de Aplicación)_ y Web App WARs _(WARs de Aplicación Web)_; dependiendo del tipo de aplicación de la cual quieras cambiar el estado, eligirás ya sea Application EARs ó Web App WARs. Para este ejemplo continuaremos el uso de HolaMundo.war como la aplicación en cuestión, por lo cual elegiremos Web App WARs.

Image Added

Previamente usamos este portlet para instalar y desintalar aplicaciones mediante la consola. Desde este mismo portlet también puedes cambiar el estado de las aplicaciones. Los comandos disponibles dentro del portlet cambiarán dependiendo del estado de cada aplicación. Si la aplicación esta en estado running (iniciada), sólo el comando Stop (Detener) será desplegado. Si la aplicación esta stopped (detenida), sólo el comando Start (iniciar) será desplegado. El comando Uninstall (Desinstalar) siempre se desplegará sin importar el estado de la aplicación. Para cambiar el estado de la aplicación sólo haz clic al comando (Iniciar ó Detener).

Regresar a la sección superior

...