BOOM
System Installation

There are 2 installation methods:

1. Download and install the BOOM JAR file.
2. Download the source code and compile the BOOM system.

If you simply wish to use BOOM, downloading the BOOM JAR file is the easiest method. If you wish to alter/enhance the BOOM system, or are interested in viewing the source code, then you should download the source code version.

A. Download and install the BOOM JAR file

1. Download the BOOM JAR file from the BOOM software page.
   
   
   
2. Uncompress the BOOM JAR file.
   
   example:
   
        gunzip boom.jar.gz
   
   
   
3. Copy the resulting BOOM JAR file to the desired Java^TM library file location.
   
   example:
   
        mv boom.jar /usr/local/lib/java
   
   
   
4. Add the BOOM JAR file to the Java^TM classpath.
   
   example (for tcsh):
   
        setenv CLASSPATH $CLASSPATH\:/usr/local/lib/java/boom.jar\:.
   
   example (for bash):
   
        CLASSPATH=$CLASSPATH\:/usr/local/lib/java/boom.jar\:.
        export CLASSPATH
   
   
   
5. Try running the test files.
   
   example:
   
       java boom.tests.XC4000Test
       java boom.tests.HSRATest
   
   NOTE:
       While running the test files, if java complains about insufficient memory, add:
   
       -mx200M (this 200M means 200 megabytes and was arbitrary)

B. Download the source code and compile the BOOM system

1. Download the BOOM source code from the BOOM software page.
   
   
   
2. Uncompress the BOOM source code file.
   
   example:
   
        gzcat boom.tar.gz | tar xvf -
   
   
   
3. Change into the expanded directory.
   
   example:
   
        cd boom
   
   
   
4. In Makefile, do the following:
• set JDK_BASE_DIR to the location of the JDK^TM.
  
  
  
5. Type "gmake" to compile the system.
   
   
   
6. If there were no errors while compiling, test the set by running the test files.
   
   example:
   
        java -mx200M -oss200M boom.tests.XC4000Test
        java -mx200M -oss200M boom.tests.HSRATest
   
   NOTE:
       -mx200M: means to increase the maximum heap size to 200 megabytes.
       -oss200M: means to increase the maximum stack size (per thread) to 200 megabytes.
   
       The choice of 200 megabytes is arbitrary.
   
   
   
7. If you are satisfied with the compiled system, generate the BOOM JAR file by typing "gmake jar".
   
   
   
8. Do steps A3-5.

If you have difficulty successfully installing the BOOM system, please email the error messages, along with your installation method and target machine specifications (example: machine model, JDK^TM version, OS version) to either:

• Michael Chu <mmchu@cs.berkeley.edu>, or
• Nick Weaver <nweaver@cs.berkeley.edu>

To BOOM: Online Documentation
Copyright © 1998, The Regents of the University of California
Date Last Revised: September 16, 1998