[LUDOC-361] Documentation for Progressive File Layouts (PFL) feature

• Status: Resolved
• Project: Lustre Documentation
• Type: Improvement
• Priority: Minor
• Reporter: Joseph Gmitter (Inactive)
• Assignee: Emoly Liu
• Resolution: Fixed

Description

Submit documentation for the PFL project being worked under LU-8998

Issue Links

• is related to: LU-8998 Progressive File Layout (PFL)

Comments

[Emoly Liu]

Here are some pieces of information about PFL I got from Bobijam:

• wiki page: https://wiki.hpdd.intel.com/display/PFL/
• patches: https://review.whamcloud.com/#/c/24851
• branch: pfl under fs/lustre-release

[Emoly Liu]

bobijam and niu, could you please review the PFL user guide I attached here? I added some examples according to the latest PFL patch and our discussion. Thanks.

[Zhenyu Xu]

It's a great user guide about PFL usage with graph and example illustration. I made a little adjustment recommendation in the uploaded doc.

[Niu Yawei (Inactive)]

The way to provide optional argument for 'lfs getstripe' is changed by https://review.whamcloud.com/#/c/26491/ , you need to update your document, thanks.

[Emoly Liu]

Thanks for Bobi and Niu's review. I will improve the doc according to your comments.

[Emoly Liu]

Just uploaded a new version user guide.

[Niu Yawei (Inactive)]

I think it's worth to mention that 'lfs find support layout component options now, and give some example of set default PFL layout to a directory or mount point.

[Emoly Liu]

I updated the PFL user guide per Niu's comment. The changes include:

• added commands/example to set default PFL layout to an existing directory
• added all kinds of PFL related "lfs getstripe" commands
• added all kinds of PFL related "lfs find" commands

Please have a check. Thanks!

[Emoly Liu]

Corrected some wrong option usages according to the latest fix and our discussion.
Please have a review. Thanks.

[Gerrit Updater]

Emoly Liu ([e-mail]) uploaded a new patch: https://review.whamcloud.com/26939
Subject: LUDOC-361 pfl: add pfl section to lustre manual
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: 6b69c2ed8e6f0fbc539d73b5aada11d2e0cdba3a

[Gerrit Updater]

Joseph Gmitter ([e-mail]) merged in patch https://review.whamcloud.com/26939/
Subject: LUDOC-361 pfl: add pfl section to lustre manual
Project: doc/manual
Branch: master
Current Patch Set:
Commit: adbc78c399697d8f3977a141efa7e7a025bc95e2

[Joseph Gmitter (Inactive)]

Landed patch.