Document instance variant creation
[ext/instance-debootstrap.git] / NEWS
1 Version 0.13
2 ------------
3
4 Improve documentation with regard to instance variants.
5
6
7 Version 0.12
8 ------------
9
10 A few small bugfixes:
11
12 - the defaults file is now installed automatically; even though all
13   settings are commented out, this allows for easier configuration
14 - require and check for a minimum device size; this makes error messages
15   much clearer, compared to tar's out of disk space errors (fixes issue
16   164)
17 - it is now possible to override the "components" argument to
18   debootstrap, to be able to install more packages (e.g. from contrib,
19   or from universe) (fixes issue 254)
20 - all existing hooks are now distributed in the archive and also
21   installed via `make install' (fixes issue 283)
22 - the console activation for xen-pvm hypervisor has been corrected;
23   before it was working only for kvm (fixes issue 284)
24
25
26 Version 0.11
27 ------------
28
29 The partition alignment offset is now configurable (using the
30 PARTITION_ALIGNMENT configuration setting, in sectors) and the
31 distribution names and packages in the defaults file have been updated.
32
33 Furthermore, the grub example hook has been improved a bit:
34
35 - automatically uses the defined proxy, so that package installation
36   uses the same method as the main install
37 - debconf frontend set to non-interactive, to prevent an debconf
38   question loop
39
40 However, there still seem to be issues related to this hook (recent grub
41 versions fail to run correctly "grub-install" or "update-grub" and
42 complain about device mappings); help is welcome.
43
44 Version 0.10
45 ------------
46
47 This add supports for ext4 file-systems and changes the default
48 distribution from Lenny to Squeeze.
49
50 Additionally, new hooks were added:
51
52 - setting the password for the root user
53 - setting the timezone
54 - setting SSH keys for a given user
55
56 Version 0.9
57 -----------
58
59 Changed the default CUSTOMIZE_DIR (under $sysconfdir, usually /etc) from
60 ganeti/instance-debootstrap.d to ganeti/instance-debootstrap/hooks, to
61 match better with the directory used for the variants file. Now
62 customization of the instance-debootstrap is done either in the defaults
63 file or under ganeti/instance-debootstrap.
64
65 Fix serial console access for kvm instances (bind to ttyS0 rather than
66 console). Please note that with this change if you toggle the serial
67 console hypervisor parameter in Ganeti, but don't create the getty entry
68 in /etc/inittab or /etc/event.d/ you won't have serial access. Before it
69 used to work, but the serial console was slightly broken (no ctrl+c for
70 example).
71
72 Also start shipping the examples in the tar archive, to ease packaging.
73
74 Version 0.8
75 -----------
76
77 Added support for OS API 15 (with OS variants) that is supported by
78 Ganeti 2.1.
79
80 blktype is now supported as an alternative to vol_id; this is needed for
81 newer Debian-based operating systems.
82
83 Added an example grub script, that can be used for automatically
84 installing grub inside new instances.
85
86 Version 0.7
87 -----------
88
89 Fix Ganeti 1.2 compatibility (0.6 was broken) and force the scripts to be
90 executed under /bin/bash (rather than /bin/sh). This fixes compatibility with
91 distributions where /bin/sh is not bash.
92
93 Support 'msdos' partition style, in which the instance disk gets a partition
94 table, and one big partition, rather than creating the filesytem directly on
95 the block device. This requires kpartx to be installed, and is the default when
96 installing under Ganeti 2.0.
97
98 Added the possibility to customize the installation without having to patch the
99 os directly, by executing the scripts in CUSTOMIZE_DIR and giving them a chance
100 to change the instance filesystem. As an example a script that sets the first
101 nic to request a dhcp address is provided.
102
103 Version 0.6
104 -----------
105
106 Support for Ganeti 2.0 (os api 10)
107
108 The instance's fstab is now generated with volumes' UUIDs rather than paths.
109 This makes it more resilient to changes and use under different
110 hypervisors/drivers.
111
112 Init is configured to listen on /dev/console rather than /dev/tty1
113
114 Version 0.5
115 -----------
116
117 Most of the settings of the script have been moved to a configuration
118 file.  Depending on the ./configure options, the location of this file
119 might be /etc/default/ganeti-instance-debootstrap or
120 /usr/local/etc/default/ganeti-instance-debootstrap.
121
122 The cache generation and cleaning variables can be modified as follows:
123
124 - to enable generating the cache, modify the config file and set
125   GENERATE_CACHE to "yes"
126 - to disable cleaning the cache, set CLEAN_CACHE to ""; or
127   alternatively, you can customize with this variable the number of days
128   after which to clear the cache
129
130 Note that the cache file is no longer stored in the same directory as
131 the OS definition files, but (again depending on ./configure options)
132 usually under /var/cache/ganeti-instance-debootstrap.
133
134 There are many other customizable settings added in this version, for
135 example the actual OS to be installed (no longer always installing
136 Debian Etch), whether to use a proxy or not, etc. See the README and the
137 'defaults' files.
138
139 Version 0.4
140 -----------
141
142 This version fixes the problem of interface renaming at instance import
143 time, by removing the saved udev hotplug rules (if any).
144
145 Version 0.3
146 -----------
147
148 The OS will cache the image of the first instance it installs using the
149 name "cache-$arch.tar" (where $arch is what dpkg --print-architecture
150 returns) on a node-by-node basis. This cache will be then used on the
151 future installs, speeding them greatly (even with a fast mirror). Feel
152 free to remove the cache at any time, or to copy it to all nodes. The
153 cache will be kept for two weeks, after which the first install will
154 recreate the cache (in order not to use old packages). If you don't care
155 about package age, remove the user write permission (chmod u-w) from the
156 cache and ganeti will continue to use the same file without refreshing
157 it.
158
159 If you don't have enough space and don't want cache creation, just touch
160 the file 'no_cache' - this will prevent the creation, but the script
161 will continue to use a cache if it exists (but it will remove an
162 existing one after two weeks).
163
164 Also note that if the image file is there, the script does not need
165 network access at all.
166
167 .. vim: set textwidth=72 :
168 .. Local Variables:
169 .. mode: rst
170 .. fill-column: 72
171 .. End: