sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Application Server Utility | asant(1M)

- NAME
- SYNOPSIS
- DESCRIPTION
- TARGETS
- EXAMPLES
- SEE ALSO

## NAME

| asant - launches the Jakarta Ant tool

## SYNOPSIS

| `asant target_list`

## DESCRIPTION

| Use the `asant` command to automate repetitive development and deployment tasks. `asant` is a shell script that invokes the underlying Ant infrastructure after initializing the environment to pickup the application server installed targets. To use Ant as part of the Sun Java System Application Server, verify that your PATH includes the provided `asant` (Solaris) `ant.bat`(Windows) script. The bundled sample applications use `asant` extensively; however, `asant` can be used in any development or operational environments. The build targets are represented in the `build.xml` files that accompany the sample applications. To use the Ant tool to compile and reassemble the sample applications, verify that the `$AS_INSTALL/bin` directory is on your environment's path. On UNIX, add the `$AS_INSTALL/bin` directory to your PATH environment variable. On Windows, after installing the Sun Java System Application Server, set the system path by adding `$AS_INSTALL\bin` to the user PATH. You can access the PATH system variable from: Start menu, Settings, Control Panel, System, Advanced, Environment Variables, User Variables for Administrator, PATH. The target_list is one or more space separated tasks as described below.

## TARGETS

| `compile` compiles all Java source code. `jar` assembles the EJB JAR module. `war` assembles the WAR file in `<sample_dir>/assemble/war` `ear` assembles the EAR file in `<sample_dir>/assemble/ear` `core` (default) compiles all sources, builds stubs and skeletons; and assembles EJB JAR, WAR and EAR files. This is the default target for all `build.xml` files shipped in the Sun Java System Application Server. `javadocs` creates Java docs in `<sample_dir>/javadocs` `all` builds core and javadocs , verifies and deploys the application, and adds the resources.. `deploy` deploys the application and automatically expands the EJB JAR; does not install Javadocs. `undeploy` removes the deployed sample from the Sun Java System Application Server. `clean` removes `<appname>/build/` and `<appname>/assemble/` and `<appname>/javadocs` directories. `verify` verifies the deployment descriptors in the sample.

## EXAMPLES

| Example 1. Compiling and Assembling a Sample Application
| Using the simple stateless EJB sample as an example, execute several of the build targets as follows:
    cd install_root/samples/ejb/stateless/simple/src
Execute the `compile` target to compile the Java sources as follows:
    asant compile
Execute the `war`, `ear`, and `ejbjar` target to assemble the J2EE module files and the EAR file as follows by:
    asant jar
    asant war
    asant ear
Alternatively, all the above tasks can be accomplished by:
    asant core
Since the default build target is `core` you can execute `asant` without any arguments to rebuild the entire application.
Example 2. Building Web-based Applications
| You can build everything, including installing Javadocs, and deploying the application by:
    asant all
Additionally, you can build everything, except the Javadocs, but deploy the application by:
    asant core
    or just,
    asant
    then,
    asant deploy
To rebuild the `ear` after you have modified the deployment descriptors without recompiling:
    asant ear
    asant deploy

## SEE ALSO

| Apache Software Foundation at http://www.apache.org, Jakarta Ant documentation at http://jakarta.apache.org/ant/index.html. SUNWant documentation located in /usr/sfw/share/doc/ant , `asadmin`(1M)

| Go To Top | Last Changed April 2004

Company Info | Contact | Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.