The buildomatic scripts depend on both Java and Apache Ant. Two common configuration errors are possible when attempting an installation using these scripts (if you're not using the included, bundled Apache Ant).

Missing Java JDK

If you have the Java JRE (Java Runtime Environment) instead of the JDK, you won't have all the required utilities. In particular, you may see an error referring to the tools.jar, as in the following message:

The solution is to download and install the Sun Java JDK, labeled as the Java SE Development Kit on the Oracle web site.

If you're upgrading JasperReports Server, you can also use the Java 1.6 JDK bundled in the previous version, as described in the JasperReports Server Upgrade Guide.

Forgot to Copy the File ant-contrib.jar

If you're using your own version of Ant and your Ant instance doesn't have the ant-contrib.jar in the lib directory, you'll get an error similar to the following:

BUILD FAILEDc:js-buildsjasperserverbuildomaticinstall.xml:6:[/code]                    

Ant failed to create a task or type. To correct the error, copy <js-install>/buildomatic/extra-jars/ant-contrib.jar to your <apache-ant>/lib directory.

Failure with '$' Character in Passwords in Buildomatic Scripts

If your password in buildomatic scripts includes two of more '$' characters in a row, Ant will not accept it. This issue does not occur when dollar signs are separated by other characters. For example, $pas$word$ or pas$word$ will not fail.

If you have two consecutive dollar signs, you'll need to escape each with three more dollar signs. For example, if your password is pa$$word, enter it as pa$$$$$$$$word in the configuration file. Once you do this, JasperReports Server will set all data connections to pa$$word.

Older Apache Ant Version

As of release 6.1 of JasperReports Server, Apache Ant version 1.9.4 or later is recommended. The earliest compatible version is Ant 1.8.1.

BUILD FAILEDc:js-buildsjasperserverbuildomaticinstall.xml:37:Problem: failed to create task or type componentdef[/code]                        

To check your version of Ant and verify that it's at a high enough level, enter:

ant -version

If you have a earlier version of Ant, check to see if it's set in your class path by entering:

echo $CLASSPATH

To use the JasperReports Server version of Ant, update your CLASSPATH variable to point to the <js-install>/apache-ant/bin directory.