From da5dce6fce923dd4ca93e1c2934574ac7894882f Mon Sep 17 00:00:00 2001 From: Bobi Jam Date: Thu, 22 Dec 2011 16:20:38 +0800 Subject: [PATCH] LUDOC-31 manual: add --servicenode option description Add --servicenode option description for mkfs.lustre and tune.lustre. Change XSL_REL in Makefile so that make gets correct install path of different version of docbook5 XSL stylesheets package. Signed-off-by: Bobi Jam Change-Id: If92af7e0839928ddfeb966090d75796c93b8499e --- LustreMaintenance.xml | 6 +++++- LustreOperations.xml | 3 ++- Makefile | 2 ++ SystemConfigurationUtilities.xml | 20 ++++++++++++++++++++ UnderstandingFailover.xml | 2 +- 5 files changed, 30 insertions(+), 3 deletions(-) diff --git a/LustreMaintenance.xml b/LustreMaintenance.xml index 6c75b6e..4246d3d 100644 --- a/LustreMaintenance.xml +++ b/LustreMaintenance.xml @@ -490,7 +490,11 @@ osc.lustre-OST0004-osc-f1579000.ost_conn_uuid=192.168.20.1@tcp
<indexterm><primary>maintance</primary><secondary>changing failover node address</secondary></indexterm> Changing the Address of a Failover Node - To change the address of a failover node (e.g, to use node X instead of node Y), run this command on the OSS/OST partition: tunefs.lustre --erase-params --failnode=<NID> <device> + To change the address of a failover node (e.g, to use node X instead of node Y), run this command on the OSS/OST partition: + tunefs.lustre --erase-params --failnode=<NID> <device> + or + tunefs.lustre --erase-params --servicenode=<NID> <device> +
diff --git a/LustreOperations.xml b/LustreOperations.xml index 397a4e2..67bbcc7 100644 --- a/LustreOperations.xml +++ b/LustreOperations.xml @@ -271,7 +271,7 @@ osc.myth-OST0004-osc-ffff8800376bdc00.cur_grant_bytes=33808384
<indexterm><primary>operations</primary><secondary>failover</secondary></indexterm>Specifying NIDs and Failover - If a node has multiple network interfaces, it may have multiple NIDs. When a node is specified, all of its NIDs must be listed, delimited by commas (,) so other nodes can choose the NID that is appropriate for their network interfaces. When failover nodes are specified, they are delimited by a colon (:) or by repeating a keyword (--mgsnode= or --failnode=). To obtain all NIDs from a node (while LNET is running), run: + If a node has multiple network interfaces, it may have multiple NIDs. When a node is specified, all of its NIDs must be listed, delimited by commas (,) so other nodes can choose the NID that is appropriate for their network interfaces. When failover nodes are specified, they are delimited by a colon (:) or by repeating a keyword (--mgsnode= or --failnode= or --servicenode=). To obtain all NIDs from a node (while LNET is running), run: lctl list_nids This displays the server's NIDs (networks configured to work with Lustre). This example has a combined MGS/MDT failover pair on mds0 and mds1, and a OST failover pair on oss0 and oss1. There are corresponding Elan addresses on mds0 and mds1. @@ -285,6 +285,7 @@ mds0> umount /mnt/mdt mds1> mount -t lustre /dev/sda1 /mnt/test/mdt mds1> cat /proc/fs/lustre/mds/testfs-MDT0000/recovery_status Where multiple NIDs are specified, comma-separation (for example, mds1,2@elan) means that the two NIDs refer to the same host, and that Lustre needs to choose the "best" one for communication. Colon-separation (for example, mds0:mds1) means that the two NIDs refer to two different hosts, and should be treated as failover locations (Lustre tries the first one, and if that fails, it tries the second one.) + Two options exist to specify failover nodes. --failnode and --servicenode. --failnode specifies the NIDs of failover nodes. --servicenode specifies all service NIDs, including those of the primary node and of failover nodes. Option --servicenode makes the MDT or OST treat all its service nodes equally. The first service node to load the target device becomes the primary service node. Other node NIDs will become failover locations for the target device. If you have an MGS or MDT configured for failover, perform these steps: diff --git a/Makefile b/Makefile index 6fa2c86..335ee38 100644 --- a/Makefile +++ b/Makefile @@ -19,9 +19,11 @@ RNG=$(or $(shell ls $(RNG_UBN) 2> /dev/null), \ $(shell ls $(RNG_MAC) 2> /dev/null)) XSL_UBN=/usr/share/xml/docbook/stylesheet/docbook-xsl-ns XSL_REL=/usr/share/sgml/docbook/xsl-ns-stylesheets-1.75.2 +XSL_F16=/usr/share/sgml/docbook/xsl-ns-stylesheets XSL_MAC=/opt/local/share/xsl/docbook-xsl XSL=$(or $(shell ls -d $(XSL_UBN) 2> /dev/null), \ $(shell ls -d $(XSL_REL) 2> /dev/null), \ + $(shell ls -d $(XSL_F16) 2> /dev/null), \ $(shell ls -d $(XSL_MAC) 2> /dev/null)) .PHONY: all diff --git a/SystemConfigurationUtilities.xml b/SystemConfigurationUtilities.xml index 5d40c5e..2075b63 100644 --- a/SystemConfigurationUtilities.xml +++ b/SystemConfigurationUtilities.xml @@ -1573,6 +1573,16 @@ mkfs.lustre Sets the NID(s) of a failover partner. This option can be repeated as needed. + CAUTION: Cannot be used with --servicenode. + + + + + --servicenode=nid,... + + + Sets the NID(s) of all service node, including failover partner as well as primary node service nids. This option can be repeated as needed. + CAUTION: Cannot be used with --failnode. @@ -2252,6 +2262,16 @@ tunefs.lustre Sets the NID(s) of a failover partner. This option can be repeated as needed. + CAUTION: Cannot be used with --servicenode. + + + + + --servicenode=nid,... + + + Sets the NID(s) of all service node, including failover partner as well as local service nids. This option can be repeated as needed. + CAUTION: Cannot be used with --failnode. diff --git a/UnderstandingFailover.xml b/UnderstandingFailover.xml index 9d0a0b7..c6e0cd5 100644 --- a/UnderstandingFailover.xml +++ b/UnderstandingFailover.xml @@ -66,7 +66,7 @@ For OST failover, multiple OSS nodes are configured to be able to serve the same OST. However, only one OSS node can serve the OST at a time. An OST can be moved between OSS nodes that have access to the same storage device using umount/mount commands. - To add a failover partner to a Lustre configuration, the --failnode option is used. This can be done at creation time (using mkfs.lustre) or later when the Lustre system is active (using tunefs.lustre). For explanations of these utilities, see and . + To add a failover partner to a Lustre configuration, the --failnode or --servicenode option is used. This can be done at creation time (using mkfs.lustre) or later when the Lustre system is active (using tunefs.lustre). For explanations of these utilities, see and . Lustre failover capability can be used to upgrade the Lustre software between successive minor versions without cluster downtime. For more information, see . For information about configuring failover, see . -- 1.8.3.1