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