]> gitweb.factorcode.org Git - factor.git/blob - unmaintained/raptor/readme
Merge branch 'master' into experimental
[factor.git] / unmaintained / raptor / readme
1
2 Raptor Linux
3
4 *** Introduction ***
5
6 Raptor Linux is a mod of Ubuntu 6.06 (Dapper Drake)
7
8 This is unlikely to work on another version of Ubuntu, much less
9 another Linux distribution.
10
11 *** Features ***
12
13   * /sbin/init is replaced with Factor
14   * Virtual terminals managed by Factor
15   * Listeners run on virtual terminals
16   * Native support for static ip networking
17   * Crontab replacement
18
19 *** Install ***
20
21   # mkdir -v /etc/raptor
22
23   # cp -v /scratch/factor/extra/raptor/{config,cronjobs}.factor /etc/raptor
24
25   ( scratchpad ) USE: raptor
26   ( scratchpad ) reload-raptor-config
27   ( scratchpad ) save
28
29   # mv -v /sbin/{init,init.orig}
30
31   # cp -v /scratch/factor/factor /sbin/init
32
33   # cp -v /scratch/factor/factor.image /sbin/init.image
34
35 *** Filesystems ***
36
37   # emacs /etc/raptor/config.factor
38
39 Edit the root-device and swap-devices variables.
40
41 *** Static IP networking ***
42
43 If you use a static IP in your network then Factor can take care of
44 networking.
45
46   # emacs /etc/raptor/config.factor
47
48   (change the settings accordingly)
49
50 The udev system has a hook to bring up ethernet interfaces when they
51 are detected. Let's remove this hook since we'll be bringing up the
52 interface. Actually, we'll move it, not delete it.
53
54   # mv -v /etc/udev/rules.d/85-ifupdown.rules /root
55
56 *** DHCP networking ***
57
58 If you're using dhcp then we'll fall back on what Ubuntu offers. In
59 your config.factor change the line :
60
61      start-networking
62
63 to
64
65         "loopback"   start-service
66         "networking" start-service
67
68 Add these to your reboot-hook and shutdown-hook :
69
70         "loopback"   stop-service
71         "networking" stop-service
72
73 *** Editing the hooks ***
74
75 The items in boot-hook correspond to the things in '/etc/rcS.d' and
76 '/etc/rc2.d'. Feel free to add and remove items from that hook. For
77 example, I removed the printer services. I also removed other things
78 that I didn't feel were necessary on my system.
79
80 Look for the line with the call to 'set-hostname' and edit it appropriately.
81
82 *** Grub ***
83
84 Edit your '/boot/grub/menu.lst'. Basically, copy and paste your
85 current good entry. My default entry is this:
86
87 title           Ubuntu, kernel 2.6.15-28-686
88 root            (hd0,0)
89 kernel          /boot/vmlinuz-2.6.15-28-686 root=/dev/hda1 ro quiet splash
90 initrd          /boot/initrd.img-2.6.15-28-686
91 savedefault
92 boot
93
94 I pasted a copy above it and edited it to look like this:
95
96 title           Raptor, kernel 2.6.15-28-686
97 root            (hd0,0)
98 kernel          /boot/vmlinuz-2.6.15-28-686 root=/dev/hda1 ro quiet -run=ubuntu.dapper.boot
99 initrd          /boot/initrd.img-2.6.15-28-686
100 savedefault
101 boot
102
103 * Note that I removed the 'splash' kernel option
104
105 * Note the '-run=ubuntu.dapper.boot' option. Unfortunately, this isn't
106   working yet...
107
108 *** Boot ***
109
110 Reboot or turn on your computer. Eventually, hopefully, you'll be at a
111 Factor prompt. Boot your system:
112
113   ( scratchpad ) boot
114
115 You'll probably be prompted to select a vocab. Select 'raptor'.
116
117 *** Now what ***
118
119 The virtual consoles are allocated like so:
120
121   1 - Main listener console
122   2 - listener
123   3 - listener
124   4 - listener
125   5 - getty
126   6 - getty
127
128 So you're next step might be to alt-f5, login, and run startx.
129
130 *** Join the fun ***
131
132 Take a loot at what happens during run levels S and 2. Implement a
133 Factor version of something. Let me know about it.
134