Difference between revisions of "Development Team/Chroot"

Latest revision as of 20:33, 23 February 2010

Status

sugar-chroot-0.1 released: see sugar-chroot

Purpose

You want to hack sugar. You don't want to fuss around. You want sugar-chroot.

Usage

As excerpted from the README:

sugar-chroot consists of simple scripts. Download and unpack them like so:

NV=sugar-chroot-0.1
curl http://dev.laptop.org/~mstone/releases/SOURCES/$NV.tar.xz | tar Zxf $NV.tar.xz
cd $NV

To use them, pick a supported distro:

DISTRO=debian
DISTRO=fedora

To configure:

echo $DISTRO > conf/distro
$EDITOR conf/$DISTRO.mk

Then run

sudo make r/distro

to install your chroot.

History

See http://wiki.sugarlabs.org/index.php?title=Development_Team/Chroot&oldid=36911 for the manual instructions which sugar-chroot automates.

@@ Line 1: / Line 1: @@
 === Status ===
-* Debian chroot construction has been automated: see [http://dev.laptop.org/git/users/mstone/puritan/snapshot/puritan-sugar.tar.bz2|puritan-sugar.tar.bz2] and its [http://dev.laptop.org/git/users/mstone/puritan/tree/README?h=sugar README] -- [[User:Mstone|Michael Stone]] 20:33, 1 August 2009 (UTC)
+* sugar-chroot-0.1 released: see [http://dev.laptop.org/git/users/mstone/sugar-chroot sugar-chroot]
-* Sugar continues to run happily in Squeeze chroots. --[[User:Mstone|Michael Stone]] 16:30, 3 July 2009 (UTC)
-* Sugar is now somewhat runnable from chroots. Jaunty and Squeeze have been tested recently; Fedora has not. --[[User:Mstone|Michael Stone]] 22:21, 23 May 2009 (UTC)
-=== Chroot Construction ===
+=== Purpose ===
-There are lots of ways to create appropriate chroots; e.g. by hand, with debootstrap, with mock, etc.
+''You want to hack sugar. You don't want to fuss around. '''You want sugar-chroot.'''''
-Here are some ideas to help you get started:
+=== Usage ===
-==== Ubuntu jaunty chroot ====
+As excerpted from the '''[http://dev.laptop.org/git/users/mstone/sugar-chroot/plain/README README]''':
-With ''recent'' versions of debootstrap, in order to get a working chroot, you want something like:
- export CHROOT=`pwd`/jaunty-root
+sugar-chroot consists of simple scripts. Download and unpack them like so:
- sudo debootstrap --arch i386 jaunty $CHROOT http://ubuntu.media.mit.edu/ubuntu/
- sudo chroot $CHROOT /bin/bash -l
- mount -t proc proc /proc
- mount -t devpts devpts /dev/pts
-==== Debian squeeze chroot ====
+ NV=sugar-chroot-0.1
-With debootstrap, in order to get a working chroot, you want something like:
+ curl http://dev.laptop.org/~mstone/releases/SOURCES/$NV.tar.xz | tar Zxf $NV.tar.xz
+ cd $NV
- export CHROOT=`pwd`/sid-root
+To use them, pick a supported distro:
- sudo debootstrap --arch i386 squeeze $CHROOT http://debian.lcs.mit.edu/debian
- sudo chroot $CHROOT /bin/bash -l
- # and some of the following:
- mount -t tmpfs tmpfs $CHROOT/tmp
- mount -t proc proc $CHROOT/proc
- mount -t devpts devpts $CHROOT/dev/pts
- mount -t selinuxfs selinux $CHROOT/selinux
-''Reference: http://www.debian.org/doc/manuals/reference/ch-tips.en.html ''
+ DISTRO=debian
+ DISTRO=fedora
-''Note'': you can use approx to cache packages across multiple runs for faster testing:
+To configure:
- apt-get install approx
+  echo $DISTRO > conf/distro
-  echo 'debian http://debian.lcs.mit.edu/debian' >> /etc/approx/approx.conf
+  $EDITOR conf/$DISTRO.mk
- /etc/init.d/approx restart
-  sudo debootstrap --arch i386 squeeze $CHROOT http://localhost:9999/debian
+Then run
-==== Fedora rawhide chroot ====
+ sudo make r/distro
-With mock, it would be more like:
- mock -r fedora-devel-i386 --init
+to install your chroot.
- mock -r fedora-devel-i386 --install yum
- mock -r fedora-devel-i386 --shell
-==== Gentoo chroot ====
+=== History ===
-Well, if you are familiar with regular Gentoo installation process(by using [http://www.gentoo.org/doc/en/handbook/ Handbook] instead of GUI stuff) you should know how to setup Gentoo chtoot :). Otherwise use these instructions.
+See http://wiki.sugarlabs.org/index.php?title=Development_Team/Chroot&oldid=36911 for the manual instructions which sugar-chroot automates.
-* Firstly, you need Gentoo stage tarball. You can borrow it from any [http://www.gentoo.org/main/en/mirrolrs2.xml mirror] (use releases/<platform>/current sub directory).
-* Lets think you are using stage3-i686-20090623.tar.bz2, then:
- mkdir chroot-gentoo
- tar xjpf stage3-i686-20090623.tar.bz2 -C chroot-gentoo
- mount -o bind /dev chroot-gentoo/dev
- mount -o bind /proc chroot-gentoo/proc
- chroot chroot-gentoo /bin/bash
-* To install sugar, use [[Community/Distributions/Gentoo|sugar-overlay]] or setup [[Development_Team/Jhbuild|sugar-jhbuild]] environment(with [[Community/Distributions/Gentoo#Packages|sugar-overlay]] you can install git packages as well).
-=== Sugar Installation ===
-==== jaunty chroot ====
- sed -ie "s/main/main universe/" /etc/apt/sources.list
- apt-get update
- apt-get install locales
- locale-gen "$LANG"
- dpkg-reconfigure tzdata
- apt-get install sugar sugar-activities
- # install your development tools here
- # patch (hopefully temporary) bugs
- sed -ie '114i\\        if not favorites_settings.layout: favorites_settings.layout = favoriteslayout.RingLayout.key' /usr/lib/python2.6/dist-packages/jarabe/desktop/favoritesview.py
-==== squeeze chroot ====
- apt-get update
- apt-get install locales
- dpkg-reconfigure locales
- # edit /etc/hosts
- apt-get install education-desktop-sugar
- # install your development tools here
- # fix broken hippocanvas (Debian bug#522231)
- echo "deb-src http://debian.lcs.mit.edu/debian squeeze main" >> /etc/apt/sources.list
- # echo "deb-src http://localhost:9999/debian squeeze main" >> /etc/apt/sources.list
- apt-get update
- apt-get install apt-src devscripts
- apt-src install python-hippocanvas
- cd *hippo*
- DEB_BUILD_OPTIONS=nostrip debuild -us -uc
- cd ..
- dpkg -i *hippo*.deb
-=== User Accounts ===
-For stupid reasons, it's necessary that Sugar run under a uid inside the chroot which exists as a real account outside the chroot. (Talk to the DBus people.)
-Consequently, ''as root'', run something like this ''both'' inside and outside the chroot:
- groupadd -g 64002 sugar
- useradd -m -u 64002 -g sugar -s /bin/bash sugar
-=== D-Bus ===
-Sugar wants to be able to use global state stored in both HAL and NetworkManager, both of which live on the system bus. Consequently, ''outside the chroot'', we need to
- sudo mount --bind /var/run/dbus $CHROOT/var/run/dbus
-before entering the chroot. (Mock uses unshare() to enter a new mount-point namespace since this makes garbage collection of mountpoints much easier.)
-=== X11 ===
-We need to point Sugar at an X server. One easy (but insecure) way to do this is to make a nested X server like so, ''outside the chroot'':
- Xephyr -ac :1 -screen 800x600x24 # 1024x768x24
-See the talk page for more secure alternatives.
-=== Running Sugar ===
-Then, inside the chroot, you can happily run sugar as user 'sugar' with something like
- sudo chroot $CHROOT /bin/bash -l
- su sugar -
- cd ~
- ulimit -c unlimited
- export DISPLAY=localhost:1
- export DBUS_SESSION_BUS_ADDRESS=$(dbus-daemon --session --print-address --fork)
- sugar
-Then pull up the frame, switch to the home view, and launch some activities!
-=== Cleaning Up ===
-To correctly delete a chroot that you no longer need, kill all processes running in the chroot, and
- sudo killall -u sugar
- export CHROOT=/path/to/my/chroot  # important!
- umount $CHROOT/var/run/dbus
- umount $CHROOT/proc
- umount $CHROOT/dev/pts
- umount $CHROOT/tmp
- rm -rf $CHROOT

Difference between revisions of "Development Team/Chroot"

Latest revision as of 20:33, 23 February 2010

Contents

Status

Purpose

Usage

History

Navigation menu

Search