In order to compile and run sample clients for that come with WSO2 products, it is necessary to install Apache Ant on Windows.
Refer to Installation Prerequisites for the list of all applications necessary to install and work with the WSO2 product you plan to install.
Follow the instructions below to install Apache Ant.
Make sure you have a JDK installed on your system. Refer to Apache Ant System Requirements for details.
1. Open a Web browser and access the following URL:
2. Apache Ant project home page opens. In the home page, click the link to the latest stable Apache Ant version.
3. Current version of the download page opens with links to the archive installation packs. Choose the necessary archive type and follow the link.
The binary edition of Ant is shipped with 3 different compression formats:
Choose the format that is best supported for your platform.
4. A dialog box opens with a request for download confirmation. Click "OK."
5. The download starts.
After the download is complete, extract installation files to the user-defined folder. For example, c:\wso2\apache-ant-1.8.2.
Before you run Ant, there is additional configuration you need to do:
Environment variables are global system variables accessible by all the processes running under the operating system.
Follow the instructions below to set up ANT_HOME.
1. Right-click the "My Computer" icon on desktop and select "Properties".
2. In the "System Properties" window, go to the "Advanced" tab and click "Environment Variables."
3. The "Environment variables" window opens. Click the "New" button under "System variables."
4. The "New system variable" input box opens. Type "variable name": ANT_HOME, and "variable value": <Ant installation directory>.
For example, c:\wso2\apache-ant-1.8.2. Click "OK."
5. ANT_HOME variable is added to system variables.
Follow the instructions below to add the "bin" directory to the PATH variable.
1. In the "System variables" list select PATH variable, and click "Edit."
2. The "Edit system variable" input box opens.
Add <ANT_HOME\bin> without quotes to "Variable value", where <ANT_HOME> is the Ant installation folder. Click "OK" once done.
For example, c:\wso2\apache-ant-1.8.2\bin.
3. The "bin" directory is added to the PATH variable.
"System variables" or "User variables"?
In case there is a need to set up variables only for the user currently logged in, JAVA_HOME should be set up in "User Variables" (the same way as in "System variables"). These changes will not affect any other users.
Variable set up will be effective for the CMD opened after this operation. In case a CMD was run before the variable was set up, this change will not be effective for it. To ensure the variable set up is effective, and variable value is reset, close and reopen the CMD you will run the product from, or close and reopen the browser you run the CMD from.
The ant.bat script makes use of three environment variables ANT_HOME, CLASSPATH and JAVA_HOME. Ensure that ANT_HOME and JAVA_HOME variables are set, and that they do not have quotes (either ' or ") and they do not end with \ or with /. CLASSPATH should be unset or empty.
Refer to Installing on Windows for instructions on setting the JAVA_HOME.
Apache Ant is installed.