NOTE: This project is no longer developed. Visit our main page to see list of current projects.

Installing the CogBox

Installation

The build setup, as has the organization of the code, has been completely redone with this version of the CogBox. I have moved from Makefiles to using ant, which is much more interesting and useful. Build instructions are as follows:

Edit the cogbox.xml file and look for this line close to the top:
```
<property name="cogjar"  value="/l/extreme/java/cog/0.9.11/dist/cog.jar" />            
        
```
Change the "value" string of this property to match your local cog installation - if you don't have a cog.jar file you can specify a list of directories and jar files in the traditional classpath format and ant will figure the rest out. If you are using the one-jarfile method, make sure you have also added the jars which are included in the CoG distribution lib directory, as the cogbox build and run routines expect the classpath to contain everything required to build/run cog-based programs. Make sure you put this in quotes!
Set the value of JAVA_HOME in the build.sh script (or, for cygwin users you must edit the cygwin-build.sh script) to point to your local java installation. If you already have JAVA_HOME set in your environment you may comment out the line where it's set in the script.

That's it. To build type:

    % ./build.sh

Or, if you are in the cygwin environment:

    % ./cygwin-build.sh.

This should compile all the sources and build the jar for you.

Setup

The CogBox needs a few things from you in order to function happily. First of all, it needs a directory space in which to store some information. The default location of this directory is $(HOME)/.cogbox/. This value may be overridden by setting the environment variable COGBOX_HOME to a directory of your choice. In either case, please make sure the directory exists. Once you have established a working directory for your CogBox, you need the following:

A properties file : The default location of this file is $(HOME)/.cogbox/cogbox.properties. If you have set the COGBOX_HOME environment variable then the location will be $(COGBOX_HOME)/cogbox.properties. You may also override this value by setting the environment variable COGBOX_PROPERTIES_FILE.
Inside the properties file you need the following variables:
- gsiftp=machine1.my.domain,machine2.my.domain,[...]
  This variable lists the machines for which you have gsiftp permissions. Make sure there is no whitespace in the list!
- anonuser=someguy@somehost.someorg
  This variable indicates the email address to give when attempting anonymous FTP connections.
An rsl directory : The Cogbox needs a directory into which it will place RSL files that will be visible from your Playpen. The Playpen is a tool which allows you to verify RSL files for use in instantiation tasks. The default value for this directory is $(HOME)/.cogbox/rsl/. If you have set the COGBOX_HOME environment variable then the location will be $(COGBOX_HOME)/rsl/. You may also override this location by setting the COGBOX_RSL_DIRECTORY environment variable.

Congratulations, you're ready to run the CogBox!

[Download the Software] [Return to main page] [How to Use the Cogbox]

Last modified: Tue Apr 10 16:31:19 EST 2001