[PATCH 1/2] man mdadm: add information for MDADM_EXPERIMENTAL flag

Update man for MDADM_EXPERIMENTAL flag.

Signed-off-by: Adam Kwolek
---

mdadm.8.in | 12 ++++++++++++
1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/mdadm.8.in b/mdadm.8.in
index 4b70e20..96945ae 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -2229,6 +2229,18 @@ in a container can be converted between levels where those levels are
supported by the container, and the conversion is on of those listed
above.

+Grow functionality (e.g. expand number of raid devices) for Intel's
+IMSM container format has experimental status. It is guarded by
+.B MDADM_EXPERIMENTAL
+environment variable. This is due to the following reasons:
+
+1. Native Intel's IMSM check-pointing is not fully implemented yet.
+This causes IMSM incompatibility during grow process: grew array cannot
+be roamed between Windows(R) and Linux systems.
+
+2. Interrupting grow operation is not recommended, because
+for Intel's IMSM container format it is not fully tested yet.
+
.SS SIZE CHANGES
Normally when an array is built the "size" is taken from the smallest
of the drives. If all the small drives in an arrays are, one at a

--
To unsubscribe from this list: send the line "unsubscribe linux-raid" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html

[PATCH 2/2] man mdadm: Add note about auto-assembly during array

Add note to man that auto-assembly cannot be used for reshaped arrays.

Signed-off-by: Adam Kwolek
---

mdadm.8.in | 6 ++++++
1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/mdadm.8.in b/mdadm.8.in
index 96945ae..2285d4f 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -1665,6 +1665,12 @@ The reason for requiring arrays to be tagged with the homehost for
auto assembly is to guard against problems that can arise when moving
devices from one host to another.
..
+Note: Auto assembly cannot be used for assembling and activating arrays
+under reshape.
+.B Scan
+doesn't allow for
+.B backup\-file
+passing, required by reshape restart and continuation.

.SH BUILD MODE


--
To unsubscribe from this list: send the line "unsubscribe linux-raid" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/2] man mdadm: add information for MDADM_EXPERIMENTAL flag

On 22 March 2011 11:46, Adam Kwolek wrote:
> Update man for MDADM_EXPERIMENTAL flag.
>
> Signed-off-by: Adam Kwolek
> ---
>
>  mdadm.8.in |   12 ++++++++++++
>  1 files changed, 12 insertions(+), 0 deletions(-)
>
> diff --git a/mdadm.8.in b/mdadm.8.in
> index 4b70e20..96945ae 100644
> --- a/mdadm.8.in
> +++ b/mdadm.8.in
> @@ -2229,6 +2229,18 @@ in a container can be converted between levels=
where those levels are
>  supported by the container, and the conversion is on of those l=
isted
>  above.
>
> +Grow functionality (e.g. expand number of raid devices) for Intel's
> +IMSM container format has experimental status. It is guarded by
> +.B MDADM_EXPERIMENTAL
> +environment variable. This is due to the following reasons:
> +
> +1. Native Intel's IMSM check-pointing is not fully implemented yet.
> +This causes IMSM incompatibility during grow process: grew array can=
not
> +be roamed between Windows(R) and Linux systems.
> +
> +2. Interrupting grow operation is not recommended, because
> +for Intel's IMSM container format it is not fully tested yet.
> +
>  .SS SIZE CHANGES
>  Normally when an array is built the "size" is taken from the sm=
allest
>  of the drives.  If all the small drives in an arrays are, =
one at a
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-raid"=
in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.ht=
ml
>

My small modifications (spelling?), which might not be correct.

mdadm.8.in | 12 ++++++++++++
1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/mdadm.8.in b/mdadm.8.in
index 4b70e20..96945ae 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -2229,6 +2229,18 @@ in a container can be converted between levels
where those levels are
supported by the container, and the conversion is on of those listed
above.

