Page History

...

Regresar a la sección superior

Commands

The available commands for the Geronimo deployer tool are listed below:

Comandos

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

• Comandos típicos Common commands
  • #deploy
  • #login
  • #redeploy
  • #start
  • #stop
  • #undeploy
• Otros comandos Other commands
  • #distribute
  • #list-modules
  • #list-targets
• Geronimo Plugins
  • #install-plugin
  • #search-plugins

Additionally, you can type help for further details on a given command, the syntax is as followsDe forma adicional, puedes usar help para obtener mayor detalle de algún comando, la sintaxis debe ser la siguiente:

java -jar deployer.jar help <commands><comandos>

Regresar a la sección superiorBack to top

Deploy

Anchor
deploy deploy

Use the deploy command to add and start a new module. The deploy command has the following syntax:

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

*{{java -jar deployer.jar <general<opciones_options> deploy <module> <deployment_plan>

The most common <general_options> would be --user and --password. New in this release is the --inPlace option that allows you to deploy an application without copying it (as part of the deployment process itself) to the Geronimo repository. In other words, you can have an application running in Geronimo but that application may be anywhere else on the file system.

The <module> specifies the application file name and location. The <deployment_plan> specifies the file name and location of the XML with the deployment plan. Sometimes the application module already has included in the package a deployment plan or the application is so simple that does not require any deployment plan, in these cases this parameter can be omited.

A module file can be one of the following:

• J2EE Enterprise Application Archive (EAR) file
• J2EE Web Application Archive (WAR) file
• J2EE Enterprise JavaBean Archive (JAR) file
• J2EE Java Resource Archive (RAR) file

If the server is not currently running at the time of deploying the application, the module will be marked to start next time the server is started.

generales> deploy <módulo> <plan_de_activación>}}*

Las <opciones_generales> más comunes suelen ser --user y --password. Como novedad en esta versión, la opción --inPlace te permite activar una aplicación sin copiarla (como parte del proceso de activación) al repositorio Geronimo. En otras palabras, puedes tener una aplicación *en ejecución* en Geronimo, pero esa aplicación puede estar en cualquier ubicación del sistema de archivos.

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

Un archivo de 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

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

Regresar a la sección superiorBack to top

Login

Anchor
login login

Use the login command to save the username and password for the current connection to the file .geronimo-deployer in the current user's home directory. Future connections to the same server will try to use this saved authentication information instead of prompting where possible.

This information will be saved separately per connection URL, so you can specify --url or --host and/or --port on the command line to save a login to a different server.

Usa al comando login para guardar al nombre de usuario y contraseña de la 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á usar esa información de autentificación en lugar de solicitarla.

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

El comando login tiene la sintaxis siguienteThe login command has the following syntax:

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

So, next time you run a different command that originally required user name and passowrd, you can run the command directly, for exampleEntonces, la siguiente ocasión que ejecutes algún comando diferente que requiera nombre de usuario y contraseña, puedes ejecutarlo directamente, por ejemplo:

deploy list-modules

Regresar a la sección superiorBack to top

Redeploy

Anchor
redeploy redeploy

Use the redeploy command to stop, replace and restart a module that has been deployed before. The redeploy command has the following syntax:

Usa al comando redeploy para detener, reemplazar y reiniciar algún módulo que ha sido activado (deployed) antes. El comando redeploy tiene la sintaxis siguiente:

*{{java -jar deployer.jar <general<opciones_options> redeploy <module> <deployment_plan>

Just like the deploy command, the redeploy command accepts the following modules file types:

generales> redeploy <módulo> <plan_de_activación>}}*

Así como el comando deploy, el comando redeploy acepta los siguientes tipos de archivos de módulos:

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

Typically, both a module and a plan are specified. If the module contains a plan or if a default plan can be used, the plan can be omitted. However, if a plan is specified in this case, it overrides the other plans. If the plan references a server component already deployed in the server's environment, the module is omitted.

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

Regresar a la sección superiorBack to top

Start

Anchor
start start

Use the start command to start a previously deployed module. The start command has the following syntaxUsa al comando start para iniciar algún módulo que fue activado previamente. El comando start tiene la sintaxis siguiente:

java -jar deployer.jar <general<opciones_options> generales> start <moduleIDs>

Where <moduleIDs> is a list of one or more modules (configID) separated by blank space. The module identification (or ConfigID) is defined at deployment time in the respective deployment plan for each module previously deployed.

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

Regresar a la sección superiorBack to top

Stop

