Building RexecJ

To build RexecJ, first extract the RexecJ source distribution rexecj_src-1.0.0.tar.gz. All files will extract to a directory named rexecj-1.0.0. RexecJ uses Apache Ant for building, so a copy of Ant version 1.6 or greater is required. Also, a copy of a Java 2 Development Kit (JDK) is required. Though RexecJ should work with any JDK version 1.2 or greater, it has only been tested with the Sun JDK versions 1.3.1 and 1.4.2.

Before RexecJ can be built, the environment variables JAVA_HOME and ANT_HOME must be set. For information on setting the JAVA_HOME environment variable, consult the setup section of the documentation. Then, make sure the ANT_HOME environment variable is set to the location of an Apache Ant installation. For example:

set ANT_HOME=c:\apache-ant

will set the location of the ANT_HOME environment variable to c:\apache-ant on Windows and

export ANT_HOME=/opt/apache-ant

will set the location of the ANT_HOME environment variable to /opt/apache-ant on a Unix-based operating system.

Once these steps have been completed, RexecJ can be built using the build executable, which is located in the build subdirectory of the RexecJ source tree. If no arguments are supplied to the build executable, then all RexecJ build targets will be built. This includes RexecJ source, Unix, and Windows distributions along with all documentation. The following targets can be supplied as arguments to the build executable to control the amount of the RexecJ source tree to be built:

  • all
    • This is the default target, and will build the RexecJ library, AES filter and configuration program, RexecJ documentation, API documentation, and the source, Unix, and Windows distribution files.
  • components
    • This target will build the AES filter and configuration program and the RexecJ implementation library.
  • dist
    • This target will build the dist_src, dist_unix, and dist_win targets.
  • dist_src
    • This target will build the RexecJ source distribution file, rexecj_src-1.0.0.tar.gz, to the dist subdirectory of the RexecJ source tree.
  • dist_unix
    • This target will build the RexecJ Unix distribution file, rexecj_unix-1.0.0.tar.gz, to the dist subdirectory of the RexecJ source tree.
  • dist_win
    • This target will build the RexecJ Windows distribution file, rexecj_windows-1.0.0.zip, to the dist subdirectory of the RexecJ source tree.
  • docs
    • This target will build the docs_api and docs_rexecj targets.
  • docs_api
    • This target will build RexecJ API documentation to the docs/api subdirectory of the RexecJ source tree.
  • docs_rexecj
    • This target will build RexecJ documentation to the docs/rexecj subdirectory of the RexecJ source tree.
  • filter_aes
    • This target will build the AES filter and its configuration program.
  • rexecj
    • This target will build the RexecJ library rexecj.jar to the lib subdirectory of the RexecJ source tree.

Valid XHTML 1.0! Valid CSS!