Rainbow/Installation Instructions

Rainbow :: git :: sources :: rainbow-0.8.6.tar.bz2 :: announcement

---

Last updated: Michael Stone 14:39, 30 November 2009 (UTC)

The basic idea is to install rainbow, either

from source:

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 >= 10: yum 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!

from a unified builder or image:

like sugar-jhbuild or Sugar on a Stick (SoaS). (nb: future work)

general setup:

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.

sugar+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:

   <allow user="*"/>

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:

touch /etc/olpc-security

Congratulations. You are now ready to test sugar with rainbow.