In order to run Lime, you will need an installation of Java 1.2 or higher. See Sun's page for information about how to download and install Java. After this and downloading Lime itself, the installation of Lime is fairly straightforward. Essentially, it consists of unpacking the tarball and setting the CLASSPATH. A little bit more detail is provided below.

  1. Decompress the distribution files limejars1.xx.tar.gz in a directory of your choice, e.g., C:\myDir. Tools like WinZip, or cygwin's tar will do just fine.
  2. Add the location of lime.jar, location.jar, groupmgmt.jar to your CLASSPATH environment variable:
  3. from a MS-DOS prompt:
    set CLASSPATH = %CLASSPATH%;C:\myDir\lime.jar;C:\myDir\location.jar;C:\myDir\groupmgmt.jar
    from a Unix shell:
    C shell:
    setenv CLASSPATH $CLASSPATH:/myDir/lime.jar:/myDir/location.jar:/myDir/groupmgmt.jar
    export CLASSPATH =
  4. Lime currently requires the use of the LighTS tuple space implementation. You must include lights.jar in your CLASSPATH.
  5. If you intend to us a GPS unit with lime, you should also include comm.jar in your CLASSPATH.
  6. If you intend to use the µCode mobile agent toolkit in conjunction with Lime, you must include mucode.jar in your CLASSPATH. Although a version of is available in the Lime download, you should consider downloading the most up to date version of and follow its installation instructions.

Testing Multicast

In order to have multiple hosts participate in a Lime community, each host will need the ability to send and receive multicast packets. In our own testing, we have discovered network configuration problems where a host was not able to receive multicast. Therefore, we have made it easy to test whether a set of machines can hear multicast messages from one another. In the examples/simpleExamples directory available within the distribution, you will find a file If you compile and run this application (by simply executing java McastTest) on each of the hosts which you hope to include in the Lime community, you will be able to tell if they can send and receive multicast packets. For more detail about the expected output of this program, see the header in the source of


The source files for Lime are available under CVS for anonymous download from the SourceForge site. For more details on how to access the CVS repository, see the CVS page for Lime.

LIME: Linda in a Mobile Environment