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