Whamcloud - gitweb
LUDOC-146 benchmark: water-down obdfilter-survey warning. 16/6416/10
authorRichard Henwood <richard.henwood@intel.com>
Wed, 22 May 2013 14:08:01 +0000 (09:08 -0500)
committerRichard Henwood <richard.henwood@intel.com>
Mon, 24 Jun 2013 18:13:37 +0000 (18:13 +0000)
The obdfilter-survey uses a different object sequence (2) compared to
normal filesystem objects (currently always 0), so the two do not
collide.

The manual now indicates that obdfilter-survey may not destroy
production data. A brief description of the object sequence difference
between obdfilter_survey and normal objects is included.

The task to provide evidence to reduce the vagueness of this warning
is LU-3444.

Signed-off-by: Richard Henwood <richard.henwood@intel.com>
Change-Id: Iac5fd3d9a89906dd04290ab62b2cff43ece29e53
Reviewed-on: http://review.whamcloud.com/6416
Tested-by: Hudson
BenchmarkingTests.xml

index 8bead1f..3502cba 100644 (file)
       </listitem>
     </itemizedlist>
     <caution>
-      <para>The <literal>obdfilter_survey</literal> script is destructive and should not be run on devices that containing existing data that needs to be preserved. Thus, tests using <literal>obdfilter_survey</literal> should be run before the Lustre file system is placed in production.</para>
+      <para>The <literal>obdfilter_survey</literal> script is potentially destructive and there is a small risk data may be lost. To reduce this risk, <literal>obdfilter_survey</literal> should not be run on devices that contain data that needs to be preserved. Thus, the best time to run <literal>obdfilter_survey</literal> is before the Lustre file system is put into production. The reason <literal>obdfilter_survey</literal> may be safe to run on a production file system is because it creates objects with object sequence 2. Normal file system objects are typically created with object sequence 0.</para>
     </caution>
     <note>
       <para>If the <literal>obdfilter_survey</literal> test is terminated before it completes, some small amount of space is leaked. you can either ignore it or reformat the file system.</para>