Difference between revisions of "Development Team/Chroot"

From Sugar Labs
Jump to: navigation, search
(Fedora rawhide chroot)
m (moved Walter is a wanker 12/Chroot to Development Team/Chroot over redirect: revert)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
=== Status ===
 
=== 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
  
yum install febootstrap mock
+
to install your chroot.
  
 +
=== History ===
  
With mock, it would be more like:
+
See http://wiki.sugarlabs.org/index.php?title=Development_Team/Chroot&oldid=36911 for the manual instructions which sugar-chroot automates.
 
 
mock -r fedora-devel-i386 --init
 
mock -r fedora-devel-i386 --install yum
 
mock -r fedora-devel-i386 --shell
 
 
 
This is what you should see after you
 
ls
 
 
 
rawhide]# ls
 
bin  dev  home  media  opt  root  selinux  sys  usr
 
boot  etc  lib  mnt    proc  sbin  srv      tmp  var
 
 
 
This is said to work
 
sudo mock --init -r fedora-devel-x86_64 --uniqueext=sugar
 
 
 
Afterwords this should do the job
 
yum install sugar
 
 
 
==== Gentoo chroot ====
 
 
 
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.
 
 
 
* 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
 

Latest revision as of 21:33, 23 February 2010

Status

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.