+Grow functionality (e.g. expand a number of raid devices) for Intel's
+IMSM container format has an experimental status. It is guarded by the
+.B MDADM_EXPERIMENTAL
+environment variable. This is due to the following reasons:
+
+1. Native Intel's IMSM check-pointing is not fully implemented yet.
+This causes IMSM incompatibility during the grow process: a grown arra=
y cannot
+roam between Windows(R) and Linux systems.
+
+2. Interrupting a grow operation is not recommended, because it
+has not been fully tested for Intel's IMSM container format yet.
+
.SS SIZE CHANGES
Normally when an array is built the "size" is taken from the smallest
of the drives. If all the small drives in an arrays are, one at a


// Mathias
--
To unsubscribe from this list: send the line "unsubscribe linux-raid" i=
n
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/2] man mdadm: add information for MDADM_EXPERIMENTALflag

On Tue, 22 Mar 2011 13:10:06 +0000 Mathias Bur=E9n com>
wrote:

> On 22 March 2011 11:46, Adam Kwolek wrote:
> > Update man for MDADM_EXPERIMENTAL flag.
> >
> > Signed-off-by: Adam Kwolek
> > ---
> >
> > =A0mdadm.8.in | =A0 12 ++++++++++++
> > =A01 files changed, 12 insertions(+), 0 deletions(-)
> >
> > diff --git a/mdadm.8.in b/mdadm.8.in
> > index 4b70e20..96945ae 100644
> > --- a/mdadm.8.in
> > +++ b/mdadm.8.in
> > @@ -2229,6 +2229,18 @@ in a container can be converted between leve=
ls where those levels are
> > =A0supported by the container, and the conversion is on of those li=
sted
> > =A0above.
> >
> > +Grow functionality (e.g. expand number of raid devices) for Intel'=
s
> > +IMSM container format has experimental status. It is guarded by
> > +.B MDADM_EXPERIMENTAL
> > +environment variable. This is due to the following reasons:
> > +
> > +1. Native Intel's IMSM check-pointing is not fully implemented yet=

> > +This causes IMSM incompatibility during grow process: grew array c=
annot
> > +be roamed between Windows(R) and Linux systems.
> > +
> > +2. Interrupting grow operation is not recommended, because
> > +for Intel's IMSM container format it is not fully tested yet.
> > +
> > =A0.SS SIZE CHANGES
> > =A0Normally when an array is built the "size" is taken from the sma=
llest
> > =A0of the drives. =A0If all the small drives in an arrays are, one =
at a
> >
> > --
> > To unsubscribe from this list: send the line "unsubscribe linux-rai=
d" in
> > the body of a message to majordomo@vger.kernel.org
> > More majordomo info at =A0http://vger.kernel.org/majordomo-info.htm=
l
> >
>=20
> My small modifications (spelling?), which might not be correct.
>=20
> mdadm.8.in | 12 ++++++++++++
> 1 files changed, 12 insertions(+), 0 deletions(-)
>=20
> diff --git a/mdadm.8.in b/mdadm.8.in
> index 4b70e20..96945ae 100644
> --- a/mdadm.8.in
> +++ b/mdadm.8.in
> @@ -2229,6 +2229,18 @@ in a container can be converted between levels
> where those levels are
> supported by the container, and the conversion is on of those listed
> above.
>=20
> +Grow functionality (e.g. expand a number of raid devices) for Intel'=
s
> +IMSM container format has an experimental status. It is guarded by t=
he
> +.B MDADM_EXPERIMENTAL
> +environment variable. This is due to the following reasons:
> +
> +1. Native Intel's IMSM check-pointing is not fully implemented yet.
> +This causes IMSM incompatibility during the grow process: a grown ar=
ray cannot
> +roam between Windows(R) and Linux systems.
> +
> +2. Interrupting a grow operation is not recommended, because it
> +has not been fully tested for Intel's IMSM container format yet.
> +
> .SS SIZE CHANGES
> Normally when an array is built the "size" is taken from the smalles=
t
> of the drives. If all the small drives in an arrays are, one at a

