[LUDOC-271] Wrong documentation for DNE in admin manual

• Status: Resolved
• Project: Lustre Documentation
• Type: Bug
• Priority: Minor
• Reporter: Frank Heckes (Inactive)
• Assignee: Joseph Gmitter (Inactive)
• Resolution: Not a Bug
• Labels: soak
• Severity: 3

Description

At top of page 82 of the Lustre admin guide (https://build.hpdd.intel.com/job/lustre-manual/lastSuccessfulBuild/artifact/lustre_manual.pdf) the instruction for enabling DNE are wrong. They should read as:

To relax this restriction and enable remote sub-directories off any MDT, an administrator must issue the command lctl set_param -n mdt.{MDT-device-name}.enable_remote_dir=1.

Comments

[Peter Jones]

Frank

Are you familiar with how to push such corrections?

Peter

[Frank Heckes (Inactive)]

Peter: Sorry for opening the ticket with wrong target. Many thanks for correcting it.
No, I newer push any correction for the Lustre documentation, yet.

[Peter Jones]

Hopefully https://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual+source helps

[Richard Henwood (Inactive)]

Hi Frank,

Have you made any progress with this ticket?

[Andreas Dilger]

Joe, this looks like a simple one to fix?

[Joseph Gmitter (Inactive)]

Andreas: Sure - I'll walk though each of the steps and make sure they are correct and the captured output from commands is also still correct.

[Joseph Gmitter (Inactive)]

The instructions also need to be run on the MDS for that MDT when there are multiple MDSs (instead of the mgs).
The instructions should be:

.....To relax this restriction and enable remote sub-directories off any MDT, an administrator must issue the following command on the MDS:
mds# lctl set_param mdt.{MDT-device-name}.enable_remote_dir=1

For Lustre filesystem 'testfs', the command executed is:
mds1# lctl set_param mdt.testfs-MDT0001.enable_remote_dir=1

To verify the configuration setting execute the following command on any MDS:
mds# lctl get_param mdt.*.enable_remote_dir

[Gerrit Updater]

Joseph Gmitter ([e-mail]) uploaded a new patch: https://review.whamcloud.com/26037
Subject: LUDOC-271 dne: section for creating subdir on a given MDT
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: 00ec99c7b9531ae81d27fe6a5051f563a159d6b4

[Joseph Gmitter (Inactive)]

Existing commands work as expected to permanently change the settings.