2.2 Installing Muse - Echomine Muse

Muse is an API, which means no pretty GUI interfaces or nice white-on-black console windows. You can only access the API programmatically. Therefore, Muse does not work by itself. To use it, you must include the Muse library and its required dependent libraries into your classpath.

Muse Dependencies & JDK Requirements

Muse is currently developed under JDK 1.4 on Windows. All releases before 0.81 are compatible with JDK 1.2+. All releases on and after 0.81 are now designated JDK 1.4+ only. Please note that I haven't tested the compiles under other JDKs. If you run into problems, report them to me so I can correct them. If you successfully run and compile the software under other platforms, let me know:

For versions on and after 0.8b1:

Sun JDK 1.4.x (All Platforms)
Apple JDK 1.4 (Mac OS X)

For versions before 0.8b1:

Sun JDK 1.3.x (All Platforms)
Sun JDK 1.2.2 (All Platforms)
Apple JDK 1.3 (Mac OS X)
Apple JDK 1.2 (Mac OS X)

Muse also uses third-party libraries. The required libraries are already distributed as part of the package, so no extra downloads are necessary.

JSSE?

JSSE, the API for working with SSL connections, is now required to compile Muse 0.8a2 and above. If SSL is not used, you do not need to include it in your classpath during runtime.
For those using JDK 1.4+, JSSE is already a part of the Java runtime environment. Therefore, you don't need to include the JSSE library to compile or run Muse.

Setting Classpaths

In order to compile your code with Muse, you must add the main Muse files to your IDE project's classpath or to your command line classpath.

In order to run your code that uses Muse, you must add the Muse files as well as the libraries it depends on to the classpath.

Setting Classpath Example

# Under Windows (classpath is incomplete)
set CLASSPATH=muse-0.8.jar;jakart-oro.jar;log4j.jar;commons-logging.jar;...

# Under Unix Bash shell (classpath is incomplete)
export CLASSPATH=muse-0.8.jar:jakart-oro.jar:log4j.jar:commons-logging.jar:...

Next Step: Ready, Start, Go!

After setting up your classpath properly, you are ready to run your code. You can test out Muse using the Muse examples provided in the distribution.

2.3 Running The Examples