Fork me on GitHub

project-build:start-test-engine

Full name:

com.axonivy.ivy.ci:project-build-plugin:7.1.0:start-test-engine

Description:

Starts the Axon.ivy Engine for integration testing.

Attributes:

  • Requires a Maven project to be executed.
  • Since version: 6.2.0.

Required Parameters

Name Type Since Description
ivyVersion String 6.2.0 The ivy Engine version or version-range that must be used. Must be equal or higher than MINIMAL_COMPATIBLE_VERSION Examples:
  • "6.1.2" means ivyVersion = 6.1.2
  • "[6.1.0,7.0.0)" means 6.1.0 <= ivyVersion < 7.0.0
  • "(6.0.0,]" means ivyVersion > 6.0.0

Default value is: 7.1.0.
User property is: ivy.engine.version.

Optional Parameters

Name Type Since Description
additionalClasspath String 6.2.0 Additional classpath entries for the JVM that runs the Engine *
User property is: ivy.engine.start.additional.classpath.
additionalVmOptions String 6.2.0 Additional options for the JVM that runs the Engine. To modify the classpath or the max heap use the provided properties.
User property is: ivy.engine.start.additional.vmoptions.
engineCacheDirectory File 6.2.0 Location where ivy engines in required version can be extracted to.

If the Engine does not yet exist, it can be automatically downloaded.


Default value is: ${settings.localRepository}/.cache/ivy.
User property is: ivy.engine.cache.directory.
engineDirectory File 6.2.0 Location where an unpacked (may pre-configured) ivy Engine in the required version exists.

If parameter is not set it will be a sub-directory of the engineCacheDirectory.

If the Engine does not yet exist, it can be automatically downloaded.


User property is: ivy.engine.directory.
engineLogFile File 6.2.0 The file where the engine start is logged *
Default value is: ${project.build.directory}/testEngineOut.log.
User property is: ivy.engine.start.log.
maxmem String 6.2.0 The maximum heap (-Xmx) that is used for starting and running the Engine *
Default value is: 2048m.
User property is: ivy.engine.start.maxmem.
skipTest boolean 6.2.0 Set to true to skip the engine start.
Default value is: false.
User property is: maven.test.skip.
startTimeoutInSeconds Integer 6.2.0 The maximum amount of seconds that we wait for a engine to start
Default value is: 120.
User property is: ivy.engine.start.timeout.seconds.

Parameter Details

additionalClasspath:

Additional classpath entries for the JVM that runs the Engine *
  • Type: java.lang.String
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.start.additional.classpath

additionalVmOptions:

Additional options for the JVM that runs the Engine. To modify the classpath or the max heap use the provided properties.
  • Type: java.lang.String
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.start.additional.vmoptions

engineCacheDirectory:

Location where ivy engines in required version can be extracted to.

If the Engine does not yet exist, it can be automatically downloaded.

  • Type: java.io.File
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.cache.directory
  • Default: ${settings.localRepository}/.cache/ivy

engineDirectory:

Location where an unpacked (may pre-configured) ivy Engine in the required version exists.

If parameter is not set it will be a sub-directory of the engineCacheDirectory.

If the Engine does not yet exist, it can be automatically downloaded.

  • Type: java.io.File
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.directory

engineLogFile:

The file where the engine start is logged *
  • Type: java.io.File
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.start.log
  • Default: ${project.build.directory}/testEngineOut.log

ivyVersion:

The ivy Engine version or version-range that must be used. Must be equal or higher than MINIMAL_COMPATIBLE_VERSION Examples:
  • "6.1.2" means ivyVersion = 6.1.2
  • "[6.1.0,7.0.0)" means 6.1.0 <= ivyVersion < 7.0.0
  • "(6.0.0,]" means ivyVersion > 6.0.0
  • Type: java.lang.String
  • Since: 6.2.0
  • Required: Yes
  • User Property: ivy.engine.version
  • Default: 7.1.0

maxmem:

The maximum heap (-Xmx) that is used for starting and running the Engine *
  • Type: java.lang.String
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.start.maxmem
  • Default: 2048m

skipTest:

Set to true to skip the engine start.
  • Type: boolean
  • Since: 6.2.0
  • Required: No
  • User Property: maven.test.skip
  • Default: false

startTimeoutInSeconds:

The maximum amount of seconds that we wait for a engine to start
  • Type: java.lang.Integer
  • Since: 6.2.0
  • Required: No
  • User Property: ivy.engine.start.timeout.seconds
  • Default: 120