Install Setup

Currently, the only supported platform is Ubuntu Linux. The instructions are untested with other distros, but they should work with slight modifications (eg. yum on RedHat/CentOS/Fedora instead of apt-get, and equivalent package names). On MacOS X Java 6 is poorly supported, and may or may not run on your machine. You might be better off trying to modify CBCJVM to work under Java 5 or using a virtual machine to run Ubuntu on top of your machine for builds (we recommend the free VirtualBox). On Windows, everything should work, except for the few bash-based build scripts (the build process is mainly Ant and Maven based). Windows support is a priority, and should be an easy project for anyone who wishes to take on the task.

Ubuntu Setup

All of these commands, unless otherwise specified, are to be executed in a bash (terminal) environment. On a fresh Ubuntu install, that would be found under the top left “Applications” menu, “Accessories”, “Terminal”. If a command asks for your password, it is referring to your root (administrative) password. If you have no idea what this means, please contact your system administrator.

1. Open the “Software Sources” application by going to the “System” menu at the top left of your screen, “Administration”, “Software Sources”
2. Ensure the box “Community-maintained Open Source software (universe)” is checked, if not, check it.
3. Close the window. If you are prompted to update your package list, click the “Reload” button.
4. Check and see if you have a copy of JDK 6 by running:
   

   $ javac -version

   
   You should see something like:
   

   $ javac 1.6.0_18

   
   If it gives a version prior to 1.6.x_x, update your system. If it complain that javac is not found, run
   

   $ sudo apt-get install default-jdk

5. Now, install the additional dependencies:
   

   $ sudo apt-get install ant git-core maven2

   
   If you already have one of those pieces of software, you can still run the command without fear. Aptitude won’t attempt to reinstall the software.
6. Navigate into the directory you want the repository folder to be downloaded to:
   

   $ cd “/directory/on/drive”

   
   Pull (download) a copy of CBCJVM:
   • Download the latest version (possibly unstable):
     

     $ git clone git://github.com/catron/CBCJVM.git
     
     $ cd CBCJVM

   • Download a specific (``stable") version:
     

     $ git clone git://github.com/catron/CBCJVM.git
     
     $ cd CBCJVM
     
     $ git tag -l
     
     $ git checkout 10.6

     
     (git tag -l is optional, it will list all available versions. Replace ‘10.6’ with whatever version number you desire.)
     If you are unsure as to what version you should download, it is recommended that you consult someone on the Botball community chat .
7. Compile CBCJVM:
   

   $ sh BuildEverything.sh

8. The CBC installer and corresponding README file can now be found in CBCJVM/installer/install.