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.
Wiki Markup
{scrollbar}

Anchor
top
top

La aplicación aplicación de activación activación es una aplicación aplicación Java que administra artefactos J2EE y componentes GBean en el servidor Geronimo. Si Geronimo esta en ejecuciónejecución, se conectará conectará al servidor y ejecutará ejecutará su acción acción a través través el servicio de activación activación del servidor. Si no puede encontrar un servidor en ejecuciónejecución, lanzará lanzará un error indicando que no se pudo conectar al servidor ó ó el servidor no esta disponible.

La herramienta de activación activación puede iniciarse mediante el comando java -jar para invocar la clase principal en <geronimo_home>/bin/deployer.jar.

TípicamenteTípicamente, la herramienta de activación activación se inicia con el uso del script deploy, pero también también puedes ejecutarla con el inicio de una máquina máquina virtual Java, usando la siguiente sintaxis:

...

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

Opciones generales

Esta sección sección enlista toda opción opción general disponible 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 herramienta de activaciónactivación debe contactar al servidor. Si no se establece, la herramienta intentaráintentará contactar al servidor usando al puerto estándarestándar en localhost. El identificador debe tener la siguiente forma:
deployer:geronimo:jmx:rmi:///jndi/rmi:\[//host\[:puerto\]]/JMXConnector
donde <host> se debe sustituir con el nombre del host óó la direccióndirección TCP/IP donde se encuentra el servidor, y <puerto> se reemplaza con el númeronúmero de puerto en donde el servidor se encuentra en ejecuciónejecución. Si no se especifican, localhost y el puerto predeterminado seránserán los valores usados.
  • --host <host>
    Donde <host> es el nombre del servidor al cual intentarás intentarás activar una aplicación ó aplicación ó recurso. Esta opción opción te permite activar recursos y aplicaciones en un servidor remoto. Este parámetro parámetro es opcional y el valor predeterminado es localhost.
  • --port <puerto>
    Donde <puerto> es el puerto del servidor remoto al cual deseas activar la aplicación ó aplicación ó recurso. Este parámetro parámetro es opcional y el valor predeterminado es 1099.

...

  • --user <nombre_de_usuario>
    Donde <nombre_de_usuario> es el nombre de usuario con permisos administrativos 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 no se especifica, la herramienta intentará intentará ejecutar al comando sin contraseñacontraseña, pero si el intento falla, solicitará solicitará el ingreso de la contraseñacontraseña.
  • --syserr <elección> <elección>
    Donde <elección> <elección> puede ser true (verdadero) ó ó false (falso). Si no se especifica, se asume el valor false. Especifica true cuando desees que se haga bitácora bitácora de errores, en el dispositivo syserr.
  • --verbose <elección> <elección>
    Donde <elección> <elección> puede ser true (verdadero) ó ó false (falso). Si no se especifica, se asume el valor 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:

De forma adicional, puedes usar help para obtener mayor detalle de algún algún comando, la sintaxis debe ser la siguiente:

java -jar deployer.jar help <comandos>

Regresar a la sección sección superior

Deploy
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 suelen ser --user y --password. Como novedad en esta versiónversión, la opción opción --inPlace te permite activar una aplicación aplicación sin copiarla (como parte del proceso de activaciónactivación) al repositorio Geronimo. En otras palabras, puedes tener una aplicación *aplicación en ejecución* ejecución en Geronimo, pero esa aplicación aplicación puede estar en cualquier ubicación ubicación del sistema de archivos.

El <módulo> <módulo> especifica al archivo de aplicación aplicación y su ubicaciónubicación. El <plan_de_activación> activación> especifica el nombre de archivo y ubicación ubicación del XML que contenga al plan de activaciónactivación. En ocasiones el módulo módulo de aplicación aplicación incuye en su paquete al plan de activaciónactivación, ó ó la aplicación aplicación es tan simple que no requiere plan de activaciónactivación; en esos casos este parámetro parámetro puede ser descartado.

Un archivo de módulo módulo puede ser alguno de los siguientes:

...

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 iniciarse en la siguiente ocasión ocasión en que el servidor sea iniciado.

Regresar a la sección sección superior

Login
Anchor
login
login

Usa al comando login para guardar al nombre de usuario y contraseña contraseña de la conexión conexión actual, en el archivo .geronimo-deployer, dentro del directorio casa del usuario. Cuando sea posible, en futuras conexiones al mismo servidor, se intentará intentará usar esa información información de autentificación autentificación en lugar de solicitarla.

Esta información será información será guardada por separado, para cada conexión conexión URL, por lo que puedes especificar --url ó ó --host y/ó ó --port en la línea línea de comandos para guardar un acceso (login) a un servidor distinto.

...

java -jar deployer.jar --user <nombre_de_usuario> --password <contraseña> <contraseña> login

Entonces, la siguiente ocasión ocasión que ejecutes algún algún comando diferente que requiera nombre de usuario y contraseñacontraseña, puedes ejecutarlo directamente, por ejemplo:

deploy list-modules

Warning

