https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LUDOC-98 Lustre Documentation <p>This is to track documentation for the "lctl replace_nids" feature in <a href="https://jira.whamcloud.com/browse/LU-1430" title="Changing network address without --writeconf option" class="issue-link" data-issue-key="LU-1430"><del>LU-1430</del></a>.</p> LUDOC-98

Document new lctl replace_nids feature

Task Blocker Closed Fixed Richard Henwood Andreas Dilger LB Sat, 27 Oct 2012 17:07:12 +0000 Fri, 9 May 2014 20:09:29 +0000 Fri, 9 May 2014 20:09:29 +0000 0 6 <p>Doc:</p> <h1><a name="14.5ChangingaServerNID"></a>14.5 Changing a Server NID</h1> <p>If you need to change the NID on the MDT or an OST, a special command must be issued with all Lustre servers and clients down, except for the MGS.<br/> Change a server NID in these situations:<br/> ■ New server hardware is added to the file system, and the MDS or an OSS is being moved to the new machine<br/> ■ New network card is installed in the server<br/> ■ You want to reassign IP addresses</p> <p>The <em>replace_nids</em> command differs from <em>tunefs.lustre --writeconf</em> in that it does not erase the entire configuration log, precluding the need to "writeconf" all servers and re-specify all permanent parameter settings. However, the "writeconf" method can still be used if desired.</p> <p>To change a server NID:</p> <ol> <li>Update the LNET configuration in the /etc/modprobe.conf file so the list of server NIDs (lctl list_nids) is correct.<br/> The lctl list_nids command indicates which network(s) are configured to work with Lustre.<br/> Chapter 14 Lustre Maintenance 14-5</li> <li>Shut down the file system in this order.<br/> a. Unmount the clients.<br/> b. Unmount the MDT.<br/> c. Unmount all OSTs.</li> <li>If the MGS and MDS share a partition, start the MGS only: <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">mount -t lustre &lt;MDT partition&gt; -o nosvc &lt;mount point&gt;</pre> </div></div></li> <li>Run the <em>replace_nids</em> command on the MGS. <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"> lctl replace_nids &lt;devicename&gt; &lt;nid1&gt;[,nid2,nid3 ...]</pre> </div></div> <p>where &lt;devicename&gt; is the Lustre target name, e.g. myfs-OST0013</p></li> <li>If the MGS and MDS share a partition, stop the MGS: <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">umount &lt;mount point&gt;</pre> </div></div></li> <li>Restart the file system in this order.<br/> a. Mount the MDT (or the combined MGS/MDT).<br/> b. Mount the OSTs.<br/> c. Mount the clients.</li> </ol> <p>Note: The <em>replace_nids</em> command also cleans all old, invalidated records out of the configuration log, while preserving all other current settings. <br/> Note: The previous configuration log is backed up on the MGS disk with the suffix '.bak'.</p> <p>Nathan, this would be better off in the form of a patch to the manual (as posted to the list last week), rather than a comment in this ticket. Don't get me wrong, I'm happy to have this text from you, but we're trying to get more contributors to the manual, and if Richard and I are the only ones making the updates, the process and visibility into the manual will never improve for external contributors. </p> <p>Can you clarify: are there now two methods to change a NID depending on which version of Lustre is being used?</p> <p>This patch adds new method to change a NID. But you can use previous with --writeconf that is described here <a href="http://wiki.lustre.org/manual/LustreManual20_HTML/LustreMaintenance.html#50438199_31353" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.lustre.org/manual/LustreManual20_HTML/LustreMaintenance.html#50438199_31353</a></p> <p>After the landing of <a href="https://jira.whamcloud.com/browse/LU-1430" title="Changing network address without --writeconf option" class="issue-link" data-issue-key="LU-1430"><del>LU-1430</del></a>, the method described here should be used. In previous versions of Lustre, back to 1.6, the old version must be used.</p> <p>I don't think there is any confusion about the actual documentation or where it applies. My comments are related to actually getting the text that Nathan wrote into the Lustre Manual. Please see:</p> <p><a href="http://wiki.whamcloud.com/display/PUB/Making+changes+to+the+Lustre+Manual" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.whamcloud.com/display/PUB/Making+changes+to+the+Lustre+Manual</a><br/> <a href="http://wiki.whamcloud.com/display/PUB/Making+changes+to+the+Lustre+Manual+source" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.whamcloud.com/display/PUB/Making+changes+to+the+Lustre+Manual+source</a><br/> <a href="http://wiki.whamcloud.com/display/PUB/Guidance+for+Manual+reviewers" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.whamcloud.com/display/PUB/Guidance+for+Manual+reviewers</a></p> <p>Artem, could you please submit a patch to the Lustre manual with the text that Nathan pasted above. Please see the following pages for details:</p> <p><a href="http://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual</a><br/> <a href="http://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual+source" class="external-link" target="_blank" rel="nofollow noopener">http://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual+source</a></p> <p><a href="http://review.whamcloud.com/7459" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/7459</a></p> <p>Artem's change landed a while ago.</p> Related LU-1430 Development Rank 1|hzvaw7: Rank (Obsolete) 5301