...

Existen diversas aternativas disponibles para instalar y eliminar aplicaciones:

• Consola de Administración Administración de Geronimo
• #Herramienta de ActivaciónActivación (línea línea de comandos)#Activación Rápida
• #Activación Rápida (línea línea de comandos)

Cuando empacas tu aplicaciónaplicación, puedes incluir al plan de activación activación dentro del paquete o no. Al momento de activaciónactivación, Geronimo buscará buscará los planes de activación activación geronimo-web.xml y web.xml en el directorio WEB-INF dentro de tu aplicación aplicación empaquetada. Si Geronimo no puede encontrar dichos descriptores, intentará intentará activar la aplicación aplicación con valores por defecto. Si usando los valores por defecto falla, necesitarás necesitarás proporcionale un plan de activaciónactivación, ya sea reempaquetado en la aplicación ó aplicación ó proporcionando un plan de activación activación externo; en las secciones siguientes discutiremos más más dichas alternativas.

Consola de

...

Administración de Geronimo

...

CAG

Para instalar una nueva aplicación vía aplicación vía la Consola de Administración Administración de Geronimo, el portlet Install New Applications esta disponible al elegir Deploy New en el menú menú Console Navigation en la sección sección izquierda. Este portlet también también te permite iniciar automáticamente automáticamente la aplicaciónaplicación, justo después después de haberla activado.

Como se mencionó mencionó previamente, para este ejemplo estaremos usando la aplicación aplicación JSP simple HolaMundo, creada en la sección sección Inicio express - Apache Geronimo para el impaciente. Este ejemplo ya incluye en su paquete a los planes de activaciónactivación.

Desde el portlet Install New Applications haz clic en Browse para especificar la ubicación ubicación al archivo HolaMundo.war en la sección sección Archive:. Asegúrate Asegúrate de habilitar la opción opción Start app after install (por defecto, se encuentra habilitada) y después después haz clic en Install.

Deberías Deberías ver los mensajes de confirmación confirmación "The application was successfully deployed." y "The application was successfully started." en la parte superior del portlet.

Otra forma de verificar que la aplicación aplicación ha sido instalada exitosamente e iniciada es con la consulta al portlet Installed Web Applications, el cual esta disponible al elegir Web App WARs en el menú menú Console Navigation en la sección sección izquierda. Deberías Deberías ver en la lista a la aplicación aplicación como HolaMundo y con el estado running.

Como la aplicación aplicación que instalamos es HolaMundo.WAR usamos ese portlet; cuando instalas una EAR deberías deberías verificar su estado mediante la elección elección del portlet Installed Application EARs, disponible al elegir Application EARs en el menú menú Console Navigation en la sección sección izquierda. El procedimiento de instalación instalación es el mismo, tanto para aplicaciones WAR y EAR.

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

Para nuestro ejemplo, ingresa al portlet Installed Web Applications y haz clic en Uninstall para el elemento ApHolaMundo en la lista Component Name. Lo anterior detendrá detendrá la aplicación aplicación primero y después después la desinstalarádesinstalará. El mensaje de confirmación confirmación " Uninstalled application " debería debería aparecer en la sección sección inferior del portlet.

Esos son los pasos básicos básicos para instalar y desinstalar aplicaciones vía vía la Consola de Administración Administración de Geronimo; la siguientes dos secciones se enfocarán enfocarán en las opciones de línea línea de comandos.

Herramienta de

...

Activación

La herramienta de activación activación te permitirápermitirá, entre otras cosas, instalar y desinstalar aplicaciones vía vía la línea línea de comandos. En esta sección sección nos enfocaremos en esas dos tareas para la aplicación aplicación ejemplo; esta aplicación aplicación se cubre completamente en la sección DEPRECATED sección Herramienta de activaciónactivación.

Para activar la aplicación aplicación ejemplo HolaMundo.war mediante la Herramienta de activaciónactivación, abre una ventana de línea línea de comandos e ingresa al siguiente comando desde el directorio <geronimo_home>\bin:

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

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

No FormatbgColor#000000borderStylesolid I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager deploy I:\GERONIMO\ejemplo\HolaMundo.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 Deployed aplicaciones.ejemplo/ApHolaMundo/1.1/war @ http://localhost:8080/hola