Thanks. I included your revisions and made some more of my own :-)

See below.

NeilBrown


commit ca24ddb08da4c86b60f7e049f0b0a2c30b19c95a
Author: Adam Kwolek
Date: Wed Mar 23 11:45:03 2011 +1100

man mdadm: add information for MDADM_EXPERIMENTAL flag
=20
Update man for MDADM_EXPERIMENTAL flag.
=20
Minor revisions by Mathias Bur=E9n and Ne=
il Brown.
=20
Signed-off-by: Adam Kwolek
Signed-off-by: NeilBrown

diff --git a/mdadm.8.in b/mdadm.8.in
index 4b70e20..9537304 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -2229,6 +2229,23 @@ in a container can be converted between levels w=
here those levels are
supported by the container, and the conversion is on of those listed
above.
=20
+Grow functionality (e.g. expand a number of raid devices) for Intel's
+IMSM container format has an experimental status. It is guarded by the
+.B MDADM_EXPERIMENTAL
+environment variable which must be set to '1' for a GROW command to
+succeed.
+This is for the following reasons:
+
+.IP 1.
+Intel's native IMSM check-pointing is not fully implemented yet.
+This causes IMSM incompatibility during the grow process: an array
+which is growing cannot roam between Microsoft Windows(R) and Linux
+systems.
+
+.IP 2.
+Interrupting a grow operation is not recommended, because it
+has not been fully tested for Intel's IMSM container format yet.
+
.SS SIZE CHANGES
Normally when an array is built the "size" is taken from the smallest
of the drives. If all the small drives in an arrays are, one at a
--
To unsubscribe from this list: send the line "unsubscribe linux-raid" i=
n
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/2] man mdadm: Add note about auto-assembly duringarray reshape

On Tue, 22 Mar 2011 12:46:43 +0100 Adam Kwolek wrote:

> Add note to man that auto-assembly cannot be used for reshaped arrays.
>
> Signed-off-by: Adam Kwolek
> ---
>
> mdadm.8.in | 6 ++++++
> 1 files changed, 6 insertions(+), 0 deletions(-)
>
> diff --git a/mdadm.8.in b/mdadm.8.in
> index 96945ae..2285d4f 100644
> --- a/mdadm.8.in
> +++ b/mdadm.8.in
> @@ -1665,6 +1665,12 @@ The reason for requiring arrays to be tagged with the homehost for
> auto assembly is to guard against problems that can arise when moving
> devices from one host to another.
> ..
> +Note: Auto assembly cannot be used for assembling and activating arrays
> +under reshape.
> +.B Scan
> +doesn't allow for
> +.B backup\-file
> +passing, required by reshape restart and continuation.
>
> .SH BUILD MODE
>

Applied with some revisions - thanks.

NeilBrown

commit 246cebdb7601fc41ee0cca9a5379cdd7dc072380
Author: Adam Kwolek
Date: Wed Mar 23 12:02:28 2011 +1100

man mdadm: Add note about auto-assembly during array reshape

Add note to man that auto-assembly cannot be used for reshaped arrays.

Revisions: NeilBrown

Signed-off-by: Adam Kwolek
Signed-off-by: NeilBrown

diff --git a/mdadm.8.in b/mdadm.8.in
index 9537304..982991d 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -1665,6 +1665,13 @@ The reason for requiring arrays to be tagged with the homehost for
auto assembly is to guard against problems that can arise when moving
devices from one host to another.
..
+Note: Auto assembly cannot be used for assembling and activating some
+arrays which are undergoing reshape. In particular as the
+.B backup\-file
+cannot be given, any reshape which requires a backup-file to continue
+cannot be started by auto assembly. An array which is growing to more
+devices and has passed the critical section can be assembled using
+auto-assembly.

.SH BUILD MODE

--
To unsubscribe from this list: send the line "unsubscribe linux-raid" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html