From f290d597aa7607e711432db61e747d5167941b38 Mon Sep 17 00:00:00 2001
From: Andreas Dilger <adilger@whamcloud.com>
Date: Fri, 15 Nov 2024 16:18:44 -0700
Subject: [PATCH] LUDOC-11 admin: copy more files to new MGT

When copying the MGS config files to a new MGT, there are more files
to be copied today than there were in the past.

Reformat the <screen> sections so that there is only one block for
those commands instead of one per line.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I933db03a30785659efedc82a9206428cf81af631
Reviewed-on: https://review.whamcloud.com/c/doc/manual/+/57048
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Ellis Wilson <elliswilson@microsoft.com>
---
 LustreMaintenance.xml | 45 +++++++++++++++++++++++++++++----------------
 1 file changed, 29 insertions(+), 16 deletions(-)

diff --git a/LustreMaintenance.xml b/LustreMaintenance.xml
index 34a95a1..f6bce01 100644
--- a/LustreMaintenance.xml
+++ b/LustreMaintenance.xml
@@ -862,34 +862,47 @@ Changing the Address of a Failover Node</title>
         <listitem>
           <para>Stop the MDS.</para>
           <para>Unmount the MDT</para>
-	      <screen>umount -f <replaceable>/dev/mdt_device</replaceable> </screen>
-        </listitem>
-        <listitem>
-          <para>Create the MGS.</para>
-	      <screen>mds# mkfs.lustre --mgs --device-size=<replaceable>size</replaceable> <replaceable>/dev/mgs_device</replaceable></screen>
-        </listitem>
-        <listitem>
-          <para>Copy the configuration data from MDT disk to the new MGS disk.</para>
-	      <screen>mds# mount -t ldiskfs -o ro <replaceable>/dev/mdt_device</replaceable> <replaceable>/mdt_mount_point</replaceable></screen>
-	      <screen>mds# mount -t ldiskfs -o rw <replaceable>/dev/mgs_device</replaceable> <replaceable>/mgs_mount_point</replaceable> </screen>
-	      <screen>mds# cp -r <replaceable>/mdt_mount_point</replaceable>/CONFIGS/<replaceable>filesystem_name</replaceable>-* <replaceable>/mgs_mount_point</replaceable>/CONFIGS/. </screen>
-	      <screen>mds# umount <replaceable>/mgs_mount_point</replaceable></screen>
-	      <screen>mds# umount <replaceable>/mdt_mount_point</replaceable></screen>
+            <screen>
+mds# umount -f <replaceable>/dev/mdt_device</replaceable>
+            </screen>
+        </listitem>
+        <listitem>
+          <para>Create the MGT filesystem.</para>
+            <screen>
+mds# mkfs.lustre --mgs <replaceable>/dev/mgt_device</replaceable>
+            </screen>
+        </listitem>
+        <listitem>
+          <para>Copy the configuration data from MDT disk to the new MGT disk.</para>
+	      <screen>
+mds# mount -t ldiskfs -o ro <replaceable>/dev/mdt_device</replaceable> <replaceable>/mdt_mount_point</replaceable>
+mds# mount -t ldiskfs -o rw <replaceable>/dev/mgt_device</replaceable> <replaceable>/mgt_mount_point</replaceable>
+mds# cp -av <replaceable>/mdt_mount_point</replaceable>/CONFIGS/<replaceable>filesystem_name</replaceable>-* <replaceable>/mgt_mount_point</replaceable>/CONFIGS/
+mds# cp -av <replaceable>/mdt_mount_point</replaceable>/CONFIGS/{params,nodemap,sptlrpc}* <replaceable>/mgt_mount_point</replaceable>/CONFIGS/
+mds# umount <replaceable>/mgt_mount_point</replaceable>
+mds# umount <replaceable>/mdt_mount_point</replaceable>
+              </screen>
           <para>See <xref linkend="lustremaint.regenerateConfigLogs"/> for alternative method.</para>
         </listitem>
         <listitem>
           <para>Start the MGS.</para>
-	      <screen>mgs# mount -t lustre <replaceable>/dev/mgs_device</replaceable> <replaceable>/mgs_mount_point</replaceable></screen>
+            <screen>
+mgs# mount -t lustre <replaceable>/dev/mgt_device</replaceable> <replaceable>/mgt_mount_point</replaceable>
+            </screen>
           <para>Check to make sure it knows about all your file system</para>
 	      <screen>mgs:/root# lctl get_param mgs.MGS.filesystems</screen>
         </listitem>
         <listitem>
           <para>Remove the MGS option from the MDT, and set the new MGS nid.</para>
-	      <screen>mds# tunefs.lustre --nomgs --mgsnode=<replaceable>new_mgs_nid</replaceable> <replaceable>/dev/mdt-device</replaceable></screen>
+            <screen>
+mds# tunefs.lustre --nomgs --mgsnode=<replaceable>new_mgs_nid</replaceable> <replaceable>/dev/mdt-device</replaceable>
+            </screen>
         </listitem>
         <listitem>
           <para>Start the MDT.</para>
-	      <screen>mds# mount -t lustre <replaceable>/dev/mdt_device /mdt_mount_point</replaceable></screen>
+	      <screen>
+mds# mount -t lustre <replaceable>/dev/mdt_device /mdt_mount_point</replaceable>
+              </screen>
           <para>Check to make sure the MGS configuration looks right:</para>
 	      <screen>mgs# lctl get_param mgs.MGS.live.<replaceable>filesystem_name</replaceable></screen>
         </listitem>
-- 
1.8.3.1