Setting Up

Sugarbot is installed and run in a manner very similar to most Activities. It also has an automated-launcher tool to be used in conjunction with a buildbot.

1. Get Sugarbot
• Download the latest stable package from the Downloads page.
• Perform an SVN update to get the latest development version of Sugarbot
• svn co http://sugarbot.googlecode.com/svn/trunk/sugarbot/ sugarbot.Activity
2. Copy the folder into your Sugar Activities folder.
• cp -R sugarbot ~/Activities/sugarbot.Activity
3. In order for sugarbot to start automatically, a small change must be made to the main.py in the Sugar distribution.
• In the sugarbot directory, there is a file named modded-main.py. It has been tested with the Ubuntu Hardy packages. Either:
1. Replace sugar/shell/main.py with modded-main.py
2. Diff the files and make the necessary changes for sugarbot

Configuring Sugar

Sugar runs without configuration out of the box. Simply rename sample-config.py to config.py.

config.py allows you to select the port that is used for connecting, as well as specify the IP address of the interface that the server listens on, and the IP address of that the clients will connect to.

Launching Sugar

• Launch the sugarbot XML-RPC server. The XML-RPC server is self-contained in sbrpcserver.py.
1. The syntax is: python sbrpcserver.py sugarbot_script
1. python sbrpcserver.py script_calculate.py script_terminal.py
• Two options are available for launching sugarbot:
• To automatically launch sugarbot when Sugar starts:
1. Launch Sugar by using the included sugarbotlauncher.py tool.
2. When all of the scripts have been executed from the XML-RPC server, the Sugar session will exit.
3. The return value will be 0 if all of the scripts executed without error, otherwise 1.
• To manually launch Sugarbot:
1. Launch Sugar.
2. Launch the sugarbot Activity (if you did not perform the step above). sugarbot will automatically contact the XML-RPC server, and run the provided script.

Using sugarbot with buildbot

An example master.cfg has been provided for using buildbot with sugarbot. It has been tested on Ubuntu Hardy Heron, using the Sugar and buildbot packages from the apt-get repository.

In order for Sugar to run properly, it may be required to enter the following command into the terminal: sudo xhost +. This enables X11 connections from any host, which is a requirement for buildbot to operate properly with Sugar.