[drbd-utils.git] / debian / README.Debian

Upgrading to DRBD 8.4
=====================

Linux kernel versions after 3.8 include DRBD 8.4, a new minor release with
significant changes both in configuration and operation. An overview of the
most important changes can be found at:

        http://www.drbd.org/users-guide-8.4/ap-recent-changes.html

Configuration file changes
--------------------------

A number of changes in the configuration file format are present in 8.4. They
are outlined at:

      http://www.drbd.org/users-guide-8.4/s-recent-changes-config.html

If you are upgrading from 8.3, please upgrade your configuration files to the
new format. Unfortunately, due to the way backwards compatility is provided
upstream, these options will not be understood by drbdadm if you boot a kernel
with DRBD 8.3 (kernel versions before 3.8), so you will have to revert your
changes if you want to use older kernels.

Downgrading to DRBD 8.3
------------------------

A device that has been attached or created using DRBD 8.4 will not work
automatically under DRBD 8.3, due to changes in device metadata. In order to
make your devices work with DRBD 8.3, you will have to do the following
*before* booting the old kernel, to ensure that the metadata is clean:

  drbdadm down all
  drbdadm apply-al all

More information can be found at:

       http://www.drbd.org/users-guide-8.4/s-downgrading-drbd84.html
Commit	Line	Data
df7efe7f DM	1	Upgrading to DRBD 8.4
	2	=====================
	3
	4	Linux kernel versions after 3.8 include DRBD 8.4, a new minor release with
	5	significant changes both in configuration and operation. An overview of the
	6	most important changes can be found at:
	7
	8	http://www.drbd.org/users-guide-8.4/ap-recent-changes.html
	9
	10	Configuration file changes
	11	--------------------------
	12
	13	A number of changes in the configuration file format are present in 8.4. They
	14	are outlined at:
	15
	16	http://www.drbd.org/users-guide-8.4/s-recent-changes-config.html
	17
	18	If you are upgrading from 8.3, please upgrade your configuration files to the
	19	new format. Unfortunately, due to the way backwards compatility is provided
	20	upstream, these options will not be understood by drbdadm if you boot a kernel
	21	with DRBD 8.3 (kernel versions before 3.8), so you will have to revert your
	22	changes if you want to use older kernels.
	23
	24	Downgrading to DRBD 8.3
	25	------------------------
	26
	27	A device that has been attached or created using DRBD 8.4 will not work
	28	automatically under DRBD 8.3, due to changes in device metadata. In order to
	29	make your devices work with DRBD 8.3, you will have to do the following
	30	before booting the old kernel, to ensure that the metadata is clean:
	31
	32	drbdadm down all
	33	drbdadm apply-al all
	34
	35	More information can be found at:
	36
	37	http://www.drbd.org/users-guide-8.4/s-downgrading-drbd84.html
	38