[LUDOC-261] LFSCK namespace and layout check phases need explanation Created: 11/Nov/14  Updated: 19/Feb/16  Resolved: 19/Feb/16

Status: Closed
Project: Lustre Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Minor
Reporter: Ryan Haasken Assignee: Richard Henwood (Inactive)
Resolution: Fixed Votes: 0
Labels: None

Severity: 3
Rank (Obsolete): 16491

 Description   

The Lustre manual mentions a phase 1 and a phase 2 of the LFSCK namespace and layout checks, but it doesn't explain what the phases mean. The documentation should explain what the phases mean so that the LFSCK user can understand the output of the LFSCK status interface.



 Comments   
Comment by Ryan Haasken [ 11/Nov/14 ]

From Fan Yong on LUDOC-244:

Currently, LFSCK use two phases scanning to guarantee all the inconsistency can be handled completely and efficiently.

1) The first-stage scanning
There is a LFSCK main engine on every MDT/OST that involves the LFSCK. During the first-stage scanning, each LFSCK main engine scans its local device via low layer object-table based iteration that uses linear scanning method and guarantees that all the objects related with this server (MDT or OST) will be checked. But sometimes, the LFSCK cannot know whether the object is inconsistency or cannot know how to repair the inconsistency until the first-stage scanning finished. Then the LFSCK needs the second-stage scanning.

2) The second-stage scanning
During the first stage-scaninng, some uncertain objects will be recorded, depends on the LFSCK type.

2.1) For namespace LFSCK, the object will multiple hard-links, or with multiple linkEA entries, or with remote parent, and so on, will be recorded in the namespace LFSCK tracing file. And then, in the second-stage scanning, the namespace LFSCK will scan the objects in the namespace LFSCK tracing file in turn and handle the uncertain inconsistency.

2.2) For layout LFSCK, the OST-objects that are not referenced by any MDT-object are recorded in a bitmap. When the LFSCK moves to the second-stage scanning, the OST-objects in such bitmap will be re-scanned to check whether they are really orphans or not.

I think it would be appropriate to describe these phases in the "Description" sections of the "LFSCK status of namespace via procfs" and "LFSCK status of layout via procfs" sections.

Comment by Ryan Haasken [ 11/Nov/14 ]

http://review.whamcloud.com/#/c/12676/

Comment by Gerrit Updater [ 10/Feb/16 ]

Richard Henwood (richard.henwood@intel.com) merged in patch http://review.whamcloud.com/12676/
Subject: LUDOC-261 lfsck: Describe phases of namespace/layout LFSCK
Project: doc/manual
Branch: master
Current Patch Set:
Commit: 7406eeae7c8acb7598d59d28d0183657005fc6bd

Comment by Ryan Haasken [ 19/Feb/16 ]

This can be closed now. Thanks, Richard.

Generated at Sat Feb 10 03:41:30 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.