Installation


In order to run µCode, you need a working installation of Java 1.1 or higher. See Sun's page for information about how to download and install Java. 
Then, the installation of µCode is rather straightforward. Essentially, it consists of unpacking the tarball and setting the CLASSPATH. In case you are not confident with this procedures, a little bit more detail and help is provided below. 
Pay attention to the fact that the trees of both sources and binaries are rooted at the directory mucode.latest.


Binaries

  1. Decompress the distribution file mucode1.0.tar.gz in a directory of your choice, e.g., in the root \. Tools like WinZip, or cygwin's tar will do just fine. 
  2. Add the jar files in the distribution (mucode.jar, mucode.util.jar, mucode.abstractions.jar)  to your class path:
  3. for MS-DOS prompt:
    set CLASSPATH = \mucode.latest\mucode.jar;\mucode.latest\mucode.util.jar;\mucode.latest\mucode.abstractions.jar;%CLASSPATH%
    for Unix shells:
    (csh)    setenv CLASSPATH /mucode.latest/mucode.jar:/mucode.latest/mucode.util.jar:/mucode.latest/mucode.abstractions.jar:$CLASSPATH (bash)  export
    CLASSPATH=/mucode.latest/mucode.jar:/mucode.latest/mucode.util.jar:/mucode.latest/mucode.abstractions.jar:$CLASSPATH
    Alternatively, you can invoke the JVM using the -classpath option. See the documentation of your Java installation for more information about the class path. Here is a pointer to the one for Sun's JDK.

Sources

  1. Decompress the distribution file mucode1.0-sources.tar.gz in a directory of your choice, e.g., in the root \. Tools like WinZip, or cygwin's tar will do just fine. If you already installed the binaries, you may want to install the sources in the very same directory. 
  2. Add the source directory to the class path. If you already installed the binaries above, be careful that the source directory must come before the jar files. Thus, 
  3. for MS-DOS prompt:
    set CLASSPATH = \mucode.latest\sources\;%CLASSPATH%
    for Unix shells:
    (csh)      setenv CLASSPATH /mucode.latest/sources/:$CLASSPATH 
    (bash)    export CLASSPATH=/mucode.latest/sources/:$CLASSPATH

© 2000, Gian Pietro Picco - Last modification: 07/09/00