Improve performance of the debian-etch-debootstrap OS
[ext/instance-debootstrap.git] / README
1 This is a guest OS definition for Ganeti (http://code.google.com/p/ganeti).
2 It will install a minimal version of Debian Etch via debootstrap (thus it
3 requires network access). This only works if you have a Debian-based
4 node or you have debootstrap installed by hand on another distribution.
5
6 You need to put these files in a directory under /srv/ganeti/os on all the
7 nodes of the cluster (e.g.  /srv/ganeti/os/debian-etch).
8
9 Notes:
10  - no password for root; simply login at the console
11  - no network interfaces defined (besides lo); add your own definitions to
12    /etc/network/interfaces
13
14 Since version 0.3, the OS will cache the image of the first instance it
15 installs using the name "cache-$arch.tar" (where $arch is what dpkg
16 --print-architecture returns). This cache will be then used on the
17 future installs, speeding them greatly (even with a fast mirror). Feel
18 free to remove the cache at any time, or to copy it to all nodes. The
19 cache will be kept for two weeks, after which the first install will
20 recreate the cache (in order not to use old packages). If you don't care
21 about package age, remove the user write permission (chmod u-w) from the
22 cache and ganeti will continue to use the same file without refreshing
23 it.
24
25 If you don't have enough space and don't want cache creation, just touch
26 the file 'no_cache' - this will prevent the creation, but the script
27 will continue to use a cache if it exists (but it will remove an
28 existing one after two weeks).
29
30 Also note that if the image file is there, the script does not need
31 network access at all.