Anchor
stop stop

Use the stop command to stop a running module. The stop command has the following syntaxUsa al comando stop para detener algún módulo en ejecución. El comando stop tiene la sintaxis siguiente:

java -jar deployer.jar <general<opciones_options> generales> stop <moduleIDs>

Where <moduleIDs> is a list of one or more modules (configID) separated by blank space. The module identification (or ConfigID) is defined at deployment time in the respective deployment plan for each module previously deployed.

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

Regresar a la sección superiorBack to top

Undeploy

Anchor
undeploy undeploy

Use the undeploy command to stop and remove a module (running or not) and its deployment information from the server. The undeploy command has the following syntaxUsa al comando undeploy para detener y eliminar del servidor a un módulo (estando ó no estando en ejecución) junto con su información de activación. El comando undeploy tiene la sintaxis siguiente:

java -jar deployer.jar <general<opciones_options> generales> undeploy <moduleIDs>

Where <moduleIDs> is a list of one or more modules (configID) separated by blank space. The module identification (or ConfigID) is defined at deployment time in the respective deployment plan for each module previously deployed.

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

Regresar a la sección superiorBack to top

Distribute

Anchor
distribute distribute

Use the distribute command to add a new module to the server. This command does not start the module nor mark it to be started in the future. The distribute command has the following syntax:

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

*{{java -jar deployer.jar <general<opciones_options> distribute <module> <deployment_plan>

Just like with the deploy command, <module> specifies the application file name and location. The <deployment_plan> specifies the file name and location of the XML with the deployment plan. Sometimes the application module already has included in the package a deployment plan or the application is so simple that does not require any deployment plan, in these cases this parameter can be omited.

A module file can be one of the following:

• J2EE Enterprise Application Archive (EAR) file
• J2EE Web Application Archive (WAR) file
• J2EE Enterprise JavaBean Archive (JAR) file
• J2EE Java Resource Archive (RAR) file

generales> distribute <módulo> <plan_de_activación>}}*

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

El archivo del 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 superiorBack to top

List-modules

Anchor
list-modules list-modules

Use the list-modules command to list all available modules on the server, note that for running this command the server must be runnning. The list-modules command has the following syntaxUsa al comando list-modules para enlistar a todo módulo disponible en el servidor; nota que para invocar a este comando, el servidor debe estar en ejecución. El comando list-modules tiene la sintaxis siguiente:

*{{java -jar deployer.jar <general<opciones_options>generales> list-modules \[\-\-all|\-\-started|\-\-stopped\]}}*

• --all : is used by default when no other option is specified. It will list all the available modules.se usa por defecto cuando no se indica otra opción. Causará que enliste a todo módulo disponible
• --started : this option will list only the modules that are runningesta opción enlistará sólo los módulos que estén en ejecución.
• --stopped : this option will list only the modules that are not running.esta opción enlistará sólo los módulos que no estén en ejecución.

Regresar a la sección superiorBack to top

List-targets

Anchor
list-targets list-targets

Use the list-targets command to lists the targets known to the server you have connected to. The list-targets command has the following syntaxUsa 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:

java -jar deployer.jar <general<opciones_options> generales> list-targets

In the case of En el caso de Geronimo, each configuration store is a separate target. Geronimo does not yet support clusters as targets.cada almacén de configuración (configuration store) es un objetivo separado. Geronimo aún no soporta clusters como objetivos.

Regresar a la sección superiorBack to top

Install-plugin

Anchor
install-plugin install-plugin

Use the Usa al comando install-plugin command to install a Geronimo plugin previously exported from a Geronimo server or downloaded from a repository. A Geronimo plugin can be an application, a configuration such data sources and drivers or a combination. The install-plugin command has the following syntax para instalar algún plugin Geronimo previamente exportado de algún servidor Geronimo ó descargado de un repositorio. Un plugin Geronimo puede ser una aplicación, una configuración como data sources y controladores ó una combinación. El comando install-plugin tiene la sintaxis siguiente:

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

Regresar a la sección superiorBack to top

Search-plugins

Anchor
search-plugins search-plugins

Use the Usa al comando search-plugins command to list all the Geronimo plugins available in a Maven repository. The search-plugins command has the following syntax para enlistar a todo plugin Geronimo disponible en algún repositorio Maven. El comando search-plugins tiene la sintaxis siguiente:

java -jar deployer.jar search-plugins <maven<URL_de_repositoryrepositorio_URL>maven>

Regresar a la sección superiorBack to top