Incluso cuando la información información de acceso no se almacena en texto limpio, tampoco es seguro. Si deseas guardar la autentificación autentificación de forma segura, deberías deberías cambiar el archivo .geronimo-deployer en tu directorio casa, tal que nadie más más pueda leerlo ó ó escribirlo.

Regresar a la sección sección superior

Redeploy
Anchor
redeploy
redeploy

Usa al comando redeploy para detener, reemplazar y reiniciar algún módulo algún módulo que ha sido activado (deployed) antes. 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 deploy, el comando redeploy acepta los siguientes tipos de archivos de módulosmódulos:

  • Archivo EAR, J2EE Enterprise Application Archive
  • Archivo WAR, J2EE Web Application Archive
  • Archivo JAR, J2EE Enterprise JavaBean Archive
  • Archivo RAR, J2EE Java Resource Archive

Típicamente Típicamente se especifica tanto al módulo módulo como al plan de activaciónactivación. Si el módulo módulo contiene al plan ó ó puede usarse un plan predeterminado, se puede descartar el especificar al plan. Sin embargo, si se especifica algún algún plan, se descarta al resto de planes. Si el plan hace referencia a algún algún componente del servidor que ya se encuentre activo en el ambiente del servidor, el módulo módulo es descartado.

Regresar a la sección sección superior

Start
Anchor
start
start

Usa al comando start para iniciar algún módulo algún módulo que fue activado previamente. El comando start tiene la sintaxis siguiente:

...

Donde <moduleIDs> es una lista de uno ó 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) se define al momento de activación activación en el plan de activación activación respectivo, para cada módulo módulo previamente activado.

Regresar a la sección sección superior

Stop
Anchor
stop
stop

Usa al comando stop para detener algún módulo algún módulo en ejecuciónejecución. El comando stop tiene la sintaxis siguiente:

...

Donde <moduleIDs> es una lista de uno o más módulos más módulos (configID) separados por un espacio en blanco. La identificación identificación de módulo módulo (ó ó ConfigID) se define al momento de activación activación en el plan de activación activación respectivo, para cada módulo módulo previamente activado.

Regresar a la sección sección superior

Undeploy
Anchor
undeploy
undeploy

Usa al comando undeploy para detener y eliminar del servidor a un módulo módulo (estando ó ó no estando en ejecuciónejecución) junto con su información información de activaciónactivación. El comando undeploy tiene la sintaxis siguiente:

...

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

Regresar a la sección sección superior

Distribute
Anchor
distribute
distribute

Usa 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>

Al igual que el comando deploy, <módulo> <módulo> especifica al archivo de la aplicación aplicación junto con su ubicaciónubicación. El <plan_de_activación> activación> especifica el nombre de archivo y ubicación ubicación del XML que contiene al plan de activaciónactivación. Algunas veces el plan de aplicación aplicación es incluido en el paquete de la aplicaciónaplicación, ó ó la aplicación aplicación es tan sencilla que no requiere algún algún plan de activaciónactivación; en esos casos este parámetro parámetro puede ser descartado.

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

  • Archivo EAR, J2EE Enterprise Application Archive
  • Archivo WAR, J2EE Web Application Archive
  • Archivo JAR, J2EE Enterprise JavaBean Archive
  • Archivo RAR, J2EE Java Resource Archive

Regresar a la sección sección superior

List-modules
Anchor
list-modules
list-modules

Usa al comando list-modules para enlistar a todo módulo módulo disponible en el servidor; nota que para invocar a este comando, el servidor debe estar en ejecuciónejecución. El comando list-modules tiene la sintaxis siguiente:

...

  • --all : se usa por defecto cuando no se indica otra opciónopción. Causará Causará que enliste a todo módulo módulo disponible
  • --started : esta opción enlistará sólo los módulos que estén en ejecuciónopción enlistará sólo los módulos que estén en ejecución.
  • --stopped : esta opción enlistará sólo los módulos opción enlistará sólo los módulos que no estén estén en ejecuciónejecución.

Regresar a la sección sección superior

List-targets
Anchor
list-targets
list-targets

Usa al comando list-targets para enlistar los objetivos que conoce 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 (configuration store) es un objetivo separado. Geronimo aún aún no soporta clusters como objetivos.

Regresar a la sección sección superior

Install-plugin
Anchor
install-plugin
install-plugin

Usa al comando install-plugin para instalar algún algún plugin Geronimo previamente exportado de algún algún servidor Geronimo ó ó descargado de un repositorio. Un plugin Geronimo puede ser una aplicaciónaplicación, una configuración configuración como data sources y controladores ó ó una combinacióncombinación. El comando install-plugin tiene la sintaxis siguiente:

java -jar deployer.jar install-plugin <archivo_plugin>

Regresar a la sección sección superior

Search-plugins
Anchor
search-plugins
search-plugins

Usa al comando search-plugins para enlistar a todo plugin Geronimo disponible en algún algún repositorio Maven. El comando search-plugins tiene la sintaxis siguiente:

java -jar deployer.jar search-plugins <URL_de_repositorio_maven>

Regresar a la sección sección superior