axis-server:start-server

Full name:

org.apache.axis:maven-axis-server-plugin:1.4.1-SNAPSHOT:start-server

Description:

Start a StandaloneAxisServer instance in a separate JVM.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Binds by default to the lifecycle phase: pre-integration-test.

Required Parameters

Name Type Since Description
port int - The port of the Axis server.
Default value is: 8080.

Optional Parameters

Name Type Since Description
argLine String - Arbitrary JVM options to set on the command line. Note that this parameter uses the same expression as the Surefire and Failsafe plugins. By setting the argLine property, it is therefore possible to easily pass a common set of JVM options to all processes involved in the tests. Since the JaCoCo Maven plugin also sets this property, code coverage generated on the server-side will be automatically included in the analysis.
configs FileSet[] - A set of config files to copy to the WEB-INF dir. An example of a config file would be users.lst used by SimpleSecurityProvider.
debug boolean - Indicates whether the Java process should be started in debug mode. This flag should only be set from the command line.
Default value is: false.
debugArgs String - The arguments to pass to the JVM when debug mode is enabled.
Default value is: -Xdebug -Xrunjdwp:transport=dt_socket,address=8899,server=y,suspend=y.
foreground boolean - If this flag is set to true, then the execution of the goal will block after the server has been started and the services are deployed. This is useful if one wants to manually test some services deployed on the server or if one wants to run the integration tests from an IDE. The flag should only be set using the command line, but not in the POM.
Default value is: false.
foregroundPort int - Specifies an alternate port number that will override port if foreground is set to true. This parameter should be used if the port number configured with the port parameter is allocated dynamically. This makes it easier to run integration tests from an IDE. For more information, see the usage documentation.
jmx boolean - Indicates whether the Java process should be started with remote JMX enabled. This flag should only be set from the command line.
Default value is: false.
jmxArgs String - The arguments to pass to the JVM when JMX is enabled.
Default value is: -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false.
jwsDirs File[] - A set of directories to look up JWS files from.
maxSessions int - The maximum number of concurrently active sessions.
Default value is: 100.
skipTests boolean - Set this to true to skip running tests, but still compile them. This is the same flag that is also used by the Surefire and Failsafe plugins.
Default value is: false.
wsdds FileSet[] - A set of WSDD files for services to deploy.

Parameter Details

argLine:

Arbitrary JVM options to set on the command line. Note that this parameter uses the same expression as the Surefire and Failsafe plugins. By setting the argLine property, it is therefore possible to easily pass a common set of JVM options to all processes involved in the tests. Since the JaCoCo Maven plugin also sets this property, code coverage generated on the server-side will be automatically included in the analysis.
  • Type: java.lang.String
  • Required: No
  • Expression: ${argLine}

configs:

A set of config files to copy to the WEB-INF dir. An example of a config file would be users.lst used by SimpleSecurityProvider.
  • Type: org.apache.axis.tools.maven.server.FileSet[]
  • Required: No

debug:

Indicates whether the Java process should be started in debug mode. This flag should only be set from the command line.
  • Type: boolean
  • Required: No
  • Expression: ${axis.server.debug}
  • Default: false

debugArgs:

The arguments to pass to the JVM when debug mode is enabled.
  • Type: java.lang.String
  • Required: No
  • Default: -Xdebug -Xrunjdwp:transport=dt_socket,address=8899,server=y,suspend=y

foreground:

If this flag is set to true, then the execution of the goal will block after the server has been started and the services are deployed. This is useful if one wants to manually test some services deployed on the server or if one wants to run the integration tests from an IDE. The flag should only be set using the command line, but not in the POM.
  • Type: boolean
  • Required: No
  • Expression: ${axis.server.foreground}
  • Default: false

foregroundPort:

Specifies an alternate port number that will override port if foreground is set to true. This parameter should be used if the port number configured with the port parameter is allocated dynamically. This makes it easier to run integration tests from an IDE. For more information, see the usage documentation.
  • Type: int
  • Required: No

jmx:

Indicates whether the Java process should be started with remote JMX enabled. This flag should only be set from the command line.
  • Type: boolean
  • Required: No
  • Expression: ${axis.server.jmx}
  • Default: false

jmxArgs:

The arguments to pass to the JVM when JMX is enabled.
  • Type: java.lang.String
  • Required: No
  • Default: -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

jwsDirs:

A set of directories to look up JWS files from.
  • Type: java.io.File[]
  • Required: No

maxSessions:

The maximum number of concurrently active sessions.
  • Type: int
  • Required: No
  • Default: 100

port:

The port of the Axis server.
  • Type: int
  • Required: Yes
  • Default: 8080

skipTests:

Set this to true to skip running tests, but still compile them. This is the same flag that is also used by the Surefire and Failsafe plugins.
  • Type: boolean
  • Required: No
  • Expression: ${skipTests}
  • Default: false

wsdds:

A set of WSDD files for services to deploy.
  • Type: org.apache.axis.tools.maven.server.FileSet[]
  • Required: No