Apache Ant

Sun Java™ System Application Server provides you with Apache Ant and the asant command. The asant command is a shell script available from the application server bin directory. asant invokes the underlying Ant infrastructure after initializing the environment to pick up the application server installed targets.

The Project Open ESB (Enterprise Service Bus) Starter Kit adds jbi ant tasks and required libraries to the asant library directory.

For more information about Ant, see the Apache Software Foundation website: http://ant.apache.org/

For more information about using asant, refer to your application server documentation. The following links provide information for using asant with Sun Java™ System Application Server Professional Edition 8.1: http://docs.sun.com/app/docs/coll/1343.1

Using asant to Invoke Open ESB Starter Kit Targets

Use the following syntax to invoke the targets. Make sure the asant utility that you are invoking is from the application server that is hosting the enterprise service bus that you installed. 

asant -f jbi-install-root/bin/jbi_admin.xml [options] [target]
Parameter Values Description
f Specify a path to a build file. Path to the build file containing Open ESB Starter Kit Ant targets. The default path is:
jbi-install-root/bin/jbi_admin.xml

jbi-install-root is where you installed the Open ESB Starter Kit.
options -Dproperty=value Specify a property name/value pair that is valid for the target.
target 
install-component
uninstall-component
install-shared-library
uninstall-shared-library


deploy-service-assembly
undeploy-service-assembly


start-component
stop-component
shut-down-component
start-service-assembly
stop-service-assembly
shut-down-service-assembly


list-service-engines
list-binding-components
list-shared-libraries
list-service-assemblies
Specify a valid target

Example

asant -f jbi-install-root/bin/jbi_admin.xml -Djbi.port=8686 list-service-engines

Standard Ant Options

You can also pass in any of the standard Apache Ant options when you issue the asant command. To view the standard options, issue the asant command with the -h option: 

asant -h

Copyright 2006, Sun Microsystems, Inc.