Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Anchor
top
top

Apache Geronimo provides several tools for administering the server. These tools are available via command line and some via a Web based console. The Web based Geronimo console is explained in detail in the following section Introducing Geronimo Administration Console. The currently available command line tools are located in the <geronimo<GERONIMO_home>HOME>/bin directory and are enumerated in the following list:

Children Display
all
all
excerpttrue

Although the tools name is self-explanatory, it may not be the same case with the tool's parameters. The following sections explain more in detail these tools and commands usage.

client

The client command launches the client application container. This command has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/client config-name \[app arg\] \[app arg\] ...*}}

The first argument identifies the Geronimo configuration that contains the application client you want to run. The rest of the arguments will be passed as arguments to the client application when it is started.

The client command can also be started by using the java -jar command:

Wiki Markup
{{{*}java \-Djava.endorsed.dirs=lib/endorsed \-jar bin/client.jar config-name \[app arg\] \[app arg\] ...*}}

jaxws-tools

The jaxws-tools command can be used to generate portable artifacts used in JAX-WS web services. For example, portable artifacts such as Service Endpoint Interface (SEI) class, Service class, JAXB generated value types, etc.

This command has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools toolName \[toolOptions\] ...*}}

Where toolName can be either:

  • #wsgen - generate portable artifacts from Java
  • #wsimport - generate portable artifacts from WSDL

The jaxws-tools command can also be started by using the java -jar command:

Wiki Markup
{{{*}java \-Djava.endorsed.dirs=lib/endorsed \-jar bin/jaxws-tools.jar toolName \[toolOptions\] ...*}}

wsgen

The jaxws-tools uses the wsgen tool provided by Sun to generate the portable artifacts from Java class. The wsgen tools has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools wsgen \[options\] <SEI>*}}

  • -classpath <path>
    Specifies where to find input class files.
  • -d <directory>
    Specifies where to place generated output files.
  • -keep
    Keep generated files.
  • -r <directory>
    Specifies where to place resource files such as WSDLs.
  • -s <directory>
    Specifies where to place generated source files.
  • -wsdl
    Generate a WSDL file.
  • -servicename <name>
    Specifies the Service name to use in the generated WSDL (used in conjunction with the -wsdl option).
  • -portname <name>
    Specifies the Port name to use in the generated WSD (used in conjunction with the -wsdl option).

Example:

Code Block

<geronimo_home>/bin/jaxws-tools wsgen -d output -keep -wsdl -classpath . foo.BarService

wsimport

The jaxws-tools uses the wsimport tool provided by Sun to generate the portable artifacts from WSDL. The wsimport has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools wsimport \[options\] <WSDL_URI>*}}

  • -d <directory>
    Specifies where to place generated output files.
  • -keep
    Keep generated files.
  • -p <pkg>
    Specifies the target package.
  • -s <directory>
    Specifies where to place generated source files.

...

.

...

Example:

...