Versions Compared

Old Version 1

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

Saved on

compared with

New Version 2

changes.mady.by.user Jarek Gawor

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

La aplicación aplicación de activación activación (deployer application) es una aplicación aplicación Java que administra artefactos J2EE y componentes GBean en el servidor Geronimo. Si el servidor está está en ejecuciónejecución, la herramienta se conectará conectará al servidor y ejecutará ejecutará su acción acción a través través del servicio de activación activación del servidor (server's deployment service). Si la herramienta no puede encontrar un servidor en ejecuciónejecución, administrará administrará la configuración configuración que encuentre, en su propio directorio de instalacióninstalación.

La herramienta de activación activación se inicia mediante el uso de java -jar para invocar a la clase principal en <geronimo_home>/bin/deployer.jar.

TípicamenteTípicamente, la herramienta de activación activación es iniciada mediante el script deploy, pero también también puedes ejecutar a la aplicación aplicación mediante el inicio de una máquina máquina virtual Java, usando la sintaxis siguiente:

...

donde <opciones_generales> especifican opciones comunes que aplican a todo comando y controlan como se comporta la aplicaciónaplicación, <comando> es el nombre de comando que especifica la acción acción a ser aplicada, y <opciones_del_comando> son opciones únicas únicas para el comando especificado.

Opciones generales

Esta sección sección enlista todas las opciones generales disponibles para la herramienta de activación activación de Geronimo.

  • Wiki Markup
    --uri <identificador>
Donde <identificador> es un Identificador Universal de Recurso _(URI, Universal Resource Identifier)_, que especifica el como la aplicaciónaplicación de activaciónactivación contactarácontactará al servidor. Si esta bandera no se especifica, la herramienta de activaciónactivación intentaráintentará contactar al servidor usando al puerto estándarestándar en localhost. El identificador debe tener la forma siguiente:
deployer:geronimo:jmx:rmi:///jndi/rmi:\[//anfitriónanfitrión\[:puerto\]]/JMXConnector
donde <anfitrión><anfitrión> se reemplaza con el nombre del anfitriónanfitrión _(host)_ óó la direccióndirección TCP/IP del sistema donde el servidor estáestá en ejecuciónejecución, y <puerto> es reemplazado con el númeronúmero de puerto donde el servidor estéesté escuchando. Si no se especifica, se emplea _localhost_ como anfitriónanfitrión y el puerto por defecto.
  • --driver <ubicación<ubicación_del_controlador>
    Donde <ubicación<ubicación_del_controlador> es la ubicación ubicación en el sistema de archivos (path), en donde se encuentra el controlador JAR para usar esta herramienta con un servidor distinto de Geronimo. Actualmente, entradas Class-Path en el MANIFEST dentro del JAR, son ignoradas.
  • --user <nombre_de_usuario>
    Donde <nombre_de_usuario> es un nombre de usuario que está está autorizado a ser un administrador en el servidor. Si el comando requiere autorizaciónautorización, debes usar esta opciónopción.
  • --password <contraseña><contraseña>
    Donde <contraseña> <contraseña> es la contraseña contraseña requerida para autenticar al nombre de usuario. Si esta bandera no se especifica, la herramienta de activación intentará activación intentará ejecutar al comando sin contraseñacontraseña, pero si ello falla, intentará intentará solicitarte el ingreso de la contraseñacontraseña.
  • --syserr <seleccionar>
    Donde <seleccionar> puede ser true (verdadero) ó ó false (falso). Si la bandera no se especifica, se asume false. Especifica true cuando desees hacer bitácora bitácora de errores en el dispositivo syserr.
  • --verbose <seleccionar>
    Donde <seleccionar> puede ser true (verdadero) ó ó false (falso). Si la bandera no se especifica, se asume false. Especifica true cuando necesites más más mensajes para determinar la causa de algún algún error.

Regresar a la sección sección superior

Comandos

Los comandos disponibles para la herramienta de activación activación Geronimo se enlistan a continuacióncontinuación:

AdemásAdemás, puedes escribir help (ayuda) para mayor detalle en un comando dado; la sintaxis es la siguiente:

java -jar deployer.jar help <comandos>

Regresar a la sección sección superior

Deploy (Activar)
Anchor
deploy
deploy

Usa al comando deploy (activar) para agregar e iniciar un nuevo módulomódulo. El comando deploy tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> deploy <módulo> <módulo> <plan_de_activación>}}activación>

