Add summary field to OpNodeModifyStorage
[ganeti-local] / NEWS
1 News
2 ====
3
4
5 Version 2.6.0 beta2
6 -------------------
7
8 *(Released Mon, 11 Jun 2012)*
9
10 New features
11 ~~~~~~~~~~~~
12
13 Instance run status
14 +++++++++++++++++++
15
16 The current ``admin_up`` field, which used to denote whether an instance
17 should be running or not, has been removed. Instead, ``admin_state`` is
18 introduced, with 3 possible values -- ``up``, ``down`` and ``offline``.
19
20 The rational behind this is that an instance being “down” can have
21 different meanings:
22
23 - it could be down during a reboot
24 - it could be temporarily be down for a reinstall
25 - or it could be down because it is deprecated and kept just for its
26   disk
27
28 The previous Boolean state was making it difficult to do capacity
29 calculations: should Ganeti reserve memory for a down instance? Now, the
30 tri-state field makes it clear:
31
32 - in ``up`` and ``down`` state, all resources are reserved for the
33   instance, and it can be at any time brought up if it is down
34 - in ``offline`` state, only disk space is reserved for it, but not
35   memory or CPUs
36
37 The field can have an extra use: since the transition between ``up`` and
38 ``down`` and vice-versus is done via ``gnt-instance start/stop``, but
39 transition between ``offline`` and ``down`` is done via ``gnt-instance
40 modify``, it is possible to given different rights to users. For
41 example, owners of an instance could be allowed to start/stop it, but
42 not transition it out of the offline state.
43
44 Instance policies and specs
45 +++++++++++++++++++++++++++
46
47 In previous Ganeti versions, an instance creation request was not
48 limited on the minimum size and on the maximum size just by the cluster
49 resources. As such, any policy could be implemented only in third-party
50 clients (RAPI clients, or shell wrappers over ``gnt-*``
51 tools). Furthermore, calculating cluster capacity via ``hspace`` again
52 required external input with regards to instance sizes.
53
54 In order to improve these workflows and to allow for example better
55 per-node group differentiation, we introduced instance specs, which
56 allow declaring:
57
58 - minimum instance disk size, disk count, memory size, cpu count
59 - maximum values for the above metrics
60 - and “standard” values (used in ``hspace`` to calculate the standard
61   sized instances)
62
63 The minimum/maximum values can be also customised at node-group level,
64 for example allowing more powerful hardware to support bigger instance
65 memory sizes.
66
67 Beside the instance specs, there are a few other settings belonging to
68 the instance policy framework. It is possible now to customise, per
69 cluster and node-group:
70
71 - the list of allowed disk templates
72 - the maximum ratio of VCPUs per PCPUs (to control CPU oversubscription)
73 - the maximum ratio of instance to spindles (see below for more
74   information) for local storage
75
76 All these together should allow all tools that talk to Ganeti to know
77 what are the ranges of allowed values for instances and the
78 over-subscription that is allowed.
79
80 For the VCPU/PCPU ratio, we already have the VCPU configuration from the
81 instance configuration, and the physical CPU configuration from the
82 node. For the spindle ratios however, we didn't track before these
83 values, so new parameters have been added:
84
85 - a new node parameter ``spindle_count``, defaults to 1, customisable at
86   node group or node level
87 - at new backend parameter (for instances), ``spindle_use`` defaults to 1
88
89 Note that spindles in this context doesn't need to mean actual
90 mechanical hard-drives; it's just a relative number for both the node
91 I/O capacity and instance I/O consumption.
92
93 Instance migration behaviour
94 ++++++++++++++++++++++++++++
95
96 While live-migration is in general desirable over failover, it is
97 possible that for some workloads it is actually worse, due to the
98 variable time of the “suspend” phase during live migration.
99
100 To allow the tools to work consistently over such instances (without
101 having to hard-code instance names), a new backend parameter
102 ``always_failover`` has been added to control the migration/failover
103 behaviour. When set to True, all migration requests for an instance will
104 instead fall-back to failover.
105
106 Instance memory ballooning
107 ++++++++++++++++++++++++++
108
109 Initial support for memory ballooning has been added. The memory for an
110 instance is no longer fixed (backend parameter ``memory``), but instead
111 can vary between minimum and maximum values (backend parameters
112 ``minmem`` and ``maxmem``). Currently we only change an instance's
113 memory when:
114
115 - live migrating or failing over and instance and the target node
116   doesn't have enough memory
117 - user requests changing the memory via ``gnt-instance modify
118   --runtime-memory``
119
120 Instance CPU pinning
121 ++++++++++++++++++++
122
123 In order to control the use of specific CPUs by instance, support for
124 controlling CPU pinning has been added for the Xen, HVM and LXC
125 hypervisors. This is controlled by a new hypervisor parameter
126 ``cpu_mask``; details about possible values for this are in the
127 :manpage:`gnt-instance(8)`. Note that use of the most specific (precise
128 VCPU-to-CPU mapping) form will work well only when all nodes in your
129 cluster have the same amount of CPUs.
130
131 Disk parameters
132 +++++++++++++++
133
134 Another area in which Ganeti was not customisable were the parameters
135 used for storage configuration, e.g. how many stripes to use for LVM,
136 DRBD resync configuration, etc.
137
138 To improve this area, we've added disks parameters, which are
139 customisable at cluster and node group level, and which allow to
140 specify various parameters for disks (DRBD has the most parameters
141 currently), for example:
142
143 - DRBD resync algorithm and parameters (e.g. speed)
144 - the default VG for meta-data volumes for DRBD
145 - number of stripes for LVM (plain disk template)
146 - the RBD pool
147
148 These parameters can be modified via ``gnt-cluster modify -D …`` and
149 ``gnt-group modify -D …``, and are used at either instance creation (in
150 case of LVM stripes, for example) or at disk “activation” time
151 (e.g. resync speed).
152
153 Rados block device support
154 ++++++++++++++++++++++++++
155
156 A Rados (http://ceph.com/wiki/Rbd) storage backend has been added,
157 denoted by the ``rbd`` disk template type. This is considered
158 experimental, feedback is welcome. For details on configuring it, see
159 the :doc:`install` document and the :manpage:`gnt-cluster(8)` man page.
160
161 Master IP setup
162 +++++++++++++++
163
164 The existing master IP functionality works well only in simple setups (a
165 single network shared by all nodes); however, if nodes belong to
166 different networks, then the ``/32`` setup and lack of routing
167 information is not enough.
168
169 To allow the master IP to function well in more complex cases, the
170 system was reworked as follows:
171
172 - a master IP netmask setting has been added
173 - the master IP activation/turn-down code was moved from the node daemon
174   to a separate script
175 - whether to run the Ganeti-supplied master IP script or a user-supplied
176   on is a ``gnt-cluster init`` setting
177
178 Details about the location of the standard and custom setup scripts are
179 in the man page :manpage:`gnt-cluster(8)`; for information about the
180 setup script protocol, look at the Ganeti-supplied script.
181
182 SPICE support
183 +++++++++++++
184
185 The `SPICE <http://www.linux-kvm.org/page/SPICE>`_ support has been
186 improved.
187
188 It is now possible to use TLS-protected connections, and when renewing
189 or changing the cluster certificates (via ``gnt-cluster renew-crypto``,
190 it is now possible to specify spice or spice CA certificates. Also, it
191 is possible to configure a password for SPICE sessions via the
192 hypervisor parameter ``spice_password_file``.
193
194 There are also new parameters to control the compression and streaming
195 options (e.g. ``spice_image_compression``, ``spice_streaming_video``,
196 etc.). For details, see the man page :manpage:`gnt-instance(8)` and look
197 for the spice parameters.
198
199 Lastly, it is now possible to see the SPICE connection information via
200 ``gnt-instance console``.
201
202 OVF converter
203 +++++++++++++
204
205 A new tool (``tools/ovfconverter``) has been added that supports
206 conversion between Ganeti and the `Open Virtualization Format
207 <http://en.wikipedia.org/wiki/Open_Virtualization_Format>`_ (both to and
208 from).
209
210 This relies on the ``qemu-img`` tool to convert the disk formats, so the
211 actual compatibility with other virtualization solutions depends on it.
212
213 Confd daemon changes
214 ++++++++++++++++++++
215
216 The configuration query daemon (``ganeti-confd``) is now optional, and
217 has been rewritten in Haskell; whether to use the daemon at all, use the
218 Python (default) or the Haskell version is selectable at configure time
219 via the ``--enable-confd`` parameter, which can take one of the
220 ``haskell``, ``python`` or ``no`` values. If not used, disabling the
221 daemon will result in a smaller footprint; for larger systems, we
222 welcome feedback on the Haskell version which might become the default
223 in future versions.
224
225
226 User interface changes
227 ~~~~~~~~~~~~~~~~~~~~~~
228
229 We have replaced the ``--disks`` option of ``gnt-instance
230 replace-disks`` with a more flexible ``--disk`` option, which allows
231 adding and removing disks at arbitrary indices (Issue 188). Furthermore,
232 disk size and mode can be changed upon recreation (via ``gnt-instance
233 recreate-disks``, which accepts the same ``--disk`` option).
234
235 As many people are used to a ``show`` command, we have added that as an
236 alias to ``info`` on all ``gnt-*`` commands.
237
238 The ``gnt-instance grow-disk`` command has a new mode in which it can
239 accept the target size of the disk, instead of the delta; this can be
240 more safe since two runs in absolute mode will be idempotent, and
241 sometimes it's also easier to specify the desired size directly.
242
243 API changes
244 ~~~~~~~~~~~
245
246 RAPI coverage has improved, with (for example) new resources for
247 recreate-disks, node power-cycle, etc.
248
249 Compatibility
250 ~~~~~~~~~~~~~
251
252 There is partial support for ``xl`` in the Xen hypervisor; feedback is
253 welcome.
254
255 Python 2.7 is better supported, and after Ganeti 2.6 we will investigate
256 whether to still support Python 2.4 or move to Python 2.6 as minimum
257 required version.
258
259 Support for Fedora has been slightly improved; the provided example
260 init.d script should work better on it and the INSTALL file should
261 document the needed dependencies.
262
263 Internal changes
264 ~~~~~~~~~~~~~~~~
265
266 The deprecated ``QueryLocks`` LUXI request has been removed. Use
267 ``Query(what=QR_LOCK, ...)`` instead.
268
269 The LUXI requests :pyeval:`luxi.REQ_QUERY_JOBS`,
270 :pyeval:`luxi.REQ_QUERY_INSTANCES`, :pyeval:`luxi.REQ_QUERY_NODES`,
271 :pyeval:`luxi.REQ_QUERY_GROUPS`, :pyeval:`luxi.REQ_QUERY_EXPORTS` and
272 :pyeval:`luxi.REQ_QUERY_TAGS` are deprecated and will be removed in a
273 future version. :pyeval:`luxi.REQ_QUERY` should be used instead.
274
275 RAPI client: ``CertificateError`` now derives from
276 ``GanetiApiError``. This should make it more easy to handle Ganeti
277 errors.
278
279 Deprecation warnings due to PyCrypto/paramiko import in
280 ``tools/setup-ssh`` have been silenced, as usually they are safe; please
281 make sure to run an up-to-date paramiko version, if you use this tool.
282
283 The QA scripts now depend on Python 2.5 or above (the main code base
284 still works with Python 2.4).
285
286 The configuration file (``config.data``) is now written without
287 indentation for performance reasons; if you want to edit it, it can be
288 re-formatted via ``tools/fmtjson``.
289
290 A number of bugs has been fixed in the cluster merge tool.
291
292 ``x509`` certification verification (used in import-export) has been
293 changed to allow the same clock skew as permitted by the cluster
294 verification. This will remove some rare but hard to diagnose errors in
295 import-export.
296
297
298 Version 2.6.0 beta1
299 -------------------
300
301 *(Released Wed, 23 May 2012)*
302
303 First beta release of 2.6. The following changes were done from beta1 to
304 beta2:
305
306 - integrated patch for distributions without ``start-stop-daemon``
307 - adapted example init.d script to work on Fedora
308 - fixed log handling in Haskell daemons
309 - adapted checks in the watcher for pycurl linked against libnss
310 - add partial support for ``xl`` instead of ``xm`` for Xen
311 - fixed a type issue in cluster verification
312 - fixed ssconf handling in the Haskell code (was breaking confd in IPv6
313   clusters)
314
315 Plus integrated fixes from the 2.5 branch:
316
317 - fixed ``kvm-ifup`` to use ``/bin/bash``
318 - fixed parallel build failures
319 - KVM live migration when using a custom keymap
320
321
322 Version 2.5.1
323 -------------
324
325 *(Released Fri, 11 May 2012)*
326
327 A small bugfix release.
328
329 The main issues solved are on the topic of compatibility with newer LVM
330 releases:
331
332 - fixed parsing of ``lv_attr`` field
333 - adapted to new ``vgreduce --removemissing`` behaviour where sometimes
334   the ``--force`` flag is needed
335
336 Also on the topic of compatibility, ``tools/lvmstrap`` has been changed
337 to accept kernel 3.x too (was hardcoded to 2.6.*).
338
339 A regression present in 2.5.0 that broke handling (in the gnt-* scripts)
340 of hook results and that also made display of other errors suboptimal
341 was fixed; the code behaves now like 2.4 and earlier.
342
343 Another change in 2.5, the cleanup of the OS scripts environment, is too
344 aggressive: it removed even the ``PATH`` variable, which requires the OS
345 scripts to *always* need to export it. Since this is a bit too strict,
346 we now export a minimal PATH, the same that we export for hooks.
347
348 The fix for issue 201 (Preserve bridge MTU in KVM ifup script) was
349 integrated into this release.
350
351 Finally, a few other miscellaneous changes were done (no new features,
352 just small improvements):
353
354 - Fix ``gnt-group --help`` display
355 - Fix hardcoded Xen kernel path
356 - Fix grow-disk handling of invalid units
357 - Update synopsis for ``gnt-cluster repair-disk-sizes``
358 - Accept both PUT and POST in noded (makes future upgrade to 2.6 easier)
359
360
361 Version 2.5.0
362 -------------
363
364 *(Released Thu, 12 Apr 2012)*
365
366 Incompatible/important changes and bugfixes
367 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
368
369 - The default of the ``/2/instances/[instance_name]/rename`` RAPI
370   resource's ``ip_check`` parameter changed from ``True`` to ``False``
371   to match the underlying LUXI interface.
372 - The ``/2/nodes/[node_name]/evacuate`` RAPI resource was changed to use
373   body parameters, see :doc:`RAPI documentation <rapi>`. The server does
374   not maintain backwards-compatibility as the underlying operation
375   changed in an incompatible way. The RAPI client can talk to old
376   servers, but it needs to be told so as the return value changed.
377 - When creating file-based instances via RAPI, the ``file_driver``
378   parameter no longer defaults to ``loop`` and must be specified.
379 - The deprecated ``bridge`` NIC parameter is no longer supported. Use
380   ``link`` instead.
381 - Support for the undocumented and deprecated RAPI instance creation
382   request format version 0 has been dropped. Use version 1, supported
383   since Ganeti 2.1.3 and :doc:`documented <rapi>`, instead.
384 - Pyparsing 1.4.6 or above is required, see :doc:`installation
385   documentation <install>`.
386 - The "cluster-verify" hooks are now executed per group by the
387   ``OP_CLUSTER_VERIFY_GROUP`` opcode. This maintains the same behavior
388   if you just run ``gnt-cluster verify``, which generates one opcode per
389   group.
390 - The environment as passed to the OS scripts is cleared, and thus no
391   environment variables defined in the node daemon's environment will be
392   inherited by the scripts.
393 - The :doc:`iallocator <iallocator>` mode ``multi-evacuate`` has been
394   deprecated.
395 - :doc:`New iallocator modes <design-multi-reloc>` have been added to
396   support operations involving multiple node groups.
397 - Offline nodes are ignored when failing over an instance.
398 - Support for KVM version 1.0, which changed the version reporting format
399   from 3 to 2 digits.
400 - TCP/IP ports used by DRBD disks are returned to a pool upon instance
401   removal.
402 - ``Makefile`` is now compatible with Automake 1.11.2
403 - Includes all bugfixes made in the 2.4 series
404
405 New features
406 ~~~~~~~~~~~~
407
408 - The ganeti-htools project has been merged into the ganeti-core source
409   tree and will be built as part of Ganeti (see :doc:`install-quick`).
410 - Implemented support for :doc:`shared storage <design-shared-storage>`.
411 - Add support for disks larger than 2 TB in ``lvmstrap`` by supporting
412   GPT-style partition tables (requires `parted
413   <http://www.gnu.org/s/parted/>`_).
414 - Added support for floppy drive and 2nd CD-ROM drive in KVM hypervisor.
415 - Allowed adding tags on instance creation.
416 - Export instance tags to hooks (``INSTANCE_TAGS``, see :doc:`hooks`)
417 - Allow instances to be started in a paused state, enabling the user to
418   see the complete console output on boot using the console.
419 - Added new hypervisor flag to control default reboot behaviour
420   (``reboot_behavior``).
421 - Added support for KVM keymaps (hypervisor parameter ``keymap``).
422 - Improved out-of-band management support:
423
424   - Added ``gnt-node health`` command reporting the health status of
425     nodes.
426   - Added ``gnt-node power`` command to manage power status of nodes.
427   - Added command for emergency power-off (EPO), ``gnt-cluster epo``.
428
429 - Instance migration can fall back to failover if instance is not
430   running.
431 - Filters can be used when listing nodes, instances, groups and locks;
432   see *ganeti(7)* manpage.
433 - Added post-execution status as variables to :doc:`hooks <hooks>`
434   environment.
435 - Instance tags are exported/imported together with the instance.
436 - When given an explicit job ID, ``gnt-job info`` will work for archived
437   jobs.
438 - Jobs can define dependencies on other jobs (not yet supported via
439   RAPI or command line, but used by internal commands and usable via
440   LUXI).
441
442   - Lock monitor (``gnt-debug locks``) shows jobs waiting for
443     dependencies.
444
445 - Instance failover is now available as a RAPI resource
446   (``/2/instances/[instance_name]/failover``).
447 - ``gnt-instance info`` defaults to static information if primary node
448   is offline.
449 - Opcodes have a new ``comment`` attribute.
450 - Added basic SPICE support to KVM hypervisor.
451 - ``tools/ganeti-listrunner`` allows passing of arguments to executable.
452
453 Node group improvements
454 ~~~~~~~~~~~~~~~~~~~~~~~
455
456 - ``gnt-cluster verify`` has been modified to check groups separately,
457   thereby improving performance.
458 - Node group support has been added to ``gnt-cluster verify-disks``,
459   which now operates per node group.
460 - Watcher has been changed to work better with node groups.
461
462   - One process and state file per node group.
463   - Slow watcher in one group doesn't block other group's watcher.
464
465 - Added new command, ``gnt-group evacuate``, to move all instances in a
466   node group to other groups.
467 - Added ``gnt-instance change-group`` to move an instance to another
468   node group.
469 - ``gnt-cluster command`` and ``gnt-cluster copyfile`` now support
470   per-group operations.
471 - Node groups can be tagged.
472 - Some operations switch from an exclusive to a shared lock as soon as
473   possible.
474 - Instance's primary and secondary nodes' groups are now available as
475   query fields (``pnode.group``, ``pnode.group.uuid``, ``snodes.group``
476   and ``snodes.group.uuid``).
477
478 Misc
479 ~~~~
480
481 - Numerous updates to documentation and manpages.
482
483   - :doc:`RAPI <rapi>` documentation now has detailed parameter
484     descriptions.
485   - Some opcode/job results are now also documented, see :doc:`RAPI
486     <rapi>`.
487
488 - A lockset's internal lock is now also visible in lock monitor.
489 - Log messages from job queue workers now contain information about the
490   opcode they're processing.
491 - ``gnt-instance console`` no longer requires the instance lock.
492 - A short delay when waiting for job changes reduces the number of LUXI
493   requests significantly.
494 - DRBD metadata volumes are overwritten with zeros during disk creation.
495 - Out-of-band commands no longer acquire the cluster lock in exclusive
496   mode.
497 - ``devel/upload`` now uses correct permissions for directories.
498
499
500 Version 2.5.0 rc6
501 -----------------
502
503 *(Released Fri, 23 Mar 2012)*
504
505 This was the sixth release candidate of the 2.5 series.
506
507
508 Version 2.5.0 rc5
509 -----------------
510
511 *(Released Mon, 9 Jan 2012)*
512
513 This was the fifth release candidate of the 2.5 series.
514
515
516 Version 2.5.0 rc4
517 -----------------
518
519 *(Released Thu, 27 Oct 2011)*
520
521 This was the fourth release candidate of the 2.5 series.
522
523
524 Version 2.5.0 rc3
525 -----------------
526
527 *(Released Wed, 26 Oct 2011)*
528
529 This was the third release candidate of the 2.5 series.
530
531
532 Version 2.5.0 rc2
533 -----------------
534
535 *(Released Tue, 18 Oct 2011)*
536
537 This was the second release candidate of the 2.5 series.
538
539
540 Version 2.5.0 rc1
541 -----------------
542
543 *(Released Tue, 4 Oct 2011)*
544
545 This was the first release candidate of the 2.5 series.
546
547
548 Version 2.5.0 beta3
549 -------------------
550
551 *(Released Wed, 31 Aug 2011)*
552
553 This was the third beta release of the 2.5 series.
554
555
556 Version 2.5.0 beta2
557 -------------------
558
559 *(Released Mon, 22 Aug 2011)*
560
561 This was the second beta release of the 2.5 series.
562
563
564 Version 2.5.0 beta1
565 -------------------
566
567 *(Released Fri, 12 Aug 2011)*
568
569 This was the first beta release of the 2.5 series.
570
571
572 Version 2.4.5
573 -------------
574
575 *(Released Thu, 27 Oct 2011)*
576
577 - Fixed bug when parsing command line parameter values ending in
578   backslash
579 - Fixed assertion error after unclean master shutdown
580 - Disable HTTP client pool for RPC, significantly reducing memory usage
581   of master daemon
582 - Fixed queue archive creation with wrong permissions
583
584
585 Version 2.4.4
586 -------------
587
588 *(Released Tue, 23 Aug 2011)*
589
590 Small bug-fixes:
591
592 - Fixed documentation for importing with ``--src-dir`` option
593 - Fixed a bug in ``ensure-dirs`` with queue/archive permissions
594 - Fixed a parsing issue with DRBD 8.3.11 in the Linux kernel
595
596
597 Version 2.4.3
598 -------------
599
600 *(Released Fri, 5 Aug 2011)*
601
602 Many bug-fixes and a few small features:
603
604 - Fixed argument order in ``ReserveLV`` and ``ReserveMAC`` which caused
605   issues when you tried to add an instance with two MAC addresses in one
606   request
607 - KVM: fixed per-instance stored UID value
608 - KVM: configure bridged NICs at migration start
609 - KVM: Fix a bug where instance will not start with never KVM versions
610   (>= 0.14)
611 - Added OS search path to ``gnt-cluster info``
612 - Fixed an issue with ``file_storage_dir`` where you were forced to
613   provide an absolute path, but the documentation states it is a
614   relative path, the documentation was right
615 - Added a new parameter to instance stop/start called ``--no-remember``
616   that will make the state change to not be remembered
617 - Implemented ``no_remember`` at RAPI level
618 - Improved the documentation
619 - Node evacuation: don't call IAllocator if node is already empty
620 - Fixed bug in DRBD8 replace disks on current nodes
621 - Fixed bug in recreate-disks for DRBD instances
622 - Moved assertion checking locks in ``gnt-instance replace-disks``
623   causing it to abort with not owning the right locks for some situation
624 - Job queue: Fixed potential race condition when cancelling queued jobs
625 - Fixed off-by-one bug in job serial generation
626 - ``gnt-node volumes``: Fix instance names
627 - Fixed aliases in bash completion
628 - Fixed a bug in reopening log files after being sent a SIGHUP
629 - Added a flag to burnin to allow specifying VCPU count
630 - Bugfixes to non-root Ganeti configuration
631
632
633 Version 2.4.2
634 -------------
635
636 *(Released Thu, 12 May 2011)*
637
638 Many bug-fixes and a few new small features:
639
640 - Fixed a bug related to log opening failures
641 - Fixed a bug in instance listing with orphan instances
642 - Fixed a bug which prevented resetting the cluster-level node parameter
643   ``oob_program`` to the default
644 - Many fixes related to the ``cluster-merge`` tool
645 - Fixed a race condition in the lock monitor, which caused failures
646   during (at least) creation of many instances in parallel
647 - Improved output for gnt-job info
648 - Removed the quiet flag on some ssh calls which prevented debugging
649   failures
650 - Improved the N+1 failure messages in cluster verify by actually
651   showing the memory values (needed and available)
652 - Increased lock attempt timeouts so that when executing long operations
653   (e.g. DRBD replace-disks) other jobs do not enter 'blocking acquire'
654   too early and thus prevent the use of the 'fair' mechanism
655 - Changed instance query data (``gnt-instance info``) to not acquire
656   locks unless needed, thus allowing its use on locked instance if only
657   static information is asked for
658 - Improved behaviour with filesystems that do not support rename on an
659   opened file
660 - Fixed the behaviour of ``prealloc_wipe_disks`` cluster parameter which
661   kept locks on all nodes during the wipe, which is unneeded
662 - Fixed ``gnt-watcher`` handling of errors during hooks execution
663 - Fixed bug in ``prealloc_wipe_disks`` with small disk sizes (less than
664   10GiB) which caused the wipe to fail right at the end in some cases
665 - Fixed master IP activation when doing master failover with no-voting
666 - Fixed bug in ``gnt-node add --readd`` which allowed the re-adding of
667   the master node itself
668 - Fixed potential data-loss in under disk full conditions, where Ganeti
669   wouldn't check correctly the return code and would consider
670   partially-written files 'correct'
671 - Fixed bug related to multiple VGs and DRBD disk replacing
672 - Added new disk parameter ``metavg`` that allows placement of the meta
673   device for DRBD in a different volume group
674 - Fixed error handling in the node daemon when the system libc doesn't
675   have major number 6 (i.e. if ``libc.so.6`` is not the actual libc)
676 - Fixed lock release during replace-disks, which kept cluster-wide locks
677   when doing disk replaces with an iallocator script
678 - Added check for missing bridges in cluster verify
679 - Handle EPIPE errors while writing to the terminal better, so that
680   piping the output to e.g. ``less`` doesn't cause a backtrace
681 - Fixed rare case where a ^C during Luxi calls could have been
682   interpreted as server errors, instead of simply terminating
683 - Fixed a race condition in LUGroupAssignNodes (``gnt-group
684   assign-nodes``)
685 - Added a few more parameters to the KVM hypervisor, allowing a second
686   CDROM, custom disk type for CDROMs and a floppy image
687 - Removed redundant message in instance rename when the name is given
688   already as a FQDN
689 - Added option to ``gnt-instance recreate-disks`` to allow creating the
690   disks on new nodes, allowing recreation when the original instance
691   nodes are completely gone
692 - Added option when converting disk templates to DRBD to skip waiting
693   for the resync, in order to make the instance available sooner
694 - Added two new variables to the OS scripts environment (containing the
695   instance's nodes)
696 - Made the root_path and optional parameter for the xen-pvm hypervisor,
697   to allow use of ``pvgrub`` as bootloader
698 - Changed the instance memory modifications to only check out-of-memory
699   conditions on memory increases, and turned the secondary node warnings
700   into errors (they can still be overridden via ``--force``)
701 - Fixed the handling of a corner case when the Python installation gets
702   corrupted (e.g. a bad disk) while ganeti-noded is running and we try
703   to execute a command that doesn't exist
704 - Fixed a bug in ``gnt-instance move`` (LUInstanceMove) when the primary
705   node of the instance returned failures during instance shutdown; this
706   adds the option ``--ignore-consistency`` to gnt-instance move
707
708 And as usual, various improvements to the error messages, documentation
709 and man pages.
710
711
712 Version 2.4.1
713 -------------
714
715 *(Released Wed, 09 Mar 2011)*
716
717 Emergency bug-fix release. ``tools/cfgupgrade`` was broken and overwrote
718 the RAPI users file if run twice (even with ``--dry-run``).
719
720 The release fixes that bug (nothing else changed).
721
722
723 Version 2.4.0
724 -------------
725
726 *(Released Mon, 07 Mar 2011)*
727
728 Final 2.4.0 release. Just a few small fixes:
729
730 - Fixed RAPI node evacuate
731 - Fixed the kvm-ifup script
732 - Fixed internal error handling for special job cases
733 - Updated man page to specify the escaping feature for options
734
735
736 Version 2.4.0 rc3
737 -----------------
738
739 *(Released Mon, 28 Feb 2011)*
740
741 A critical fix for the ``prealloc_wipe_disks`` feature: it is possible
742 that this feature wiped the disks of the wrong instance, leading to loss
743 of data.
744
745 Other changes:
746
747 - Fixed title of query field containing instance name
748 - Expanded the glossary in the documentation
749 - Fixed one unittest (internal issue)
750
751
752 Version 2.4.0 rc2
753 -----------------
754
755 *(Released Mon, 21 Feb 2011)*
756
757 A number of bug fixes plus just a couple functionality changes.
758
759 On the user-visible side, the ``gnt-* list`` command output has changed
760 with respect to "special" field states. The current rc1 style of display
761 can be re-enabled by passing a new ``--verbose`` (``-v``) flag, but in
762 the default output mode special fields states are displayed as follows:
763
764 - Offline resource: ``*``
765 - Unavailable/not applicable: ``-``
766 - Data missing (RPC failure): ``?``
767 - Unknown field: ``??``
768
769 Another user-visible change is the addition of ``--force-join`` to
770 ``gnt-node add``.
771
772 As for bug fixes:
773
774 - ``tools/cluster-merge`` has seen many fixes and is now enabled again
775 - Fixed regression in RAPI/instance reinstall where all parameters were
776   required (instead of optional)
777 - Fixed ``gnt-cluster repair-disk-sizes``, was broken since Ganeti 2.2
778 - Fixed iallocator usage (offline nodes were not considered offline)
779 - Fixed ``gnt-node list`` with respect to non-vm_capable nodes
780 - Fixed hypervisor and OS parameter validation with respect to
781   non-vm_capable nodes
782 - Fixed ``gnt-cluster verify`` with respect to offline nodes (mostly
783   cosmetic)
784 - Fixed ``tools/listrunner`` with respect to agent-based usage
785
786
787 Version 2.4.0 rc1
788 -----------------
789
790 *(Released Fri,  4 Feb 2011)*
791
792 Many changes and fixes since the beta1 release. While there were some
793 internal changes, the code has been mostly stabilised for the RC
794 release.
795
796 Note: the dumb allocator was removed in this release, as it was not kept
797 up-to-date with the IAllocator protocol changes. It is recommended to
798 use the ``hail`` command from the ganeti-htools package.
799
800 Note: the 2.4 and up versions of Ganeti are not compatible with the
801 0.2.x branch of ganeti-htools. You need to upgrade to
802 ganeti-htools-0.3.0 (or later).
803
804 Regressions fixed from 2.3
805 ~~~~~~~~~~~~~~~~~~~~~~~~~~
806
807 - Fixed the ``gnt-cluster verify-disks`` command
808 - Made ``gnt-cluster verify-disks`` work in parallel (as opposed to
809   serially on nodes)
810 - Fixed disk adoption breakage
811 - Fixed wrong headers in instance listing for field aliases
812
813 Other bugs fixed
814 ~~~~~~~~~~~~~~~~
815
816 - Fixed corner case in KVM handling of NICs
817 - Fixed many cases of wrong handling of non-vm_capable nodes
818 - Fixed a bug where a missing instance symlink was not possible to
819   recreate with any ``gnt-*`` command (now ``gnt-instance
820   activate-disks`` does it)
821 - Fixed the volume group name as reported by ``gnt-cluster
822   verify-disks``
823 - Increased timeouts for the import-export code, hopefully leading to
824   fewer aborts due network or instance timeouts
825 - Fixed bug in ``gnt-node list-storage``
826 - Fixed bug where not all daemons were started on cluster
827   initialisation, but only at the first watcher run
828 - Fixed many bugs in the OOB implementation
829 - Fixed watcher behaviour in presence of instances with offline
830   secondaries
831 - Fixed instance list output for instances running on the wrong node
832 - a few fixes to the cluster-merge tool, but it still cannot merge
833   multi-node groups (currently it is not recommended to use this tool)
834
835
836 Improvements
837 ~~~~~~~~~~~~
838
839 - Improved network configuration for the KVM hypervisor
840 - Added e1000 as a supported NIC for Xen-HVM
841 - Improved the lvmstrap tool to also be able to use partitions, as
842   opposed to full disks
843 - Improved speed of disk wiping (the cluster parameter
844   ``prealloc_wipe_disks``, so that it has a low impact on the total time
845   of instance creations
846 - Added documentation for the OS parameters
847 - Changed ``gnt-instance deactivate-disks`` so that it can work if the
848   hypervisor is not responding
849 - Added display of blacklisted and hidden OS information in
850   ``gnt-cluster info``
851 - Extended ``gnt-cluster verify`` to also validate hypervisor, backend,
852   NIC and node parameters, which might create problems with currently
853   invalid (but undetected) configuration files, but prevents validation
854   failures when unrelated parameters are modified
855 - Changed cluster initialisation to wait for the master daemon to become
856   available
857 - Expanded the RAPI interface:
858
859   - Added config redistribution resource
860   - Added activation/deactivation of instance disks
861   - Added export of console information
862
863 - Implemented log file reopening on SIGHUP, which allows using
864   logrotate(8) for the Ganeti log files
865 - Added a basic OOB helper script as an example
866
867
868 Version 2.4.0 beta1
869 -------------------
870
871 *(Released Fri, 14 Jan 2011)*
872
873 User-visible
874 ~~~~~~~~~~~~
875
876 - Fixed timezone issues when formatting timestamps
877 - Added support for node groups, available via ``gnt-group`` and other
878   commands
879 - Added out-of-band framework and management, see :doc:`design
880   document <design-oob>`
881 - Removed support for roman numbers from ``gnt-node list`` and
882   ``gnt-instance list``.
883 - Allowed modification of master network interface via ``gnt-cluster
884   modify --master-netdev``
885 - Accept offline secondaries while shutting down instance disks
886 - Added ``blockdev_prefix`` parameter to Xen PVM and HVM hypervisors
887 - Added support for multiple LVM volume groups
888 - Avoid sorting nodes for ``gnt-node list`` if specific nodes are
889   requested
890 - Added commands to list available fields:
891
892   - ``gnt-node list-fields``
893   - ``gnt-group list-fields``
894   - ``gnt-instance list-fields``
895
896 - Updated documentation and man pages
897
898 Integration
899 ~~~~~~~~~~~
900
901 - Moved ``rapi_users`` file into separate directory, now named
902   ``.../ganeti/rapi/users``, ``cfgupgrade`` moves the file and creates a
903   symlink
904 - Added new tool for running commands on many machines,
905   ``tools/ganeti-listrunner``
906 - Implemented more verbose result in ``OpInstanceConsole`` opcode, also
907   improving the ``gnt-instance console`` output
908 - Allowed customisation of disk index separator at ``configure`` time
909 - Export node group allocation policy to :doc:`iallocator <iallocator>`
910 - Added support for non-partitioned md disks in ``lvmstrap``
911 - Added script to gracefully power off KVM instances
912 - Split ``utils`` module into smaller parts
913 - Changed query operations to return more detailed information, e.g.
914   whether an information is unavailable due to an offline node. To use
915   this new functionality, the LUXI call ``Query`` must be used. Field
916   information is now stored by the master daemon and can be retrieved
917   using ``QueryFields``. Instances, nodes and groups can also be queried
918   using the new opcodes ``OpQuery`` and ``OpQueryFields`` (not yet
919   exposed via RAPI). The following commands make use of this
920   infrastructure change:
921
922   - ``gnt-group list``
923   - ``gnt-group list-fields``
924   - ``gnt-node list``
925   - ``gnt-node list-fields``
926   - ``gnt-instance list``
927   - ``gnt-instance list-fields``
928   - ``gnt-debug locks``
929
930 Remote API
931 ~~~~~~~~~~
932
933 - New RAPI resources (see :doc:`rapi`):
934
935   - ``/2/modify``
936   - ``/2/groups``
937   - ``/2/groups/[group_name]``
938   - ``/2/groups/[group_name]/assign-nodes``
939   - ``/2/groups/[group_name]/modify``
940   - ``/2/groups/[group_name]/rename``
941   - ``/2/instances/[instance_name]/disk/[disk_index]/grow``
942
943 - RAPI changes:
944
945   - Implemented ``no_install`` for instance creation
946   - Implemented OS parameters for instance reinstallation, allowing
947     use of special settings on reinstallation (e.g. for preserving data)
948
949 Misc
950 ~~~~
951
952 - Added IPv6 support in import/export
953 - Pause DRBD synchronization while wiping disks on instance creation
954 - Updated unittests and QA scripts
955 - Improved network parameters passed to KVM
956 - Converted man pages from docbook to reStructuredText
957
958
959 Version 2.3.1
960 -------------
961
962 *(Released Mon, 20 Dec 2010)*
963
964 Released version 2.3.1~rc1 without any changes.
965
966
967 Version 2.3.1 rc1
968 -----------------
969
970 *(Released Wed, 1 Dec 2010)*
971
972 - impexpd: Disable OpenSSL compression in socat if possible (backport
973   from master, commit e90739d625b, see :doc:`installation guide
974   <install-quick>` for details)
975 - Changed unittest coverage report to exclude test scripts
976 - Added script to check version format
977
978
979 Version 2.3.0
980 -------------
981
982 *(Released Wed, 1 Dec 2010)*
983
984 Released version 2.3.0~rc1 without any changes.
985
986
987 Version 2.3.0 rc1
988 -----------------
989
990 *(Released Fri, 19 Nov 2010)*
991
992 A number of bugfixes and documentation updates:
993
994 - Update ganeti-os-interface documentation
995 - Fixed a bug related to duplicate MACs or similar items which should be
996   unique
997 - Fix breakage in OS state modify
998 - Reinstall instance: disallow offline secondaries (fixes bug related to
999   OS changing but reinstall failing)
1000 - plus all the other fixes between 2.2.1 and 2.2.2
1001
1002
1003 Version 2.3.0 rc0
1004 -----------------
1005
1006 *(Released Tue, 2 Nov 2010)*
1007
1008 - Fixed clearing of the default iallocator using ``gnt-cluster modify``
1009 - Fixed master failover race with watcher
1010 - Fixed a bug in ``gnt-node modify`` which could lead to an inconsistent
1011   configuration
1012 - Accept previously stopped instance for export with instance removal
1013 - Simplify and extend the environment variables for instance OS scripts
1014 - Added new node flags, ``master_capable`` and ``vm_capable``
1015 - Added optional instance disk wiping prior during allocation. This is a
1016   cluster-wide option and can be set/modified using
1017   ``gnt-cluster {init,modify} --prealloc-wipe-disks``.
1018 - Added IPv6 support, see :doc:`design document <design-2.3>` and
1019   :doc:`install-quick`
1020 - Added a new watcher option (``--ignore-pause``)
1021 - Added option to ignore offline node on instance start/stop
1022   (``--ignore-offline``)
1023 - Allow overriding OS parameters with ``gnt-instance reinstall``
1024 - Added ability to change node's secondary IP address using ``gnt-node
1025   modify``
1026 - Implemented privilege separation for all daemons except
1027   ``ganeti-noded``, see ``configure`` options
1028 - Complain if an instance's disk is marked faulty in ``gnt-cluster
1029   verify``
1030 - Implemented job priorities (see ``ganeti(7)`` manpage)
1031 - Ignore failures while shutting down instances during failover from
1032   offline node
1033 - Exit daemon's bootstrap process only once daemon is ready
1034 - Export more information via ``LUInstanceQuery``/remote API
1035 - Improved documentation, QA and unittests
1036 - RAPI daemon now watches ``rapi_users`` all the time and doesn't need a
1037   restart if the file was created or changed
1038 - Added LUXI protocol version sent with each request and response,
1039   allowing detection of server/client mismatches
1040 - Moved the Python scripts among gnt-* and ganeti-* into modules
1041 - Moved all code related to setting up SSH to an external script,
1042   ``setup-ssh``
1043 - Infrastructure changes for node group support in future versions
1044
1045
1046 Version 2.2.2
1047 -------------
1048
1049 *(Released Fri, 19 Nov 2010)*
1050
1051 A few small bugs fixed, and some improvements to the build system:
1052
1053 - Fix documentation regarding conversion to drbd
1054 - Fix validation of parameters in cluster modify (``gnt-cluster modify
1055   -B``)
1056 - Fix error handling in node modify with multiple changes
1057 - Allow remote imports without checked names
1058
1059
1060 Version 2.2.1
1061 -------------
1062
1063 *(Released Tue, 19 Oct 2010)*
1064
1065 - Disable SSL session ID cache in RPC client
1066
1067
1068 Version 2.2.1 rc1
1069 -----------------
1070
1071 *(Released Thu, 14 Oct 2010)*
1072
1073 - Fix interaction between Curl/GnuTLS and the Python's HTTP server
1074   (thanks Apollon Oikonomopoulos!), finally allowing the use of Curl
1075   with GnuTLS
1076 - Fix problems with interaction between Curl and Python's HTTP server,
1077   resulting in increased speed in many RPC calls
1078 - Improve our release script to prevent breakage with older aclocal and
1079   Python 2.6
1080
1081
1082 Version 2.2.1 rc0
1083 -----------------
1084
1085 *(Released Thu, 7 Oct 2010)*
1086
1087 - Fixed issue 125, replace hardcoded "xenvg" in ``gnt-cluster`` with
1088   value retrieved from master
1089 - Added support for blacklisted or hidden OS definitions
1090 - Added simple lock monitor (accessible via (``gnt-debug locks``)
1091 - Added support for -mem-path in KVM hypervisor abstraction layer
1092 - Allow overriding instance parameters in tool for inter-cluster
1093   instance moves (``tools/move-instance``)
1094 - Improved opcode summaries (e.g. in ``gnt-job list``)
1095 - Improve consistency of OS listing by sorting it
1096 - Documentation updates
1097
1098
1099 Version 2.2.0.1
1100 ---------------
1101
1102 *(Released Fri, 8 Oct 2010)*
1103
1104 - Rebuild with a newer autotools version, to fix python 2.6 compatibility
1105
1106
1107 Version 2.2.0
1108 -------------
1109
1110 *(Released Mon, 4 Oct 2010)*
1111
1112 - Fixed regression in ``gnt-instance rename``
1113
1114
1115 Version 2.2.0 rc2
1116 -----------------
1117
1118 *(Released Wed, 22 Sep 2010)*
1119
1120 - Fixed OS_VARIANT variable for OS scripts
1121 - Fixed cluster tag operations via RAPI
1122 - Made ``setup-ssh`` exit with non-zero code if an error occurred
1123 - Disabled RAPI CA checks in watcher
1124
1125
1126 Version 2.2.0 rc1
1127 -----------------
1128
1129 *(Released Mon, 23 Aug 2010)*
1130
1131 - Support DRBD versions of the format "a.b.c.d"
1132 - Updated manpages
1133 - Re-introduce support for usage from multiple threads in RAPI client
1134 - Instance renames and modify via RAPI
1135 - Work around race condition between processing and archival in job
1136   queue
1137 - Mark opcodes following failed one as failed, too
1138 - Job field ``lock_status`` was removed due to difficulties making it
1139   work with the changed job queue in Ganeti 2.2; a better way to monitor
1140   locks is expected for a later 2.2.x release
1141 - Fixed dry-run behaviour with many commands
1142 - Support ``ssh-agent`` again when adding nodes
1143 - Many additional bugfixes
1144
1145
1146 Version 2.2.0 rc0
1147 -----------------
1148
1149 *(Released Fri, 30 Jul 2010)*
1150
1151 Important change: the internal RPC mechanism between Ganeti nodes has
1152 changed from using a home-grown http library (based on the Python base
1153 libraries) to use the PycURL library. This requires that PycURL is
1154 installed on nodes. Please note that on Debian/Ubuntu, PycURL is linked
1155 against GnuTLS by default. cURL's support for GnuTLS had known issues
1156 before cURL 7.21.0 and we recommend using the latest cURL release or
1157 linking against OpenSSL. Most other distributions already link PycURL
1158 and cURL against OpenSSL. The command::
1159
1160   python -c 'import pycurl; print pycurl.version'
1161
1162 can be used to determine the libraries PycURL and cURL are linked
1163 against.
1164
1165 Other significant changes:
1166
1167 - Rewrote much of the internals of the job queue, in order to achieve
1168   better parallelism; this decouples job query operations from the job
1169   processing, and it should allow much nicer behaviour of the master
1170   daemon under load, and it also has uncovered some long-standing bugs
1171   related to the job serialisation (now fixed)
1172 - Added a default iallocator setting to the cluster parameters,
1173   eliminating the need to always pass nodes or an iallocator for
1174   operations that require selection of new node(s)
1175 - Added experimental support for the LXC virtualization method
1176 - Added support for OS parameters, which allows the installation of
1177   instances to pass parameter to OS scripts in order to customise the
1178   instance
1179 - Added a hypervisor parameter controlling the migration type (live or
1180   non-live), since hypervisors have various levels of reliability; this
1181   has renamed the 'live' parameter to 'mode'
1182 - Added a cluster parameter ``reserved_lvs`` that denotes reserved
1183   logical volumes, meaning that cluster verify will ignore them and not
1184   flag their presence as errors
1185 - The watcher will now reset the error count for failed instances after
1186   8 hours, thus allowing self-healing if the problem that caused the
1187   instances to be down/fail to start has cleared in the meantime
1188 - Added a cluster parameter ``drbd_usermode_helper`` that makes Ganeti
1189   check for, and warn, if the drbd module parameter ``usermode_helper``
1190   is not consistent with the cluster-wide setting; this is needed to
1191   make diagnose easier of failed drbd creations
1192 - Started adding base IPv6 support, but this is not yet
1193   enabled/available for use
1194 - Rename operations (cluster, instance) will now return the new name,
1195   which is especially useful if a short name was passed in
1196 - Added support for instance migration in RAPI
1197 - Added a tool to pre-configure nodes for the SSH setup, before joining
1198   them to the cluster; this will allow in the future a simplified model
1199   for node joining (but not yet fully enabled in 2.2); this needs the
1200   paramiko python library
1201 - Fixed handling of name-resolving errors
1202 - Fixed consistency of job results on the error path
1203 - Fixed master-failover race condition when executed multiple times in
1204   sequence
1205 - Fixed many bugs related to the job queue (mostly introduced during the
1206   2.2 development cycle, so not all are impacting 2.1)
1207 - Fixed instance migration with missing disk symlinks
1208 - Fixed handling of unknown jobs in ``gnt-job archive``
1209 - And many other small fixes/improvements
1210
1211 Internal changes:
1212
1213 - Enhanced both the unittest and the QA coverage
1214 - Switched the opcode validation to a generic model, and extended the
1215   validation to all opcode parameters
1216 - Changed more parts of the code that write shell scripts to use the
1217   same class for this
1218 - Switched the master daemon to use the asyncore library for the Luxi
1219   server endpoint
1220
1221
1222 Version 2.2.0 beta0
1223 -------------------
1224
1225 *(Released Thu, 17 Jun 2010)*
1226
1227 - Added tool (``move-instance``) and infrastructure to move instances
1228   between separate clusters (see :doc:`separate documentation
1229   <move-instance>` and :doc:`design document <design-2.2>`)
1230 - Added per-request RPC timeout
1231 - RAPI now requires a Content-Type header for requests with a body (e.g.
1232   ``PUT`` or ``POST``) which must be set to ``application/json`` (see
1233   :rfc:`2616` (HTTP/1.1), section 7.2.1)
1234 - ``ganeti-watcher`` attempts to restart ``ganeti-rapi`` if RAPI is not
1235   reachable
1236 - Implemented initial support for running Ganeti daemons as separate
1237   users, see configure-time flags ``--with-user-prefix`` and
1238   ``--with-group-prefix`` (only ``ganeti-rapi`` is supported at this
1239   time)
1240 - Instances can be removed after export (``gnt-backup export
1241   --remove-instance``)
1242 - Self-signed certificates generated by Ganeti now use a 2048 bit RSA
1243   key (instead of 1024 bit)
1244 - Added new cluster configuration file for cluster domain secret
1245 - Import/export now use SSL instead of SSH
1246 - Added support for showing estimated time when exporting an instance,
1247   see the ``ganeti-os-interface(7)`` manpage and look for
1248   ``EXP_SIZE_FD``
1249
1250
1251 Version 2.1.8
1252 -------------
1253
1254 *(Released Tue, 16 Nov 2010)*
1255
1256 Some more bugfixes. Unless critical bugs occur, this will be the last
1257 2.1 release:
1258
1259 - Fix case of MAC special-values
1260 - Fix mac checker regex
1261 - backend: Fix typo causing "out of range" error
1262 - Add missing --units in gnt-instance list man page
1263
1264
1265 Version 2.1.7
1266 -------------
1267
1268 *(Released Tue, 24 Aug 2010)*
1269
1270 Bugfixes only:
1271   - Don't ignore secondary node silently on non-mirrored disk templates
1272     (issue 113)
1273   - Fix --master-netdev arg name in gnt-cluster(8) (issue 114)
1274   - Fix usb_mouse parameter breaking with vnc_console (issue 109)
1275   - Properly document the usb_mouse parameter
1276   - Fix path in ganeti-rapi(8) (issue 116)
1277   - Adjust error message when the ganeti user's .ssh directory is
1278     missing
1279   - Add same-node-check when changing the disk template to drbd
1280
1281
1282 Version 2.1.6
1283 -------------
1284
1285 *(Released Fri, 16 Jul 2010)*
1286
1287 Bugfixes only:
1288   - Add an option to only select some reboot types during qa/burnin.
1289     (on some hypervisors consequent reboots are not supported)
1290   - Fix infrequent race condition in master failover. Sometimes the old
1291     master ip address would be still detected as up for a short time
1292     after it was removed, causing failover to fail.
1293   - Decrease mlockall warnings when the ctypes module is missing. On
1294     Python 2.4 we support running even if no ctypes module is installed,
1295     but we were too verbose about this issue.
1296   - Fix building on old distributions, on which man doesn't have a
1297     --warnings option.
1298   - Fix RAPI not to ignore the MAC address on instance creation
1299   - Implement the old instance creation format in the RAPI client.
1300
1301
1302 Version 2.1.5
1303 -------------
1304
1305 *(Released Thu, 01 Jul 2010)*
1306
1307 A small bugfix release:
1308   - Fix disk adoption: broken by strict --disk option checking in 2.1.4
1309   - Fix batch-create: broken in the whole 2.1 series due to a lookup on
1310     a non-existing option
1311   - Fix instance create: the --force-variant option was ignored
1312   - Improve pylint 0.21 compatibility and warnings with Python 2.6
1313   - Fix modify node storage with non-FQDN arguments
1314   - Fix RAPI client to authenticate under Python 2.6 when used
1315     for more than 5 requests needing authentication
1316   - Fix gnt-instance modify -t (storage) giving a wrong error message
1317     when converting a non-shutdown drbd instance to plain
1318
1319
1320 Version 2.1.4
1321 -------------
1322
1323 *(Released Fri, 18 Jun 2010)*
1324
1325 A small bugfix release:
1326
1327   - Fix live migration of KVM instances started with older Ganeti
1328     versions which had fewer hypervisor parameters
1329   - Fix gnt-instance grow-disk on down instances
1330   - Fix an error-reporting bug during instance migration
1331   - Better checking of the ``--net`` and ``--disk`` values, to avoid
1332     silently ignoring broken ones
1333   - Fix an RPC error reporting bug affecting, for example, RAPI client
1334     users
1335   - Fix bug triggered by different API version os-es on different nodes
1336   - Fix a bug in instance startup with custom hvparams: OS level
1337     parameters would fail to be applied.
1338   - Fix the RAPI client under Python 2.6 (but more work is needed to
1339     make it work completely well with OpenSSL)
1340   - Fix handling of errors when resolving names from DNS
1341
1342
1343 Version 2.1.3
1344 -------------
1345
1346 *(Released Thu, 3 Jun 2010)*
1347
1348 A medium sized development cycle. Some new features, and some
1349 fixes/small improvements/cleanups.
1350
1351 Significant features
1352 ~~~~~~~~~~~~~~~~~~~~
1353
1354 The node deamon now tries to mlock itself into memory, unless the
1355 ``--no-mlock`` flag is passed. It also doesn't fail if it can't write
1356 its logs, and falls back to console logging. This allows emergency
1357 features such as ``gnt-node powercycle`` to work even in the event of a
1358 broken node disk (tested offlining the disk hosting the node's
1359 filesystem and dropping its memory caches; don't try this at home)
1360
1361 KVM: add vhost-net acceleration support. It can be tested with a new
1362 enough version of the kernel and of qemu-kvm.
1363
1364 KVM: Add instance chrooting feature. If you use privilege dropping for
1365 your VMs you can also now force them to chroot to an empty directory,
1366 before starting the emulated guest.
1367
1368 KVM: Add maximum migration bandwith and maximum downtime tweaking
1369 support (requires a new-enough version of qemu-kvm).
1370
1371 Cluster verify will now warn if the master node doesn't have the master
1372 ip configured on it.
1373
1374 Add a new (incompatible) instance creation request format to RAPI which
1375 supports all parameters (previously only a subset was supported, and it
1376 wasn't possible to extend the old format to accomodate all the new
1377 features. The old format is still supported, and a client can check for
1378 this feature, before using it, by checking for its presence in the
1379 ``features`` RAPI resource.
1380
1381 Now with ancient latin support. Try it passing the ``--roman`` option to
1382 ``gnt-instance info``, ``gnt-cluster info`` or ``gnt-node list``
1383 (requires the python-roman module to be installed, in order to work).
1384
1385 Other changes
1386 ~~~~~~~~~~~~~
1387
1388 As usual many internal code refactorings, documentation updates, and
1389 such. Among others:
1390
1391   - Lots of improvements and cleanups to the experimental Remote API
1392     (RAPI) client library.
1393   - A new unit test suite for the core daemon libraries.
1394   - A fix to creating missing directories makes sure the umask is not
1395     applied anymore. This enforces the same directory permissions
1396     everywhere.
1397   - Better handling terminating daemons with ctrl+c (used when running
1398     them in debugging mode).
1399   - Fix a race condition in live migrating a KVM instance, when stat()
1400     on the old proc status file returned EINVAL, which is an unexpected
1401     value.
1402   - Fixed manpage checking with newer man and utf-8 charachters. But now
1403     you need the en_US.UTF-8 locale enabled to build Ganeti from git.
1404
1405
1406 Version 2.1.2.1
1407 ---------------
1408
1409 *(Released Fri, 7 May 2010)*
1410
1411 Fix a bug which prevented untagged KVM instances from starting.
1412
1413
1414 Version 2.1.2
1415 -------------
1416
1417 *(Released Fri, 7 May 2010)*
1418
1419 Another release with a long development cycle, during which many
1420 different features were added.
1421
1422 Significant features
1423 ~~~~~~~~~~~~~~~~~~~~
1424
1425 The KVM hypervisor now can run the individual instances as non-root, to
1426 reduce the impact of a VM being hijacked due to bugs in the
1427 hypervisor. It is possible to run all instances as a single (non-root)
1428 user, to manually specify a user for each instance, or to dynamically
1429 allocate a user out of a cluster-wide pool to each instance, with the
1430 guarantee that no two instances will run under the same user ID on any
1431 given node.
1432
1433 An experimental RAPI client library, that can be used standalone
1434 (without the other Ganeti libraries), is provided in the source tree as
1435 ``lib/rapi/client.py``. Note this client might change its interface in
1436 the future, as we iterate on its capabilities.
1437
1438 A new command, ``gnt-cluster renew-crypto`` has been added to easily
1439 replace the cluster's certificates and crypto keys. This might help in
1440 case they have been compromised, or have simply expired.
1441
1442 A new disk option for instance creation has been added that allows one
1443 to "adopt" currently existing logical volumes, with data
1444 preservation. This should allow easier migration to Ganeti from
1445 unmanaged (or managed via other software) instances.
1446
1447 Another disk improvement is the possibility to convert between redundant
1448 (DRBD) and plain (LVM) disk configuration for an instance. This should
1449 allow better scalability (starting with one node and growing the
1450 cluster, or shrinking a two-node cluster to one node).
1451
1452 A new feature that could help with automated node failovers has been
1453 implemented: if a node sees itself as offline (by querying the master
1454 candidates), it will try to shutdown (hard) all instances and any active
1455 DRBD devices. This reduces the risk of duplicate instances if an
1456 external script automatically failovers the instances on such nodes. To
1457 enable this, the cluster parameter ``maintain_node_health`` should be
1458 enabled; in the future this option (per the name) will enable other
1459 automatic maintenance features.
1460
1461 Instance export/import now will reuse the original instance
1462 specifications for all parameters; that means exporting an instance,
1463 deleting it and the importing it back should give an almost identical
1464 instance. Note that the default import behaviour has changed from
1465 before, where it created only one NIC; now it recreates the original
1466 number of NICs.
1467
1468 Cluster verify has added a few new checks: SSL certificates validity,
1469 /etc/hosts consistency across the cluster, etc.
1470
1471 Other changes
1472 ~~~~~~~~~~~~~
1473
1474 As usual, many internal changes were done, documentation fixes,
1475 etc. Among others:
1476
1477 - Fixed cluster initialization with disabled cluster storage (regression
1478   introduced in 2.1.1)
1479 - File-based storage supports growing the disks
1480 - Fixed behaviour of node role changes
1481 - Fixed cluster verify for some corner cases, plus a general rewrite of
1482   cluster verify to allow future extension with more checks
1483 - Fixed log spamming by watcher and node daemon (regression introduced
1484   in 2.1.1)
1485 - Fixed possible validation issues when changing the list of enabled
1486   hypervisors
1487 - Fixed cleanup of /etc/hosts during node removal
1488 - Fixed RAPI response for invalid methods
1489 - Fixed bug with hashed passwords in ``ganeti-rapi`` daemon
1490 - Multiple small improvements to the KVM hypervisor (VNC usage, booting
1491   from ide disks, etc.)
1492 - Allow OS changes without re-installation (to record a changed OS
1493   outside of Ganeti, or to allow OS renames)
1494 - Allow instance creation without OS installation (useful for example if
1495   the OS will be installed manually, or restored from a backup not in
1496   Ganeti format)
1497 - Implemented option to make cluster ``copyfile`` use the replication
1498   network
1499 - Added list of enabled hypervisors to ssconf (possibly useful for
1500   external scripts)
1501 - Added a new tool (``tools/cfgupgrade12``) that allows upgrading from
1502   1.2 clusters
1503 - A partial form of node re-IP is possible via node readd, which now
1504   allows changed node primary IP
1505 - Command line utilities now show an informational message if the job is
1506   waiting for a lock
1507 - The logs of the master daemon now show the PID/UID/GID of the
1508   connected client
1509
1510
1511 Version 2.1.1
1512 -------------
1513
1514 *(Released Fri, 12 Mar 2010)*
1515
1516 During the 2.1.0 long release candidate cycle, a lot of improvements and
1517 changes have accumulated with were released later as 2.1.1.
1518
1519 Major changes
1520 ~~~~~~~~~~~~~
1521
1522 The node evacuate command (``gnt-node evacuate``) was significantly
1523 rewritten, and as such the IAllocator protocol was changed - a new
1524 request type has been added. This unfortunate change during a stable
1525 series is designed to improve performance of node evacuations; on
1526 clusters with more than about five nodes and which are well-balanced,
1527 evacuation should proceed in parallel for all instances of the node
1528 being evacuated. As such, any existing IAllocator scripts need to be
1529 updated, otherwise the above command will fail due to the unknown
1530 request. The provided "dumb" allocator has not been updated; but the
1531 ganeti-htools package supports the new protocol since version 0.2.4.
1532
1533 Another important change is increased validation of node and instance
1534 names. This might create problems in special cases, if invalid host
1535 names are being used.
1536
1537 Also, a new layer of hypervisor parameters has been added, that sits at
1538 OS level between the cluster defaults and the instance ones. This allows
1539 customisation of virtualization parameters depending on the installed
1540 OS. For example instances with OS 'X' may have a different KVM kernel
1541 (or any other parameter) than the cluster defaults. This is intended to
1542 help managing a multiple OSes on the same cluster, without manual
1543 modification of each instance's parameters.
1544
1545 A tool for merging clusters, ``cluster-merge``, has been added in the
1546 tools sub-directory.
1547
1548 Bug fixes
1549 ~~~~~~~~~
1550
1551 - Improved the int/float conversions that should make the code more
1552   robust in face of errors from the node daemons
1553 - Fixed the remove node code in case of internal configuration errors
1554 - Fixed the node daemon behaviour in face of inconsistent queue
1555   directory (e.g. read-only file-system where we can't open the files
1556   read-write, etc.)
1557 - Fixed the behaviour of gnt-node modify for master candidate demotion;
1558   now it either aborts cleanly or, if given the new "auto_promote"
1559   parameter, will automatically promote other nodes as needed
1560 - Fixed compatibility with (unreleased yet) Python 2.6.5 that would
1561   completely prevent Ganeti from working
1562 - Fixed bug for instance export when not all disks were successfully
1563   exported
1564 - Fixed behaviour of node add when the new node is slow in starting up
1565   the node daemon
1566 - Fixed handling of signals in the LUXI client, which should improve
1567   behaviour of command-line scripts
1568 - Added checks for invalid node/instance names in the configuration (now
1569   flagged during cluster verify)
1570 - Fixed watcher behaviour for disk activation errors
1571 - Fixed two potentially endless loops in http library, which led to the
1572   RAPI daemon hanging and consuming 100% CPU in some cases
1573 - Fixed bug in RAPI daemon related to hashed passwords
1574 - Fixed bug for unintended qemu-level bridging of multi-NIC KVM
1575   instances
1576 - Enhanced compatibility with non-Debian OSes, but not using absolute
1577   path in some commands and allowing customisation of the ssh
1578   configuration directory
1579 - Fixed possible future issue with new Python versions by abiding to the
1580   proper use of ``__slots__`` attribute on classes
1581 - Added checks that should prevent directory traversal attacks
1582 - Many documentation fixes based on feedback from users
1583
1584 New features
1585 ~~~~~~~~~~~~
1586
1587 - Added an "early_release" more for instance replace disks and node
1588   evacuate, where we release locks earlier and thus allow higher
1589   parallelism within the cluster
1590 - Added watcher hooks, intended to allow the watcher to restart other
1591   daemons (e.g. from the ganeti-nbma project), but they can be used of
1592   course for any other purpose
1593 - Added a compile-time disable for DRBD barriers, to increase
1594   performance if the administrator trusts the power supply or the
1595   storage system to not lose writes
1596 - Added the option of using syslog for logging instead of, or in
1597   addition to, Ganeti's own log files
1598 - Removed boot restriction for paravirtual NICs for KVM, recent versions
1599   can indeed boot from a paravirtual NIC
1600 - Added a generic debug level for many operations; while this is not
1601   used widely yet, it allows one to pass the debug value all the way to
1602   the OS scripts
1603 - Enhanced the hooks environment for instance moves (failovers,
1604   migrations) where the primary/secondary nodes changed during the
1605   operation, by adding {NEW,OLD}_{PRIMARY,SECONDARY} vars
1606 - Enhanced data validations for many user-supplied values; one important
1607   item is the restrictions imposed on instance and node names, which
1608   might reject some (invalid) host names
1609 - Add a configure-time option to disable file-based storage, if it's not
1610   needed; this allows greater security separation between the master
1611   node and the other nodes from the point of view of the inter-node RPC
1612   protocol
1613 - Added user notification in interactive tools if job is waiting in the
1614   job queue or trying to acquire locks
1615 - Added log messages when a job is waiting for locks
1616 - Added filtering by node tags in instance operations which admit
1617   multiple instances (start, stop, reboot, reinstall)
1618 - Added a new tool for cluster mergers, ``cluster-merge``
1619 - Parameters from command line which are of the form ``a=b,c=d`` can now
1620   use backslash escapes to pass in values which contain commas,
1621   e.g. ``a=b\\c,d=e`` where the 'a' parameter would get the value
1622   ``b,c``
1623 - For KVM, the instance name is the first parameter passed to KVM, so
1624   that it's more visible in the process list
1625
1626
1627 Version 2.1.0
1628 -------------
1629
1630 *(Released Tue, 2 Mar 2010)*
1631
1632 Ganeti 2.1 brings many improvements with it. Major changes:
1633
1634 - Added infrastructure to ease automated disk repairs
1635 - Added new daemon to export configuration data in a cheaper way than
1636   using the remote API
1637 - Instance NICs can now be routed instead of being associated with a
1638   networking bridge
1639 - Improved job locking logic to reduce impact of jobs acquiring multiple
1640   locks waiting for other long-running jobs
1641
1642 In-depth implementation details can be found in the Ganeti 2.1 design
1643 document.
1644
1645 Details
1646 ~~~~~~~
1647
1648 - Added chroot hypervisor
1649 - Added more options to xen-hvm hypervisor (``kernel_path`` and
1650   ``device_model``)
1651 - Added more options to xen-pvm hypervisor (``use_bootloader``,
1652   ``bootloader_path`` and ``bootloader_args``)
1653 - Added the ``use_localtime`` option for the xen-hvm and kvm
1654   hypervisors, and the default value for this has changed to false (in
1655   2.0 xen-hvm always enabled it)
1656 - Added luxi call to submit multiple jobs in one go
1657 - Added cluster initialization option to not modify ``/etc/hosts``
1658   file on nodes
1659 - Added network interface parameters
1660 - Added dry run mode to some LUs
1661 - Added RAPI resources:
1662
1663   - ``/2/instances/[instance_name]/info``
1664   - ``/2/instances/[instance_name]/replace-disks``
1665   - ``/2/nodes/[node_name]/evacuate``
1666   - ``/2/nodes/[node_name]/migrate``
1667   - ``/2/nodes/[node_name]/role``
1668   - ``/2/nodes/[node_name]/storage``
1669   - ``/2/nodes/[node_name]/storage/modify``
1670   - ``/2/nodes/[node_name]/storage/repair``
1671
1672 - Added OpCodes to evacuate or migrate all instances on a node
1673 - Added new command to list storage elements on nodes (``gnt-node
1674   list-storage``) and modify them (``gnt-node modify-storage``)
1675 - Added new ssconf files with master candidate IP address
1676   (``ssconf_master_candidates_ips``), node primary IP address
1677   (``ssconf_node_primary_ips``) and node secondary IP address
1678   (``ssconf_node_secondary_ips``)
1679 - Added ``ganeti-confd`` and a client library to query the Ganeti
1680   configuration via UDP
1681 - Added ability to run hooks after cluster initialization and before
1682   cluster destruction
1683 - Added automatic mode for disk replace (``gnt-instance replace-disks
1684   --auto``)
1685 - Added ``gnt-instance recreate-disks`` to re-create (empty) disks
1686   after catastrophic data-loss
1687 - Added ``gnt-node repair-storage`` command to repair damaged LVM volume
1688   groups
1689 - Added ``gnt-instance move`` command to move instances
1690 - Added ``gnt-cluster watcher`` command to control watcher
1691 - Added ``gnt-node powercycle`` command to powercycle nodes
1692 - Added new job status field ``lock_status``
1693 - Added parseable error codes to cluster verification (``gnt-cluster
1694   verify --error-codes``) and made output less verbose (use
1695   ``--verbose`` to restore previous behaviour)
1696 - Added UUIDs to the main config entities (cluster, nodes, instances)
1697 - Added support for OS variants
1698 - Added support for hashed passwords in the Ganeti remote API users file
1699   (``rapi_users``)
1700 - Added option to specify maximum timeout on instance shutdown
1701 - Added ``--no-ssh-init`` option to ``gnt-cluster init``
1702 - Added new helper script to start and stop Ganeti daemons
1703   (``daemon-util``), with the intent to reduce the work necessary to
1704   adjust Ganeti for non-Debian distributions and to start/stop daemons
1705   from one place
1706 - Added more unittests
1707 - Fixed critical bug in ganeti-masterd startup
1708 - Removed the configure-time ``kvm-migration-port`` parameter, this is
1709   now customisable at the cluster level for both the KVM and Xen
1710   hypervisors using the new ``migration_port`` parameter
1711 - Pass ``INSTANCE_REINSTALL`` variable to OS installation script when
1712   reinstalling an instance
1713 - Allowed ``@`` in tag names
1714 - Migrated to Sphinx (http://sphinx.pocoo.org/) for documentation
1715 - Many documentation updates
1716 - Distribute hypervisor files on ``gnt-cluster redist-conf``
1717 - ``gnt-instance reinstall`` can now reinstall multiple instances
1718 - Updated many command line parameters
1719 - Introduced new OS API version 15
1720 - No longer support a default hypervisor
1721 - Treat virtual LVs as inexistent
1722 - Improved job locking logic to reduce lock contention
1723 - Match instance and node names case insensitively
1724 - Reimplemented bash completion script to be more complete
1725 - Improved burnin
1726
1727
1728 Version 2.0.6
1729 -------------
1730
1731 *(Released Thu, 4 Feb 2010)*
1732
1733 - Fix cleaner behaviour on nodes not in a cluster (Debian bug 568105)
1734 - Fix a string formatting bug
1735 - Improve safety of the code in some error paths
1736 - Improve data validation in the master of values returned from nodes
1737
1738
1739 Version 2.0.5
1740 -------------
1741
1742 *(Released Thu, 17 Dec 2009)*
1743
1744 - Fix security issue due to missing validation of iallocator names; this
1745   allows local and remote execution of arbitrary executables
1746 - Fix failure of gnt-node list during instance removal
1747 - Ship the RAPI documentation in the archive
1748
1749
1750 Version 2.0.4
1751 -------------
1752
1753 *(Released Wed, 30 Sep 2009)*
1754
1755 - Fixed many wrong messages
1756 - Fixed a few bugs related to the locking library
1757 - Fixed MAC checking at instance creation time
1758 - Fixed a DRBD parsing bug related to gaps in /proc/drbd
1759 - Fixed a few issues related to signal handling in both daemons and
1760   scripts
1761 - Fixed the example startup script provided
1762 - Fixed insserv dependencies in the example startup script (patch from
1763   Debian)
1764 - Fixed handling of drained nodes in the iallocator framework
1765 - Fixed handling of KERNEL_PATH parameter for xen-hvm (Debian bug
1766   #528618)
1767 - Fixed error related to invalid job IDs in job polling
1768 - Fixed job/opcode persistence on unclean master shutdown
1769 - Fixed handling of partial job processing after unclean master
1770   shutdown
1771 - Fixed error reporting from LUs, previously all errors were converted
1772   into execution errors
1773 - Fixed error reporting from burnin
1774 - Decreased significantly the memory usage of the job queue
1775 - Optimised slightly multi-job submission
1776 - Optimised slightly opcode loading
1777 - Backported the multi-job submit framework from the development
1778   branch; multi-instance start and stop should be faster
1779 - Added script to clean archived jobs after 21 days; this will reduce
1780   the size of the queue directory
1781 - Added some extra checks in disk size tracking
1782 - Added an example ethers hook script
1783 - Added a cluster parameter that prevents Ganeti from modifying of
1784   /etc/hosts
1785 - Added more node information to RAPI responses
1786 - Added a ``gnt-job watch`` command that allows following the ouput of a
1787   job
1788 - Added a bind-address option to ganeti-rapi
1789 - Added more checks to the configuration verify
1790 - Enhanced the burnin script such that some operations can be retried
1791   automatically
1792 - Converted instance reinstall to multi-instance model
1793
1794
1795 Version 2.0.3
1796 -------------
1797
1798 *(Released Fri, 7 Aug 2009)*
1799
1800 - Added ``--ignore-size`` to the ``gnt-instance activate-disks`` command
1801   to allow using the pre-2.0.2 behaviour in activation, if any existing
1802   instances have mismatched disk sizes in the configuration
1803 - Added ``gnt-cluster repair-disk-sizes`` command to check and update
1804   any configuration mismatches for disk sizes
1805 - Added ``gnt-master cluste-failover --no-voting`` to allow master
1806   failover to work on two-node clusters
1807 - Fixed the ``--net`` option of ``gnt-backup import``, which was
1808   unusable
1809 - Fixed detection of OS script errors in ``gnt-backup export``
1810 - Fixed exit code of ``gnt-backup export``
1811
1812
1813 Version 2.0.2
1814 -------------
1815
1816 *(Released Fri, 17 Jul 2009)*
1817
1818 - Added experimental support for stripped logical volumes; this should
1819   enhance performance but comes with a higher complexity in the block
1820   device handling; stripping is only enabled when passing
1821   ``--with-lvm-stripecount=N`` to ``configure``, but codepaths are
1822   affected even in the non-stripped mode
1823 - Improved resiliency against transient failures at the end of DRBD
1824   resyncs, and in general of DRBD resync checks
1825 - Fixed a couple of issues with exports and snapshot errors
1826 - Fixed a couple of issues in instance listing
1827 - Added display of the disk size in ``gnt-instance info``
1828 - Fixed checking for valid OSes in instance creation
1829 - Fixed handling of the "vcpus" parameter in instance listing and in
1830   general of invalid parameters
1831 - Fixed http server library, and thus RAPI, to handle invalid
1832   username/password combinations correctly; this means that now they
1833   report unauthorized for queries too, not only for modifications,
1834   allowing earlier detect of configuration problems
1835 - Added a new "role" node list field, equivalent to the master/master
1836   candidate/drained/offline flags combinations
1837 - Fixed cluster modify and changes of candidate pool size
1838 - Fixed cluster verify error messages for wrong files on regular nodes
1839 - Fixed a couple of issues with node demotion from master candidate role
1840 - Fixed node readd issues
1841 - Added non-interactive mode for ``ganeti-masterd --no-voting`` startup
1842 - Added a new ``--no-voting`` option for masterfailover to fix failover
1843   on two-nodes clusters when the former master node is unreachable
1844 - Added instance reinstall over RAPI
1845
1846
1847 Version 2.0.1
1848 -------------
1849
1850 *(Released Tue, 16 Jun 2009)*
1851
1852 - added ``-H``/``-B`` startup parameters to ``gnt-instance``, which will
1853   allow re-adding the start in single-user option (regression from 1.2)
1854 - the watcher writes the instance status to a file, to allow monitoring
1855   to report the instance status (from the master) based on cached
1856   results of the watcher's queries; while this can get stale if the
1857   watcher is being locked due to other work on the cluster, this is
1858   still an improvement
1859 - the watcher now also restarts the node daemon and the rapi daemon if
1860   they died
1861 - fixed the watcher to handle full and drained queue cases
1862 - hooks export more instance data in the environment, which helps if
1863   hook scripts need to take action based on the instance's properties
1864   (no longer need to query back into ganeti)
1865 - instance failovers when the instance is stopped do not check for free
1866   RAM, so that failing over a stopped instance is possible in low memory
1867   situations
1868 - rapi uses queries for tags instead of jobs (for less job traffic), and
1869   for cluster tags it won't talk to masterd at all but read them from
1870   ssconf
1871 - a couple of error handling fixes in RAPI
1872 - drbd handling: improved the error handling of inconsistent disks after
1873   resync to reduce the frequency of "there are some degraded disks for
1874   this instance" messages
1875 - fixed a bug in live migration when DRBD doesn't want to reconnect (the
1876   error handling path called a wrong function name)
1877
1878
1879 Version 2.0.0
1880 -------------
1881
1882 *(Released Wed, 27 May 2009)*
1883
1884 - no changes from rc5
1885
1886
1887 Version 2.0 rc5
1888 ---------------
1889
1890 *(Released Wed, 20 May 2009)*
1891
1892 - fix a couple of bugs (validation, argument checks)
1893 - fix ``gnt-cluster getmaster`` on non-master nodes (regression)
1894 - some small improvements to RAPI and IAllocator
1895 - make watcher automatically start the master daemon if down
1896
1897
1898 Version 2.0 rc4
1899 ---------------
1900
1901 *(Released Mon, 27 Apr 2009)*
1902
1903 - change the OS list to not require locks; this helps with big clusters
1904 - fix ``gnt-cluster verify`` and ``gnt-cluster verify-disks`` when the
1905   volume group is broken
1906 - ``gnt-instance info``, without any arguments, doesn't run for all
1907   instances anymore; either pass ``--all`` or pass the desired
1908   instances; this helps against mistakes on big clusters where listing
1909   the information for all instances takes a long time
1910 - miscellaneous doc and man pages fixes
1911
1912
1913 Version 2.0 rc3
1914 ---------------
1915
1916 *(Released Wed, 8 Apr 2009)*
1917
1918 - Change the internal locking model of some ``gnt-node`` commands, in
1919   order to reduce contention (and blocking of master daemon) when
1920   batching many creation/reinstall jobs
1921 - Fixes to Xen soft reboot
1922 - No longer build documentation at build time, instead distribute it in
1923   the archive, in order to reduce the need for the whole docbook/rst
1924   toolchains
1925
1926
1927 Version 2.0 rc2
1928 ---------------
1929
1930 *(Released Fri, 27 Mar 2009)*
1931
1932 - Now the cfgupgrade scripts works and can upgrade 1.2.7 clusters to 2.0
1933 - Fix watcher startup sequence, improves the behaviour of busy clusters
1934 - Some other fixes in ``gnt-cluster verify``, ``gnt-instance
1935   replace-disks``, ``gnt-instance add``, ``gnt-cluster queue``, KVM VNC
1936   bind address and other places
1937 - Some documentation fixes and updates
1938
1939
1940 Version 2.0 rc1
1941 ---------------
1942
1943 *(Released Mon, 2 Mar 2009)*
1944
1945 - More documentation updates, now all docs should be more-or-less
1946   up-to-date
1947 - A couple of small fixes (mixed hypervisor clusters, offline nodes,
1948   etc.)
1949 - Added a customizable HV_KERNEL_ARGS hypervisor parameter (for Xen PVM
1950   and KVM)
1951 - Fix an issue related to $libdir/run/ganeti and cluster creation
1952
1953
1954 Version 2.0 beta2
1955 -----------------
1956
1957 *(Released Thu, 19 Feb 2009)*
1958
1959 - Xen PVM and KVM have switched the default value for the instance root
1960   disk to the first partition on the first drive, instead of the whole
1961   drive; this means that the OS installation scripts must be changed
1962   accordingly
1963 - Man pages have been updated
1964 - RAPI has been switched by default to HTTPS, and the exported functions
1965   should all work correctly
1966 - RAPI v1 has been removed
1967 - Many improvements to the KVM hypervisor
1968 - Block device errors are now better reported
1969 - Many other bugfixes and small improvements
1970
1971
1972 Version 2.0 beta1
1973 -----------------
1974
1975 *(Released Mon, 26 Jan 2009)*
1976
1977 - Version 2 is a general rewrite of the code and therefore the
1978   differences are too many to list, see the design document for 2.0 in
1979   the ``doc/`` subdirectory for more details
1980 - In this beta version there is not yet a migration path from 1.2 (there
1981   will be one in the final 2.0 release)
1982 - A few significant changes are:
1983
1984   - all commands are executed by a daemon (``ganeti-masterd``) and the
1985     various ``gnt-*`` commands are just front-ends to it
1986   - all the commands are entered into, and executed from a job queue,
1987     see the ``gnt-job(8)`` manpage
1988   - the RAPI daemon supports read-write operations, secured by basic
1989     HTTP authentication on top of HTTPS
1990   - DRBD version 0.7 support has been removed, DRBD 8 is the only
1991     supported version (when migrating from Ganeti 1.2 to 2.0, you need
1992     to migrate to DRBD 8 first while still running Ganeti 1.2)
1993   - DRBD devices are using statically allocated minor numbers, which
1994     will be assigned to existing instances during the migration process
1995   - there is support for both Xen PVM and Xen HVM instances running on
1996     the same cluster
1997   - KVM virtualization is supported too
1998   - file-based storage has been implemented, which means that it is
1999     possible to run the cluster without LVM and DRBD storage, for
2000     example using a shared filesystem exported from shared storage (and
2001     still have live migration)
2002
2003
2004 Version 1.2.7
2005 -------------
2006
2007 *(Released Tue, 13 Jan 2009)*
2008
2009 - Change the default reboot type in ``gnt-instance reboot`` to "hard"
2010 - Reuse the old instance mac address by default on instance import, if
2011   the instance name is the same.
2012 - Handle situations in which the node info rpc returns incomplete
2013   results (issue 46)
2014 - Add checks for tcp/udp ports collisions in ``gnt-cluster verify``
2015 - Improved version of batcher:
2016
2017   - state file support
2018   - instance mac address support
2019   - support for HVM clusters/instances
2020
2021 - Add an option to show the number of cpu sockets and nodes in
2022   ``gnt-node list``
2023 - Support OSes that handle more than one version of the OS api (but do
2024   not change the current API in any other way)
2025 - Fix ``gnt-node migrate``
2026 - ``gnt-debug`` man page
2027 - Fixes various more typos and small issues
2028 - Increase disk resync maximum speed to 60MB/s (from 30MB/s)
2029
2030
2031 Version 1.2.6
2032 -------------
2033
2034 *(Released Wed, 24 Sep 2008)*
2035
2036 - new ``--hvm-nic-type`` and ``--hvm-disk-type`` flags to control the
2037   type of disk exported to fully virtualized instances.
2038 - provide access to the serial console of HVM instances
2039 - instance auto_balance flag, set by default. If turned off it will
2040   avoid warnings on cluster verify if there is not enough memory to fail
2041   over an instance. in the future it will prevent automatically failing
2042   it over when we will support that.
2043 - batcher tool for instance creation, see ``tools/README.batcher``
2044 - ``gnt-instance reinstall --select-os`` to interactively select a new
2045   operating system when reinstalling an instance.
2046 - when changing the memory amount on instance modify a check has been
2047   added that the instance will be able to start. also warnings are
2048   emitted if the instance will not be able to fail over, if auto_balance
2049   is true.
2050 - documentation fixes
2051 - sync fields between ``gnt-instance list/modify/add/import``
2052 - fix a race condition in drbd when the sync speed was set after giving
2053   the device a remote peer.
2054
2055
2056 Version 1.2.5
2057 -------------
2058
2059 *(Released Tue, 22 Jul 2008)*
2060
2061 - note: the allowed size and number of tags per object were reduced
2062 - fix a bug in ``gnt-cluster verify`` with inconsistent volume groups
2063 - fixed twisted 8.x compatibility
2064 - fixed ``gnt-instance replace-disks`` with iallocator
2065 - add TCP keepalives on twisted connections to detect restarted nodes
2066 - disk increase support, see ``gnt-instance grow-disk``
2067 - implement bulk node/instance query for RAPI
2068 - add tags in node/instance listing (optional)
2069 - experimental migration (and live migration) support, read the man page
2070   for ``gnt-instance migrate``
2071 - the ``ganeti-watcher`` logs are now timestamped, and the watcher also
2072   has some small improvements in handling its state file
2073
2074
2075 Version 1.2.4
2076 -------------
2077
2078 *(Released Fri, 13 Jun 2008)*
2079
2080 - Experimental readonly, REST-based remote API implementation;
2081   automatically started on master node, TCP port 5080, if enabled by
2082   ``--enable-rapi`` parameter to configure script.
2083 - Instance allocator support. Add and import instance accept a
2084   ``--iallocator`` parameter, and call that instance allocator to decide
2085   which node to use for the instance. The iallocator document describes
2086   what's expected from an allocator script.
2087 - ``gnt-cluster verify`` N+1 memory redundancy checks: Unless passed the
2088   ``--no-nplus1-mem`` option ``gnt-cluster verify`` now checks that if a
2089   node is lost there is still enough memory to fail over the instances
2090   that reside on it.
2091 - ``gnt-cluster verify`` hooks: it is now possible to add post-hooks to
2092   ``gnt-cluster verify``, to check for site-specific compliance. All the
2093   hooks will run, and their output, if any, will be displayed. Any
2094   failing hook will make the verification return an error value.
2095 - ``gnt-cluster verify`` now checks that its peers are reachable on the
2096   primary and secondary interfaces
2097 - ``gnt-node add`` now supports the ``--readd`` option, to readd a node
2098   that is still declared as part of the cluster and has failed.
2099 - ``gnt-* list`` commands now accept a new ``-o +field`` way of
2100   specifying output fields, that just adds the chosen fields to the
2101   default ones.
2102 - ``gnt-backup`` now has a new ``remove`` command to delete an existing
2103   export from the filesystem.
2104 - New per-instance parameters hvm_acpi, hvm_pae and hvm_cdrom_image_path
2105   have been added. Using them you can enable/disable acpi and pae
2106   support, and specify a path for a cd image to be exported to the
2107   instance. These parameters as the name suggest only work on HVM
2108   clusters.
2109 - When upgrading an HVM cluster to Ganeti 1.2.4, the values for ACPI and
2110   PAE support will be set to the previously hardcoded values, but the
2111   (previously hardcoded) path to the CDROM ISO image will be unset and
2112   if required, needs to be set manually with ``gnt-instance modify``
2113   after the upgrade.
2114 - The address to which an instance's VNC console is bound is now
2115   selectable per-instance, rather than being cluster wide. Of course
2116   this only applies to instances controlled via VNC, so currently just
2117   applies to HVM clusters.
2118
2119
2120 Version 1.2.3
2121 -------------
2122
2123 *(Released Mon, 18 Feb 2008)*
2124
2125 - more tweaks to the disk activation code (especially helpful for DRBD)
2126 - change the default ``gnt-instance list`` output format, now there is
2127   one combined status field (see the manpage for the exact values this
2128   field will have)
2129 - some more fixes for the mac export to hooks change
2130 - make Ganeti not break with DRBD 8.2.x (which changed the version
2131   format in ``/proc/drbd``) (issue 24)
2132 - add an upgrade tool from "remote_raid1" disk template to "drbd" disk
2133   template, allowing migration from DRBD0.7+MD to DRBD8
2134
2135
2136 Version 1.2.2
2137 -------------
2138
2139 *(Released Wed, 30 Jan 2008)*
2140
2141 - fix ``gnt-instance modify`` breakage introduced in 1.2.1 with the HVM
2142   support (issue 23)
2143 - add command aliases infrastructure and a few aliases
2144 - allow listing of VCPUs in the ``gnt-instance list`` and improve the
2145   man pages and the ``--help`` option of ``gnt-node
2146   list``/``gnt-instance list``
2147 - fix ``gnt-backup list`` with down nodes (issue 21)
2148 - change the tools location (move from $pkgdatadir to $pkglibdir/tools)
2149 - fix the dist archive and add a check for including svn/git files in
2150   the future
2151 - some developer-related changes: improve the burnin and the QA suite,
2152   add an upload script for testing during development
2153
2154
2155 Version 1.2.1
2156 -------------
2157
2158 *(Released Wed, 16 Jan 2008)*
2159
2160 - experimental HVM support, read the install document, section
2161   "Initializing the cluster"
2162 - allow for the PVM hypervisor per-instance kernel and initrd paths
2163 - add a new command ``gnt-cluster verify-disks`` which uses a new
2164   algorithm to improve the reconnection of the DRBD pairs if the device
2165   on the secondary node has gone away
2166 - make logical volume code auto-activate LVs at disk activation time
2167 - slightly improve the speed of activating disks
2168 - allow specification of the MAC address at instance creation time, and
2169   changing it later via ``gnt-instance modify``
2170 - fix handling of external commands that generate lots of output on
2171   stderr
2172 - update documentation with regard to minimum version of DRBD8 supported
2173
2174
2175 Version 1.2.0
2176 -------------
2177
2178 *(Released Tue, 4 Dec 2007)*
2179
2180 - Log the ``xm create`` output to the node daemon log on failure (to
2181   help diagnosing the error)
2182 - In debug mode, log all external commands output if failed to the logs
2183 - Change parsing of lvm commands to ignore stderr
2184
2185
2186 Version 1.2 beta3
2187 -----------------
2188
2189 *(Released Wed, 28 Nov 2007)*
2190
2191 - Another round of updates to the DRBD 8 code to deal with more failures
2192   in the replace secondary node operation
2193 - Some more logging of failures in disk operations (lvm, drbd)
2194 - A few documentation updates
2195 - QA updates
2196
2197
2198 Version 1.2 beta2
2199 -----------------
2200
2201 *(Released Tue, 13 Nov 2007)*
2202
2203 - Change configuration file format from Python's Pickle to JSON.
2204   Upgrading is possible using the cfgupgrade utility.
2205 - Add support for DRBD 8.0 (new disk template ``drbd``) which allows for
2206   faster replace disks and is more stable (DRBD 8 has many improvements
2207   compared to DRBD 0.7)
2208 - Added command line tags support (see man pages for ``gnt-instance``,
2209   ``gnt-node``, ``gnt-cluster``)
2210 - Added instance rename support
2211 - Added multi-instance startup/shutdown
2212 - Added cluster rename support
2213 - Added ``gnt-node evacuate`` to simplify some node operations
2214 - Added instance reboot operation that can speedup reboot as compared to
2215   stop and start
2216 - Soften the requirement that hostnames are in FQDN format
2217 - The ``ganeti-watcher`` now activates drbd pairs after secondary node
2218   reboots
2219 - Removed dependency on debian's patched fping that uses the
2220   non-standard ``-S`` option
2221 - Now the OS definitions are searched for in multiple, configurable
2222   paths (easier for distros to package)
2223 - Some changes to the hooks infrastructure (especially the new
2224   post-configuration update hook)
2225 - Other small bugfixes
2226
2227 .. vim: set textwidth=72 syntax=rst :
2228 .. Local Variables:
2229 .. mode: rst
2230 .. fill-column: 72
2231 .. End: