Hacking
This page has information for people who are interested in hacking on CloudCoder.
Step 1. Visit the project page and fork the repository.
Step 2. Clone your fork to produce a development repository on your development computer.
Step 3. Import your local repository and the projects it contains into Eclipse. (File → Import → Projects from Git → Local, select the repository directory, and import all projects from it). Note that you will need to have the Google Plugin for Eclipse installed. Only GWT is required (you can leave out the Android and Google App Engine components.)
Step 4. Your development computer should have MySQL server running. The "root" account should have username "root". (This matches the default development configuration settings.) On Ubuntu, just install mysql-server. On a Mac, you can use MAMP. (We have not tried running CloudCoder on Windows.)
Step 5. Create an initial cloudcoder.properties file by running the command ./configure.pl in the top-level directory. Here is an example run:
Welcome to the CloudCoder configuration script!
Please enter the information needed to configure CloudCoder for your system.
You can just hit enter to accept the default value (if there is one).
Where is your GWT SDK installed (the directory with webAppCreator in it)?
==> /home/dhovemey/linux/java/gwt-2.5.0
########################################################################
>>> Database configuration properties <<<
########################################################################
What MySQL username will the webapp use to connect to the database?
==> root
What MySQL password will the webapp use to connect to the database?
==> root
What MySQL database will contain the CloudCoder tables?
[default: cloudcoderdb] ==>
What host will CloudCoder connect to to access the MySQL database?
[default: localhost] ==>
If MySQL is running on a non-standard port, enter :XXXX (e.g, :8889 for MAMP).
Just hit enter if MySQL is running on the standard port.
==>
########################################################################
>>> Login service properties <<<
########################################################################
Which login service do you want to use (imap or database)?
[default: database] ==>
########################################################################
>>> Builder properties <<<
########################################################################
What host will the CloudCoder webapp be running on?
(This information is needed by the Builder so it knows how to connect
to the webapp.)
[default: localhost] ==>
How many threads should the Builder use? (suggestion: 1 per core)
[default: 2] ==>
What port will the CloudCoder webapp use to listen for connections from
Builders?
[default: 47374] ==>
########################################################################
>>> TLS/SSL (secure communication between webapp and builder(s) <<<
########################################################################
Do you want to use the default keystore
(Answer 'yes' for development, 'no' for production)
[default: no] ==> yes
########################################################################
>>> Web server properties (webapp) <<<
########################################################################
What port will the CloudCoder web server listen on?
[default: 8081] ==>
What context path should the webapp use?
[default: /cloudcoder] ==>
Should the CloudCoder web server accept connections only from localhost?
(Set this to 'true' if using a reverse proxy, which is recommended)
[default: true] ==>
Write configuration file (cloudcoder.properties)?
[default: yes] ==>
Writing properties...Done!