Las <opciones_generales> más más comunes deberían deberían ser --user y --password.
El <módulo> <módulo> especifica al nombre del archivo de aplicación aplicación y su ubicaciónubicación. El <plan_de_activación> activación> especifica al nombre de archivo y ubicación ubicación del XML que contiene al plan de activación activación (deployment plan). En ocasiones, el módulo módulo de la aplicación aplicación ya incluye su plan de activación activación en el paquete, ó ó la aplicación aplicación es tan simple que no requiere algún algún plan de activaciónactivación; en dichos casos, el parámetro parámetro <plan_de_activación> activación> puede ser omitido.

El archivo del módulo módulo puede ser alguno de los siguientes:

  • Archivo de Aplicación Aplicación Empresarial J2EE (archivo EAR, Enterprise Application Archive)
  • Archivo de Aplicación Aplicación WEB J2EE (archivo WAR, Web Application Archive)
  • Archivo JavaBean Empresarial J2EE (archivo JAR, Enterprise JavaBean Archive)
  • Archivo Recurso Java J2EE (archivo RAR, Java Resource Archive)

Si el servidor no se encuentra en ejecución ejecución al momento de la activación activación de la aplicaciónaplicación, el módulo será módulo será marcado para ser iniciado en la siguiente ocasión ocasión donde el servidor inicie.

Regresar a la sección sección superior

Redeploy

...

(

...

Reactivación)

...

Anchor
redeploy
redeploy

Emplea al comando redeploy _(reactivaciónreactivación)_ para detener, reemplazar y reiniciar un módulo módulo que ya había había sido activado previamente. El comando redeploy tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> redeploy <módulo> <módulo> <plan_de_activación>}}activación>

Así Así como el comando de activaciónactivación, el comando de reactivación reactivación acepta los siguientes tipos de archivo del módulomódulo:

  • Archivo de Aplicación Aplicación Empresarial J2EE (archivo EAR, Enterprise Application Archive)
  • Archivo de Aplicación Aplicación WEB J2EE (archivo WAR, Web Application Archive)
  • Archivo JavaBean Empresarial J2EE (archivo JAR, Enterprise JavaBean Archive)
  • Archivo Recurso Java J2EE (archivo RAR, Java Resource Archive)

ComúnmenteComúnmente, se especifica tanto un módulo módulo como un plan. Si el módulo módulo contiene un plan ó ó si un plan por defecto puede ser usado, es válido válido omitir la opción opción del plan. Sin embargo, si en este caso se especifica algún algún plan, se antepone a otros planes. Si el plan hace referencias a un componente del servidor que ya ha sido activado en el ambiente del servidor, se omite a dicho módulomódulo.

Regresar a la sección sección superior

Start (Iniciar)
Anchor
start
start

Emplea al comando start para iniciar un módulo módulo previamente activado. El comando start tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> start <IDs_de_módulos>}}módulos>

Donde <IDs_de_módulos> módulos> es una lista de uno o más módulos más módulos (ConfigID) separados por espacio en blanco. La identificación identificación del módulo módulo (ó ó ConfigID) es definida al momento de activaciónactivación, en el plan de activación activación propio de cada módulo módulo previamente activado.

Regresar a la sección sección superior

Stop (Detener)
Anchor
stop
stop

Emplea al comando stop para detener un módulo módulo en ejecuciónejecución. El comando stop tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> stop <IDs_de_módulos>}}módulos>

Donde <IDs_de_módulos> módulos> es una lista de uno o más módulos más módulos (ConfigID) separados por espacio en blanco. La identificación identificación del módulo módulo (ó ó ConfigID) es definida al momento de activaciónactivación, en el plan de activación activación propio de cada módulo módulo previamente activado.

Regresar a la sección sección superior

Undeploy (Desactivar)
Anchor
undeploy
undeploy

