SLAMD Distributed
Load Generation Engine
Version 2.0.0-alpha1

Building SLAMD

If you have checked out the SLAMD source code from the Subversion repository, then you can compile and package it for yourself as well. This may be done by using the Apache Ant utility, although a shell script ant batch file have been provided to simplify the process.

At present, Java version 1.4 or higher must be used to build SLAMD. It has also been tested with Java 5 and Java 6. In many cases, if a suitable Java version is specified using the JAVA_HOME environment variable, or if a suitable java executable is available in your environment path, then the only thing that you will need to build SLAMD is to issue the command "./build.sh" on UNIX or "build.bat" on Windows. In the event that it can't determine which Java installation to use, then you will need to explicitly specify it by setting in the JAVA_HOME environment variable.

There are a number of build targets available for use, but in most cases, the default "package" target will be sufficient. Other targets that are available include:
  • clean -- Remove any files created by a previous build.

  • build -- Just compile the main SLAMD source.

  • rebuild -- Replace the compiled classes and JAR files in a previous "package" or all" build with new versions created from the current source without destroying any existing configuration or data.

  • package-war -- Package the SLAMD server code into a WAR file.

  • javadoc -- Build JavaDoc documentation for the SLAMD codebase.

  • all -- Build and package the full SLAMD distribution, create a WAR file, and generate the JavaDoc documentation.
When the build is complete, the built directory will contain the compiled class files, the package directory will contain the SLAMD server and client packages and optionally a WAR file for deployment in an external Web container. The javadoc directory will contain the generated JavaDoc documentation.