Last updated: Michael Stone 14:39, 30 November 2009 (UTC)
The basic idea is to install rainbow, either
Note: Building rainbow from source requires packages equivalent to gcc, libc-dev, python2.5 or python2.6, and python-setuptools.
RAINBOW=rainbow-0.8.5 wget http://dev.laptop.org/~mstone/releases/SOURCES/$RAINBOW.tar.bz2 tar xf $RAINBOW.tar.bz2 && cd $RAINBOW make build sudo make install
from a distro package:
- Fedora rawhide: yum install rainbow
- Debian unstable: aptitude install rainbow
- Ubuntu: Bernie's PPA contains some basic rainbow packages which you can install.
- Other: Install rainbow from source or help others by packaging it for your distro!
In order for rainbow to function, you need to inject its users and groups into the system by running:
sudo /bin/sed -i -e s/^passwd:/passwd:\ rainbow/ /etc/nsswitch.conf sudo /bin/sed -i -e s/^group:/group:\ rainbow/ /etc/nsswitch.conf
If you are installing on a system (like Debian squeeze) that uses nscd, then you must restart nscd for rainbow to function:
sudo /etc/init.d/nscd restart
To use the current "rainbow-easy" helper, you need to have an "audio" group on your system:
sudo groupadd -f audio
Congratulations. You are now ready to test rainbow.
To use Rainbow with Sugar Activities, you need to add the following line to /etc/dbus-1/session.conf inside the <policy context="default"> section:
This will allow other uids besides yours to access your session bus. This might allow people on the same machine to control your applications and access your data, so only make this change if you're fine with that (e.g. no one else or only trusted ones using your computer). (We hope to improve on this situation in the future.)
Similarly, you will need to run something like
sudo cat >> /etc/orbitrc <<EOF # resp. ~/.orbitrc ORBIIOPIPv4=1 ORBLocalOnly=1 ORBIIOPUSock=0 EOF
if you want your sugar activities to be able to access GConf. As above this will allow other uids besides yours to access your ORBit2 CORBA ORB. This might allow people on the same machine to control your applications and access your data, so only make this change if you're fine with that (e.g. no one else or only trusted ones using your computer). (We hope to improve on this situation in the future.)
Next, unless you're running a really recent version of sugar (>= 0.86), you'll need to install two patches:
curl 'http://dev.laptop.org/git/users/mstone/sugar/patch/?id=71df9fadd59ea5cc08a414f5d25a0135395533e5' | patch /usr/share/pyshared/jarabe/view/service.py curl 'http://dev.laptop.org/git/users/mstone/sugar-toolkit/patch/?id=a65c8d2148ba5028437114049027e594238f2ed8' | patch /usr/share/pyshared/sugar/activity/activityfactory.py
To use rainbow-0.8.5 or later, you'll need to add "-o", "network" to the list of arguments specified in the second patch above.
patch -p2 -d /usr/share/pyshared <<EOF --- a/src/sugar/activity/activityfactory.py 2009-11-30 14:24:25.000000000 +0000 +++ b/src/sugar/activity/activityfactory.py 2009-11-30 14:30:28.000000000 +0000 @@ -261,6 +261,9 @@ class ActivityCreationHandler(gobject.GO '-u', pwd.getpwuid(os.getuid()).pw_name, '-i', environ['SUGAR_BUNDLE_ID'], '-e', environment_dir, + '-o', 'network', + '-o', 'audio', + '-o', 'video', '--', ] + command EOF
- Add the following line to /etc/sudoers using visudo
sugar ALL=SETENV: NOPASSWD: /usr/bin/rainbow-run
Finally, you need to tell sugar to use rainbow:
Congratulations. You are now ready to test sugar with rainbow.