B.2. The Ccaffeine GUI

The Ccaffeine front-end GUI is part of the CCA tools distribution you installed above. But if you're running the exercises on a remote system and want to use the GUI (it is not required to complete the exercises), you will need to download and setup the GUI on your local system before you can use it. (It will work over an X11 connection to the remote system, if you have one, but we tend to find performance of Java tools like the GUI unacceptable and generally recommend running it locally and connecting to the remote system via an SSH tunnel, as described in Section A.3, “Tunneling other Connections through SSH”.)

B.2.1. System Requirements

These requirements apply to both Linux-like and Windows systems.

  • Java Software Development Kit >= 1.4. The java command must be in your execution path.

B.2.2. Downloading and Setting Up the GUI

  1. To use the GUI on your local system, you will need to download the ccafe-gui.jar and the convenience script to run it. The script to download depends on which operating system you're local system is running. For Linux-like systems, it is simple-gui.sh, and for Windows systems, it is simple-gui.bat. The files could be copied (using scp) from the CCA tools installation on the remote system (in the $CCA_TOOLS_ROOT/bin subdirectory), or (probably more conveniently) downloaded from http://www.cca-forum.org/tutorials/#sources.

  2. The scripts expect to be located in the same directory as the jar file. Instructions for using the scripts can be found in Section 2.1, “Using the GUI Front-End to Ccaffeine”.