You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 33 Next »


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 Geronimo Administration Console. The currently available command line tools are located in the <geronimo_home>/bin directory and are enumerated in the following list:

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:

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

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:

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

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:

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

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

<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.
  • -wsdllocation <location>
    Specified @WebService.wsdlLocation and @WebServiceClient.wsdlLocation value.

Example:

<geronimo_home>/bin/jaxws-tools wsimport -d output -keep http://localhost:8080/foo/Bar?wsdl
  • No labels