THE JAM PROJECT


Installing JAM Version 2.11

Install JDK 1.1

JAM 2.1 requires JDK 1.1, which you can download from the main Sun Java site.

Install JAM Version 2.11 on Solaris

  1. Download the compressed tar file JAM-2.11.tar.gz (contains only
    the JAM classes). The complete JAM source tree can be obtained
    by sending e-mail to Pr. Stolfo

  2. Extract the contents of the tar file
    These instructions assume that you will install the JAM package in your home directory. 
        Example:
        % cd $HOME
        % gunzip JAM-2.11.tar.gz
        % tar -xvf JAM-2.11.tar

  3. Update your CLASSPATH to include the JAM src directories 
        Example: (csh)
        % setenv CLASSPATH $CLASSPATH:$HOME/JAM-2.11/src/

    Example: (ksh)
        % export CLASSPATH=$CLASSPATH:$HOME/JAM-2.11/src/

  4. In your home directory ($HOME), create the directory "JAM_bin/sparc" (for sparc stations) or "JAM_bin/x86" for PCs, where you may install the graph tool executables (the dot program from AT&T). 
    
    Example:
        % mkdir -p $HOME/JAM_bin/sparc
        % mv dot $HOME/JAM_bin/sparc/

  5. Add $HOME/JAM_bin/ to your PATH variable 
        Example: (csh)
        % setenv PATH $PATH:$HOME/JAM_bin

    Example: (ksh)
        % export PATH=$PATH:$HOME/JAM_bin

  6. Move the directory $HOME/JAM-2.11/JAMimages/ into your public html directory
    and make sure that all the image files are world-readable. 
    
    Example: 
        % mv $HOME/JAM-2.11/JAMimages $HOME/html
    Alternatively you can make a link to the JAMimages directory. 
    
    Example: 
        % cd $HOME/html
        % ln -s $HOME/JAM-2.11/JAMimages JAMimages

Install JAM Version 2.11 on Window NT/Windows 95

  1. Download the compressed tar file JAM-2.11.tar.gz. (contains only the JAM classes). To obtain the complete source tree, send e-mail to Pr. Stolfo . Assuming that you want to install JAM-2.11 under your C:\JAM-2.11 :

  2. Point your archive utility to extract the archive into the destination directory

  3. drag JAM-2.11.tar into the recycle bin (optional)

  4. Copy the C:\JAM-2.11 directory under the JDK1.1.6 directory (assuming you have JDK1.1.6 installed)

  5. Update your $CLASSPATH of the AUTOEXEC.BAT script (in Windows 95) to include C:\JAM-2.1\src or modify the CLASSPATH environent variable from your control panel/System (Windows NT)

  6. Create A JAM_bin\x86 folder under C:\

  7. Optional: Install dot.exe (the graph visualization program from AT&T) under C:\JAM_bin\x86
Known problem : Depending on the Windows 95 version, JAM may complain that it cannot find JAM_bin.

Problem fix : Repeat step 5, but create the folder under the JDK1.1.6 (assuming you have JDK1.1.6 installed)

Test JAM using Demo Environment

JAM 2.11 contains several test environment by which you may verify that the software was installed correctly, as well as demo the program. The test environments can be found in the directory JAMHOME/JAM-2.11/demo/' where JAMHOME is the directory in which you unpacked the JAM package. (If you followed the installation directions exactly, JAMHOME should be your home directory. Otherwise it's the directory where you extracted the JAM files)

Test Environments

crx

[Description]

thyroid

[Description]

Each test environment contains Datasets and configuration files for 2-3 JAM sites (clients). The only work you will need to do in preparation for running JAM on one of the datasets is to make minor modifications to each of the JAM client configuration files. For example, to run JAM with 3 participants on the SJ data, you must edit the configuration files:

Edit the Configuration Files provided in the Test Sets

The configuration files provided in the test sets require little modification. The following steps will guide you through the necessary edits. For a detailed explanation of the structure and content of a JAM configuration file click here.

  1. Edit the CONFIGFILE_HOST and CONFIGFILE_PORT variables The Configuration File Manager functions as an organizer of JAM participants -- registering JAM sites and answering queries from JAM sites about who their peer JAM sites are. In the example below, the host has been set to dynamo.cs.columbia.edu and to port to 8175 . 
    # The host for Configuration File Manager
##############################################
CONFIGFILE_HOST=dynamo.cs.columbia.edu
CONFIGFILE_PORT=8175

  2. Edit the IMAGE_DIR_URL variable. The Image Directory contains all images (gifs) required by a JAM site. In addition, each JAM site is identified by a unique image. when JAM sites trade agents, an image (the URL) of the agent travels from the source to the destination for display on the recipient's JAM interface.

    If you followed the installation directions exactly, the IMAGE_DIR_URL is the JAMimages/ directory which you installed in your public html directory. The example below is for the JAM site identified as "mango". 

    # The directory containing images for
# standard parts of the animation.
#
#  Note: Expected gifs in this directory include:
#    data.gif     ...representation of data
#    local.gif    ...local representation of this JAM site
#    engine.gif   ...representation of learning engine
#    default.gif  
#    metac.gif	  ...meta-classifier image
##############################################
IMAGE_DIR_URL=http://www.cs.columbia.edu/~andreas/JAMimages/mango/

And that's it. Follow the steps for editing the configuration file for each JAM client. You are ready to run JAM.

How to Run JAM


Columbia University, September 1997. Last Modified: June 5, 1998
andreas@cs.columbia.edu