From 9ca539d9c6f65272f165dbc8fdb269301334bd44 Mon Sep 17 00:00:00 2001 From: Joseph Gmitter Date: Thu, 7 Sep 2017 16:01:39 -0400 Subject: [PATCH] LUDOC-390 misc: Document shutdown procedure This patch creates a short section to document how to stop the entire Lustre filesystem. Currently the manual only details the startup procedure and how to shut down a specific target by using umount /mnt/mnt_point. Signed-off-by: Joseph Gmitter Change-Id: I1fd9123177433a539cab72f1edc165bcdf3e39f4 Reviewed-on: https://review.whamcloud.com/28902 Tested-by: Jenkins Reviewed-by: Saurabh Tandan Reviewed-by: James Nunez --- LustreOperations.xml | 87 +++++++++++++++++++++++++++++++++++++++++++++------- UpgradingLustre.xml | 19 ++---------- 2 files changed, 78 insertions(+), 28 deletions(-) diff --git a/LustreOperations.xml b/LustreOperations.xml index 64ddbb4..18acb13 100644 --- a/LustreOperations.xml +++ b/LustreOperations.xml @@ -134,22 +134,87 @@ LABEL=testfs-OST0000 /mnt/test/ost0 lustre defaults,_netdev,noauto 0 0 environment. -
+
+ + <indexterm> + <primary>operations</primary> + <secondary>shutdownLustre</secondary> + </indexterm>Stopping the Filesystem + A complete Lustre filesystem shutdown occurs by unmounting all + clients and servers in the order shown below. Please note that unmounting + a block device causes the Lustre software to be shut down on that node. + + Please note that the -a -t lustre in the + commands below is not the name of a filesystem, but rather is + specifying to unmount all entries in /etc/mtab that are of type + lustre + + Unmount the clients + On each client node, unmount the filesystem on that client + using the umount command: + umount -a -t lustre + The example below shows the unmount of the + testfs filesystem on a client node: + [root@client1 ~]# mount |grep testfs +XXX.XXX.0.11@tcp:/testfs on /mnt/testfs type lustre (rw,lazystatfs) + +[root@client1 ~]# umount -a -t lustre +[154523.177714] Lustre: Unmounted testfs-client + + Unmount the MDT and MGT + On the MGS and MDS node(s), use the umount + command: + umount -a -t lustre + The example below shows the unmount of the MDT and MGT for + the testfs filesystem on a combined MGS/MDS: + + [root@mds1 ~]# mount |grep lustre +/dev/sda on /mnt/mgt type lustre (ro) +/dev/sdb on /mnt/mdt type lustre (ro) + +[root@mds1 ~]# umount -a -t lustre +[155263.566230] Lustre: Failing over testfs-MDT0000 +[155263.775355] Lustre: server umount testfs-MDT0000 complete +[155269.843862] Lustre: server umount MGS complete + For a seperate MGS and MDS, the same command is used, first on + the MDS and then followed by the MGS. + + Unmount all the OSTs + On each OSS node, use the umount command: + + umount -a -t lustre + The example below shows the unmount of all OSTs for the + testfs filesystem on server + OSS1: + + [root@oss1 ~]# mount |grep lustre +/dev/sda on /mnt/ost0 type lustre (ro) +/dev/sdb on /mnt/ost1 type lustre (ro) +/dev/sdc on /mnt/ost2 type lustre (ro) + +[root@oss1 ~]# umount -a -t lustre +[155336.491445] Lustre: Failing over testfs-OST0002 +[155336.556752] Lustre: server umount testfs-OST0002 complete + + + For unmount command syntax for a single OST, MDT, or MGT target + please refer to +
+
<indexterm> <primary>operations</primary> <secondary>unmounting</secondary> - </indexterm>Unmounting a Server - To stop a Lustre server, use the + Unmounting a Specific Target on a Server + To stop a Lustre OST, MDT, or MGT , use the umount - /mount - point command. - For example, to stop - ost0 on mount point - /mnt/test, run: - -$ umount /mnt/test - + /mount_point command. + The example below stops an OST, ost0, on mount + point /mnt/ost0 for the testfs + filesystem: + [root@oss1 ~]# umount /mnt/ost0 +[ 385.142264] Lustre: Failing over testfs-OST0000 +[ 385.210810] Lustre: server umount testfs-OST0000 complete Gracefully stopping a server with the umount command preserves the state of the connected clients. The next time the server is started, it waits for clients to diff --git a/UpgradingLustre.xml b/UpgradingLustre.xml index 826217b..fc07672 100644 --- a/UpgradingLustre.xml +++ b/UpgradingLustre.xml @@ -178,23 +178,8 @@ xml:id="upgradinglustre"> - Shut down the file system by unmounting all clients and servers - in the order shown below (unmounting a block device causes the Lustre - software to be shut down on that node): - - - Unmount the clients. On each client node, run: - umount -a -t lustre - - - Unmount the MDT. On the MDS node, run: - umount -a -t lustre - - - Unmount all the OSTs. On each OSS node, run: - umount -a -t lustre - - + Shut down the entire filesystem by following + Upgrade the Linux operating system on all servers to a compatible -- 1.8.3.1