Como diferencia a la activación vía activación vía la Consola de Administración Administración de Geronimo, ante el uso de la herramienta de línea línea de comandos recibes más información más información en el mensaje de confirmaciónconfirmación. Por ejemplo, recibes el Component Name (Nombre del Componente, por ej. moduleId) y también también recibes el context root donde la aplicación aplicación fue activada. Esto es muy útil útil dentro de la instalacióninstalación, pruebas y desinstalación desinstalación de diversas aplicaciones distintas, donde sería sería complicado recordar todos esos valores.

También También puedes usar la herramienta de activación activación para enlistar a toda aplicación aplicación instalada. El comando list-modules _(listar-módulosmódulos)_ te permite enlistar a toda aplicaciónaplicación; también también te permite reducir la búsqueda búsqueda al solicitar sólo sólo las aplicaciones started (iniciadas) ó ó stopped (detenidas). El comando list-modules sin parámetro parámetro adicional te enlistaráenlistará, por defecto, a toda aplicación aplicación iniciada.

Para desinstalar una aplicaciónaplicación, probablemente la enlistarías enlistarías primero para obtener el nombre correcto del Componente (ó ó moduleId). Ejecuta al siguiente comando desde el directorio <geronimo_home>\bin:

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

Recibirás Recibirás una lista similar a la que se muestra en el siguiente ejemplo.noformat

bgColor#000000borderStylesolid 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

Busca al resultado aplicaciones.ejemplo/ApHolaMundo/1.1/war, el cual es el valor que deberás deberás usar cuando intentes desinstalar la aplicaciónaplicación.

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

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

Dicho comando primero detendrá detendrá la aplicación aplicación y después después la desinstalarádesinstalará. Deberías Deberías obtener un mensaje de confirmación confirmación similar al siguiente: No FormatbgColor

#000000borderStylesolid I:\GERONIMO\geronimo-1.1\bin>deploy --user system --password manager undeploy 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 Module aplicaciones.ejemplo/ApHolaMundo/1.1/war unloaded. Module aplicaciones.ejemplo/ApHolaMundo/1.1/war uninstalled. Undeployed aplicaciones.ejemplo/ApHolaMundo/1.1/war

En este ejemplo usaste a la misma herramienta con tres comandos distintos:

• deploy
• list-modules
• undeploy

Los cuales no son las únicas únicas opciones y comandos disponibles para esa herramienta; por favor, visita la sección DEPRECATED sección Herramienta de activaciónactivación para mayor detalle.

...

Activación Automática

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

Nota que con este método método de activación activación debes incluir al *plan de activación* activación en el paquete de la aplicaciónaplicación, ya que este método método no soporta planes de activación activación externos. También También considera que las aplicaciones activadas mediante la DEPRECATED Herramienta de activación ó vía activación ó vía la Consola de Administración Administración de Geronimo, no serán serán enlistadas en el directorio <geronimo_home>/deploy.

Cuando copies una aplicación aplicación al directorio deploy, digamos HolaMundo.war, observarás observarás un mensaje de confirmación confirmación en la consola donde Geronimo se este ejecutando, indicando que la aplicación aplicación fue activada, así así como el contexto para tener acceso a la aplicaciónaplicación.noformat

bgColor#000000borderStylesolid 18:36:08,343 INFO [Hot Deployer] Deploying HolaMundo.war Deployed aplicaciones.ejemplo/ApHolaMundo/1.1/war @ http://localhost:8080/hola

Para eliminar la aplicaciónaplicación, sólo sólo borra al archivo WAR ó ó EAR del directorio deploy. Cuando la aplicación aplicación haya sido eliminada, deberías deberías ver un mensaje de confirmación confirmación en la consola donde Geronimo se este ejecutando, indicando que la aplicación aplicación fue desactivada.

No FormatbgColor#000000borderStylesolid 18:37:14,765 INFO [Hot Deployer] Undeploying HolaMundo.war 18:37:15,328 INFO [DirectoryMonitor] Hot deployer notified that an artifact was removed: aplicaciones.ejemplo/ApHolaMundo/1.1/war Undeployed aplicaciones.ejemplo/ApHolaMundo/1.1/war