Bash Shell for Solaris, IBM AIX, HP UX and FreeBSD

To execute the js-install shell scripts described in Chapter 5 of this guide, the bash shell is required. The js-install and js-upgrade scripts which are found in the buildomatic folder are the following:

The bash shell is not included by default in all Unix platforms. In the case where the bash shell is not available, it is necessary to download and install the bash shell. Bash shells are available for the following platforms:





Alternatively, you can manually run the same “buildomatic” Ant targets that are run by the js-install script. These Ant targets are listed in Troubleshooting Your JasperReports Server Configuration.

Also, check that you have updated your local Ant to include the ant-contrib.jar which supports conditional logic in Ant. The ant-contrib.jar is found in the location below and it should be copied to your <ant_home>/lib folder:


For updating your local Ant instance with the ant-contrib.jar see Forgot to Copy the File ant-contrib.jar.

If you try and use the bundled ant that is included with the JasperReports Server WAR file Distribution ZIP package, you may get the same non-bash syntax error. You may get the error below, for example:

js-ant help-install

ANT_HOME=../apache-ant: is not an identifier

If you have the bash shell installed, you can try executing the js-ant command by calling bash explicitly, for example:

bash js-ant help-install