Obtain and install Java JRE 1.4.x.

Make sure that your path contains your Java 1.4.x java program

Downloading the binary zip at http://admc.com/jamama/dist/jamama.zip and unzip it.

The distribution will expand into a directory under your current directory named jamama. You may rename this directory if you wish. Jamama documentation refers to this directory on your computer as the JAMAMA_HOME .

If you don't want to set up your own runtime logging system, then copy the sample files in JAMAMA_HOME/localres to the same filenames without the .sample suffixes.

Copy the sample file in JAMAMA_HOME/config to the same filename without the .sample suffix.

Run Jamama. Set your classpath to contain all the jars in JAMAMA_HOME/lib, as well as JAMAMA_HOME/dist/jamama.jar and JAMAMA_HOME/localres. For example, if you are running a Bourne-compatible shell, you can set the shell variable JAMAMA_HOME to your JAMAMA_HOME directory path and run

    $ java -version    # To verify Java 1.4.x plus is in your search path
    ...
    $ export CLASSPATH
    $ CLASSPATH="${JAMAMA_HOME}/dist/jamama.jar:${JAMAMA_HOME}/localres"
    $ for jarfile in $JAMAMA_HOME/lib/*.jar; do
          CLASSPATH="${CLASSPATH}:$jarfile"
      done
    $ cd $JAMAMA_HOME  # Just so Jamama can find config/config.xml
    $ java com.admc.jamama.Jamama -i  # Omit the -i to run without a console

(Jamama does not need you to set the JAMAMA_HOME variable. I just had you do that to reduce the amount of typing you had to do above.) You can, of course, add anthing else that you want to your classpath. You may, for example, want to add the log4j jar file to the classpath.

Server instances that have <run> set to true in the config file will run. (If not, can tell them to run as instructed in the following steps).

Remember that if you want to make manual changes to the configuration file, you should make those changes while Jamama is shut down. The changes will be picked up during the next startup.

If you ran Jamama with the -i switch, for Interactive, you will have a console that you can type commands into. Type help and hit ENTER to get a list of valid commands.

Use the default JMX Interface, Sun's JDMK HTML Adaptor to view and modify your setup. Use a browser to connect to the hostname and port listed in a <jdmkHtmlAdaptor> element in the configuration file (the values default to any IP addr on your computer, and port 8082). Make sure that the <run> element is set to true on at least one jdmkHtmlAdaptor, of you will have no way to administer your setup other than with the console.

To stop Jamama, send EOD (typically Ctrl-Z or Ctrl-D) or "quit" or "exit" to the console; or use a JMX Interface to invoke the stop operation on the Jamama MBean.