- <para><xref linkend="dbdoclet.50438273_44185"/>Other Monitoring Options</para>
- </listitem>
- </itemizedlist>
-
- <section xml:id="dbdoclet.50438273_18711">
- <title>12.1 Lustre <anchor xml:id="dbdoclet.50438273_marker-1297383" xreflabel=""/>Changelogs</title>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296794" xreflabel=""/>The changelogs feature records events that change the file system namespace or file metadata. Changes such as file creation, deletion, renaming, attribute changes, etc. are recorded with the target and parent file identifiers (FIDs), the name of the target, and a timestamp. These records can be used for a variety of purposes:</para>
- <itemizedlist><listitem>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296795" xreflabel=""/> Capture recent changes to feed into an archiving system.</para>
- </listitem>
-<listitem>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296796" xreflabel=""/> Use changelog entries to exactly replicate changes in a file system mirror.</para>
- </listitem>
-<listitem>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296797" xreflabel=""/> Set up "watch scripts" that take action on certain events or directories.</para>
- </listitem>
-<listitem>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296798" xreflabel=""/> Maintain a rough audit trail (file/directory changes with timestamps, but no user information).</para>
- </listitem>
-</itemizedlist>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296879" xreflabel=""/>Changelogs record types are:</para>
- <informaltable frame="all">
- <tgroup cols="2">
- <colspec colname="c1" colwidth="50*"/>
- <colspec colname="c2" colwidth="50*"/>
- <thead>
- <row>
- <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438273_pgfId-1296808" xreflabel=""/>Value</emphasis></para></entry>
- <entry><para><emphasis role="bold"><anchor xml:id="dbdoclet.50438273_pgfId-1296810" xreflabel=""/>Description</emphasis></para></entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296812" xreflabel=""/>MARK</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296814" xreflabel=""/>Internal recordkeeping</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296816" xreflabel=""/>CREAT</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296818" xreflabel=""/>Regular file creation</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296820" xreflabel=""/>MKDIR</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296822" xreflabel=""/>Directory creation</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296824" xreflabel=""/>HLINK</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296826" xreflabel=""/>Hard link</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296828" xreflabel=""/>SLINK</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296830" xreflabel=""/>Soft link</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296832" xreflabel=""/>MKNOD</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296834" xreflabel=""/>Other file creation</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296836" xreflabel=""/>UNLNK</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296838" xreflabel=""/>Regular file removal</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296840" xreflabel=""/>RMDIR</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296842" xreflabel=""/>Directory removal</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296844" xreflabel=""/>RNMFM</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296846" xreflabel=""/>Rename, original</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296848" xreflabel=""/>RNMTO</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296850" xreflabel=""/>Rename, final</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296860" xreflabel=""/>IOCTL</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296862" xreflabel=""/>ioctl on file or directory</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296864" xreflabel=""/>TRUNC</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296866" xreflabel=""/>Regular file truncated</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296868" xreflabel=""/>SATTR</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296870" xreflabel=""/>Attribute change</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296872" xreflabel=""/>XATTR</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296874" xreflabel=""/>Extended attribute change</para></entry>
- </row>
- <row>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296876" xreflabel=""/>UNKNW</para></entry>
- <entry><para> <anchor xml:id="dbdoclet.50438273_pgfId-1296878" xreflabel=""/>Unknown operation</para></entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296880" xreflabel=""/>FID-to-full-pathname and pathname-to-FID functions are also included to map target and parent FIDs into the file system namespace.</para>
- <section remap="h3">
- <title><anchor xml:id="dbdoclet.50438273_pgfId-1296889" xreflabel=""/>12.1.1 Working with Changelogs</title>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1296890" xreflabel=""/>Several commands are available to work with changelogs.</para>
- <section remap="h5">
- <title><anchor xml:id="dbdoclet.50438273_pgfId-1297845" xreflabel=""/>lctl changelog_register</title>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1297846" xreflabel=""/>Because changelog records take up space on the MDT, the system administration must register changelog users. The registrants specify which records they are "done with", and the system purges up to the greatest common record.</para>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1297847" xreflabel=""/>To register a new changelog user, run:</para>
- <screen><anchor xml:id="dbdoclet.50438273_pgfId-1297848" xreflabel=""/>lctl --device <mdt_device> changelog_register
-</screen>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1297849" xreflabel=""/>Changelog entries are not purged beyond a registered user’s set point (see lfs changelog_clear).</para>
- </section>
- <section remap="h5">
- <title><anchor xml:id="dbdoclet.50438273_pgfId-1297785" xreflabel=""/>lfs changelog</title>
- <para><anchor xml:id="dbdoclet.50438273_pgfId-1297786" xreflabel=""/>To display the metadata changes on an MDT (the changelog records), run:</para>
- <screen><anchor xml:id="dbdoclet.50438273_pgfId-1297825" xreflabel=""/>lfs changelog <MDT name> [startrec [endrec]]
+ <para>Maintain a rough audit trail (file/directory changes with timestamps, but no user information).</para>
+ </listitem>
+ </itemizedlist>
+ <para>Changelogs record types are:</para>
+ <informaltable frame="all">
+ <tgroup cols="2">
+ <colspec colname="c1" colwidth="50*"/>
+ <colspec colname="c2" colwidth="50*"/>
+ <thead>
+ <row>
+ <entry>
+ <para><emphasis role="bold">Value</emphasis></para>
+ </entry>
+ <entry>
+ <para><emphasis role="bold">Description</emphasis></para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para> MARK</para>
+ </entry>
+ <entry>
+ <para> Internal recordkeeping</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> CREAT</para>
+ </entry>
+ <entry>
+ <para> Regular file creation</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> MKDIR</para>
+ </entry>
+ <entry>
+ <para> Directory creation</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> HLINK</para>
+ </entry>
+ <entry>
+ <para> Hard link</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> SLINK</para>
+ </entry>
+ <entry>
+ <para> Soft link</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> MKNOD</para>
+ </entry>
+ <entry>
+ <para> Other file creation</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> UNLNK</para>
+ </entry>
+ <entry>
+ <para> Regular file removal</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> RMDIR</para>
+ </entry>
+ <entry>
+ <para> Directory removal</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> RNMFM</para>
+ </entry>
+ <entry>
+ <para> Rename, original</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> RNMTO</para>
+ </entry>
+ <entry>
+ <para> Rename, final</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> IOCTL</para>
+ </entry>
+ <entry>
+ <para> ioctl on file or directory</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> TRUNC</para>
+ </entry>
+ <entry>
+ <para> Regular file truncated</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> SATTR</para>
+ </entry>
+ <entry>
+ <para> Attribute change</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> XATTR</para>
+ </entry>
+ <entry>
+ <para> Extended attribute change</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para> UNKNW</para>
+ </entry>
+ <entry>
+ <para> Unknown operation</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>FID-to-full-pathname and pathname-to-FID functions are also included to map target and parent FIDs into the file system namespace.</para>
+ <section remap="h3">
+ <title><indexterm><primary>monitoring</primary><secondary>change logs</secondary></indexterm>
+Working with Changelogs</title>
+ <para>Several commands are available to work with changelogs.</para>
+ <section remap="h5">
+ <title>
+ <literal>lctl changelog_register</literal>
+ </title>
+ <para>Because changelog records take up space on the MDT, the system administration must register changelog users. The registrants specify which records they are "done with", and the system purges up to the greatest common record.</para>
+ <para>To register a new changelog user, run:</para>
+ <screen>lctl --device /dev/<replaceable>mdt_device</replaceable> changelog_register