Setting Up a Broker

Our implementation of the Broker is written in Java, and should therefore run on any platform which has a Java 1.1 environment. Sun Microsystems' implementation of Java (called the Java Runtime Environment) is freely available from JavaSoft. If you wish to develop in Java, you should get the Java Development Kit (JDK) instead.

The Broker itself is a stand-alone Java program, with class SE.kth.speech.broker.Broker. It takes two parameters: the port on which it listens for incoming TCP connections, and the password used to access some restricted features (such as changing the set of startable servers.)

To use the Broker, first you must download the Java classes. Then the supplied .jar (Java Archive) files must be added to the CLASSPATH (Under UNIX, CLASSPATH is an environment variable). Under tcsh, this is done with a command like (but you will hopefully want to put the files in a better place than /tmp):

setenv CLASSPATH /tmp/broker.jar:/tmp/broker/erl.jar

Then you can start a broker like this:

java SE.kth.speech.broker.Broker 4711 guess

Where 4711 is the port of the Broker, and guess is the password.

And bring up the Broker User Interface with (you might want to replace localhost with the host name you are running the broker on):

java SE.kth.speech.broker.GUI localhost 4711

Now you can try running the Java or Tcl examples if you want.

Previous: Implementing Modules, Up: The Broker, Next: The Broker's GUI