Quick Info
Description
Apache Ant is a command-line tool that is used to automate the build and deployment of applications. This plugin calls the Ant executable to run one or more targets defined in a specified Ant script file and is very useful for quickly integrating legacy automation into your HCL Launch Processes. HCL Launch agents include distribution of Ant, which is used by default, but other versions can be used by providing the path to the Ant installation directory in your Process Step.Quick Info
Summary
You can use Apache Ant to build and deploy applications. The Apache Ant plugin automates the use of the Apache Ant command line tool.
This plugin includes one or more steps, click Steps for step details and properties.
Compatibility
This plugin supports Apache Ant version 1.6.5 or later.
This plugin runs on all operating systems that HCL Launch supports with the exception of IBM z/OS.
Installation
No special steps are required for installation.
History
The following table describes the changes made in each plugin version.
Version | Description |
---|---|
7 | Added translations for steps and properties |
Usage
Use the Apache Ant plugin to specify a build script to run or you can include the build script in the step. You can also specify command-line options in the step.
Before you begin
Verify that a Java Development Kit (JDK) is installed. The required version of the JDK depends on the version of Apache Ant that you are using. See the system requirements topic under Installing Apache Ant for details.
Step palette
To access this plugin in the palette, click Build > Build tools.
Steps
The following process steps are available in the Apache Ant plugin.
Ant
Use this step to run an Ant script.
Name | Type | Description | Required |
---|---|---|---|
ANT OPTS | String | One or more Ant-specific arguments, which are used in the ANT_OPTS environment variable. For example, -Xmx1024m or -XX:MaxPermSize=512m. Enter each argument on a separate line. | No |
ANT_HOME | String | The installation directory of Apache Ant. The default value is the ANT_HOME environment variable for the agent. | Yes |
Ant Properties | String | One or more Ant-specific arguments, such as using -v for verbose output. Enter each argument on a separate line. |
No |
Ant Script File | String | The name of the Ant script file. | Yes |
JAVA_HOME | String | The path to the Java installation to run Ant scripts. The default is the JAVA_HOME environment variable for the agent. |
Yes |
JVM Properties | String | One or more JVM-specific arguments, such as -Xmx=512m for maximum memory. Enter each argument on a separate line. |
No |
Properties | String | These properties are passed to the Ant command processor and are available by name in the Ant script. Enter each argument on a separate line in the following format: name=value. |
No |
Script Content | String | Defines the content of the Ant script. The content is written to the Ant script file and then the file is run. |
No |
Targets | String | One or more names of the targets to run in the Ant script file. Do not specify a target if you are using the default target. | No |