Emplea al comando undeploy para detener y eliminar del servidor, un módulo módulo (estando o no, en ejecuciónejecución) así así como su información información de activaciónactivación. El comando undeploy tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> undeploy <IDs_de_módulos>}}módulos>

Donde <IDs_de_módulos> módulos> es una lista de uno o más módulos más módulos (ConfigID) separados por espacio en blanco. La identificación identificación del módulo módulo (ó ó ConfigID) es definida al momento de activaciónactivación, en el plan de activación activación propio de cada módulo módulo previamente activado.

Regresar a la sección sección superior

Distribute (Distribuir)
Anchor
distribute
distribute

Emplea al comando distribute para agregar un nuevo módulo módulo al servidor. Este comando no inicia al módulo módulo ni lo marca para ser iniciado en el futuro. El comando distribute tiene la sintaxis siguiente:

{{java -jar deployer.jar <opciones_generales> distribute <módulo> <módulo> <plan_de_activación>}}activación>

Así Así como el comando deploy, <módulo> <módulo> especifica al nombre de archivo y su ubicaciónubicación. El <plan_de_activación> activación> especifica al nombre de archivo y ubicación ubicación del XML que contiene al plan de activaciónactivación. En ocasiones, el módulo módulo de aplicación aplicación ya incluye un plan de activación activación en su paquete ó ó la aplicación aplicación es tan simple que no requiere plan de activación activación alguno; en dichos casos, el parámetro parámetro <plan_de_activación> activación> puede ser omitido.

El archivo del módulo módulo puede ser alguno de los siguientes:

  • Archivo de Aplicación Aplicación Empresarial J2EE (archivo EAR, Enterprise Application Archive)
  • Archivo de Aplicación Aplicación WEB J2EE (archivo WAR, Web Application Archive)
  • Archivo JavaBean Empresarial J2EE (archivo JAR, Enterprise JavaBean Archive)
  • Archivo Recurso Java J2EE (archivo RAR, Java Resource Archive)

Regresar a la sección sección superior

List-modules

...

(Enlistar-

...

módulos)

...

Anchor
list-modules
list-modules

Emplea al comando list-modules para enlistar a todo módulo módulo disponible en el servidor; nótese nótese que la ejecución ejecución de éste éste comando requiere que el servidor se encuentre en ejecuciónejecución. El comando list-modules tiene la sintaxis siguiente:

...

  • --all : se usa por defecto, cuando ninguna otra opción opción se especifica. Se encargará encargará de enlistar a todo módulo módulo disponible.
  • --started : esta opción enlistará sólo opción enlistará sólo a los módulos módulos que estén estén en ejecuciónejecución.
  • --stopped : esta opción enlistará sólo opción enlistará sólo a los módulos módulos que no estén estén en ejecuciónejecución.

Regresar a la sección sección superior

List-targets (Enlistar-destinos)
Anchor
list-targets
list-targets

Emplea al comando list-targets para enlistar a los destinos conocidos para el servidor al cual te has conectado. El comando list-targets tiene la sintaxis siguiente:

...

En el caso de Geronimo, cada almacén almacén de configuración configuración es un destino separado. Al momento, Geronimo aún aún no soporta clusters como destinos.

Regresar a la sección sección superior

Package (Paquete)
Anchor
package
package

Emplea al comando package para crear un archivo JAR de configuración configuración en lugar de la instalación instalación en el ambiente del servidor. El comando package tiene la sintaxis siguiente:

Wiki Markup
{{java -jar deployer.jar <opciones_generales> *package* \[\-\-classPath path] \[\-\-mainClass class] \[\-\-install] <módulo><módulo> <plan_de_activación>activación> fileName}}

El argumento opcional --classPath especifica un Class-Path a incluir en el MANIFEST del JAR. El argumento opcional --mainClass especifica la Main-Class a incluir en el MANIFEST del JAR. La opción opción --install especifica que la configuración debería configuración debería ser construida en un JAR y también también instalada en la configuración configuración del servidor (de otro modo, es empaquetada, más más no instalada). El argumento fileName especifica el JAR a ser creado.

Regresar a la sección sección superior