Fork me on GitHub
Built by Maven

ivy:installEngine

Full name:

com.axonivy.ivy.ci:project-build-plugin:12.0.14-SNAPSHOT:installEngine

Description:

Downloads an Axon Ivy Engine from the web if it does not yet exists in the correct version.

Command line invocation is supported. E.g.

mvn com.axonivy.ivy.ci:project-build-plugin:12.0.0:installEngine
-Divy.engine.directory=c:/axonviy/engine
-Divy.engine.version=12.0.0
-Divy.engine.os.arch=Linux_x64

Attributes:

  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Since version: 6.0.0.

Required Parameters

Name Type Since Description
<ivyVersion> String - The ivy Engine version or version-range that must be used. Must be equal or higher than "12.0.0" 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: 12.0.13
User Property: ivy.engine.version

Optional Parameters

Name Type Since Description
<autoInstallEngine> boolean - Enables the automatic installation of an ivy Engine in the engineDirectory. If there is yet no engine installed, or the ivyVersion does not match, the engine will be downloaded from the engineDownloadUrl and unpacked into the engineDirectory.
Default: true
User Property: ivy.engine.auto.install
<downloadUsingMaven> Boolean 7.4 Enables the engine artifact download via maven plugin repositories. If set to false, the default URL download approach is used (see engineDownloadUrl and engineListPageUrl properties).

As there exist no official maven repository containing the axonivy engine, it must be published manually to an accessible plugin repository. The expected artifact descriptor is:

groupId=com.axonivy.ivy
artifactId=engine
version=!ivyVersion! (e.g. 7.4.0)
classifier=!osArchitecture! (e.g. Slim_All_x64)
extension=zip

Default: false
User Property: ivy.engine.download.from.maven
<engineCacheDirectory> Path - Location where ivy engines in required version can be extracted to.

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


Default: ${settings.localRepository}/.cache/ivy
User Property: ivy.engine.cache.directory
<engineDirectory> Path - 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: ivy.engine.directory
<engineDownloadUrl> URL - URL where a packed ivy Engine can be downloaded. E.g. https://developer.axonivy.com/download/6.0.10/AxonIvyEngine6.0.10.55478_Windows_x64.zip
User Property: ivy.engine.download.url
<engineListPageUrl> URL - URL where a link to the ivy Engine in the expected ivyVersion exists. The URL will be used to download the required engine if it does not yet exist. The URL should point to a site providing HTML content with a link to the engine
e.g. <a href="https://developer.axonivy.com/download/6.0.10/AxonIvyEngine6.0.10.55478_Windows_x64.zip"> the engine</a>
Default: https://developer.axonivy.com/download/maven.html
User Property: ivy.engine.list.url
<osArchitecture> String - Engine type that will be downloaded if autoInstallEngine is set and the engine must be retrieved from the engineListPageUrl. Possible values are:
  • All_x64
  • Slim_All_x64
  • Windows_x64
All_x64 supports Linux and Windows. Slim_All_x64 supports Linux and Windows only with the necessary features (e.g. without demo-portal or axis).
Default: Slim_All_x64
User Property: ivy.engine.os.arch
<useLatestMinor> Boolean - If set to true it will download the latest available minor version
Default: false
User Property: ivy.engine.version.latest.minor

Parameter Details

<autoInstallEngine>

Enables the automatic installation of an ivy Engine in the engineDirectory. If there is yet no engine installed, or the ivyVersion does not match, the engine will be downloaded from the engineDownloadUrl and unpacked into the engineDirectory.
  • Type: boolean
  • Required: No
  • User Property: ivy.engine.auto.install
  • Default: true

<downloadUsingMaven>

Enables the engine artifact download via maven plugin repositories. If set to false, the default URL download approach is used (see engineDownloadUrl and engineListPageUrl properties).

As there exist no official maven repository containing the axonivy engine, it must be published manually to an accessible plugin repository. The expected artifact descriptor is:

groupId=com.axonivy.ivy
artifactId=engine
version=!ivyVersion! (e.g. 7.4.0)
classifier=!osArchitecture! (e.g. Slim_All_x64)
extension=zip
  • Type: java.lang.Boolean
  • Since: 7.4
  • Required: No
  • User Property: ivy.engine.download.from.maven
  • Default: false

<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.nio.file.Path
  • 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.nio.file.Path
  • Required: No
  • User Property: ivy.engine.directory

<engineDownloadUrl>

URL where a packed ivy Engine can be downloaded. E.g. https://developer.axonivy.com/download/6.0.10/AxonIvyEngine6.0.10.55478_Windows_x64.zip
  • Type: java.net.URL
  • Required: No
  • User Property: ivy.engine.download.url

<engineListPageUrl>

URL where a link to the ivy Engine in the expected ivyVersion exists. The URL will be used to download the required engine if it does not yet exist. The URL should point to a site providing HTML content with a link to the engine
e.g. <a href="https://developer.axonivy.com/download/6.0.10/AxonIvyEngine6.0.10.55478_Windows_x64.zip"> the engine</a>
  • Type: java.net.URL
  • Required: No
  • User Property: ivy.engine.list.url
  • Default: https://developer.axonivy.com/download/maven.html

<ivyVersion>

The ivy Engine version or version-range that must be used. Must be equal or higher than "12.0.0" 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
  • Required: Yes
  • User Property: ivy.engine.version
  • Default: 12.0.13

<osArchitecture>

Engine type that will be downloaded if autoInstallEngine is set and the engine must be retrieved from the engineListPageUrl. Possible values are:
  • All_x64
  • Slim_All_x64
  • Windows_x64
All_x64 supports Linux and Windows. Slim_All_x64 supports Linux and Windows only with the necessary features (e.g. without demo-portal or axis).
  • Type: java.lang.String
  • Required: No
  • User Property: ivy.engine.os.arch
  • Default: Slim_All_x64

<useLatestMinor>

If set to true it will download the latest available minor version
  • Type: java.lang.Boolean
  • Required: No
  • User Property: ivy.engine.version.latest.minor
  • Default: false