Whamcloud - gitweb
add examples to demonstrate how to use add net and add route commands in lmc
authorhejin <hejin>
Fri, 8 Oct 2004 09:30:00 +0000 (09:30 +0000)
committerhejin <hejin>
Fri, 8 Oct 2004 09:30:00 +0000 (09:30 +0000)
lustre/doc/lmc.1
lustre/doc/lmc.lyx

index 3e2d19b..1b24ef8 100644 (file)
@@ -296,6 +296,13 @@ Print system commands as they are run.
 --batch filename 
 Used to execute lmc commands in batch mode.
 .SH EXAMPLES
-Real life examples are given in the Lustre-conf manual page.
+.TP
+.B lmc --node adev3 --add net --nid adev3 --cluster_id 0x1000 --nettype tcp --hostaddr adev3-eth0 --port 988
+.TP
+.B lmc --node adev3 --add net --nid adev3 --cluster_id 0x2000 --nettype tcp --hostaddr adev3-eth1 --port 989
+Used to add a Lustre node to a specified Lustre cluster through a network interface. In this example, Lustre node adev3 has been added to 2 Lustre clusters whose cluster_id are 0x1000 and 0x2000 separately through 2 network interface cards: adev3-eth0 and adev3-eth1. adev3 would listen in some specified port(s) to prepare for possible connection requests from nodes in these two clusters.
+.TP
+.B lmc --node adev3 --add route --nettype tcp --gw 5 --gateway_cluster_id 0x1000 --target_cluster_id 0x1000 --lo 4 --hi 7
+Used to add a route entry for a Lustre node. Here Lustre node adev3 is told it has a new route entry that now it could send packets to Lustre nodes whose nids is from 4 to 7 with the help of Lustre gateway node whose nid is 5. Besides, Lustre gateway node is in cluster whose id is 0x1000 and target of the route belongs to cluster whose id is also 0x1000. The network in this route path is a tcp network.
 .SH BUGS
 None are known.
index f8b018d..183994b 100644 (file)
-#LyX 1.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 221
-\textclass amsart
-\language english
-\inputencoding auto
-\fontscheme times
-\graphics default
-\paperfontsize default
-\spacing single 
-\papersize letterpaper
-\paperpackage a4
-\use_geometry 0
-\use_amsmath 0
-\use_natbib 0
-\use_numerical_citations 0
-\paperorientation portrait
-\secnumdepth 3
-\tocdepth 3
-\paragraph_separation skip
-\defskip medskip
-\quotes_language english
-\quotes_times 2
-\papercolumns 1
-\papersides 1
-\paperpagestyle default
-
-\layout Section
-
-lmc
-\layout Subsection
-
-NAME
-\layout Description
-
-lmc Lustre configuration maker.
-\layout Subsection
-
-SYNOPSIS
-\layout Standard
-
-
-\series bold 
-lmc [options] --add <objectype> [args] 
-\layout Standard
-
-
-\series bold 
-lmc [options] --remove <objecttype> [args] -- [NOT IMPLEMENTED]
-\layout Standard
-
-
-\series bold 
-lmc [options] --convert [args] -- [NOT IMPLEMENTED]
-\layout Subsection
-
-DESCRIPTION
-\layout Standard
-
-At present 
-\series bold 
-\emph on 
-lmc
-\series default 
-\emph default 
-, when invoked, adds configuration data to the config file.
- In future, 
-\series bold 
-\emph on 
-lmc
-\series default 
-\emph default 
- will also be able to remove configuration data or convert its format.
- A Lustre cluster consists of several components - MDS's, mount-points,
- OSTs, LOVs and whatever those reference (e.g nets and profiles).
- A single configuration file would be generated for the complete cluster.
- In the 
-\series bold 
-\emph on 
-lmc
-\series default 
-\emph default 
- command line interface, each of these components is associated with an
-\emph on 
-objecttype
-\emph default 
-.
-\layout Standard
-
-The 
-\emph on 
-objecttype
-\emph default 
- refers to a collection of related configuration entities and can be one
- of 
-\series bold 
-net
-\series default 
-,
-\series bold 
- MDS
-\series default 
-,
-\series bold 
- LOV
-\series default 
-,
-\series bold 
- OST
-\series default 
-,
-\series bold 
- mtpt
-\series default 
-,
-\series bold 
- route
-\series default 
-,
-\series bold 
- echo_client, or cobd.
-\series default 
-We describe the arguments required for the addition of each 
-\emph on 
-objecttype
-\emph default 
-.
-\layout Standard
-
-To generate configuration data associated with systems in a Lustre cluster:
-\layout Description
-
-
-\emph on 
--
-\emph default 
--add\SpecialChar ~
-node Adds a new node in the cluster configuration.
-\begin_deeper 
-\layout Standard
-
-The arguments required are:
-\layout Description
-
---node\SpecialChar ~
-''node_name'' This will create a new node with the given name if not
- already present.
-\layout Description
-
---timeout\SpecialChar ~
-<num> Timeout before going into recovery
-\layout Description
-
---lustre_upcall\SpecialChar ~
-<path> Set the location of the Lustre upcall scripts used
- by the client for recovery
-\layout Description
-
---portals_upcall\SpecialChar ~
-<path> Specify the location of the Portals upcall scripts
- used by the client for recovery
-\layout Description
-
---upcall\SpecialChar ~
-<path> Specify the location of both (Lustre and Portals) upcall
- scripts used by the client for recovery
-\layout Description
-
---ptldebug\SpecialChar ~
-<debug_level> Set the portals debug level.
-\layout Description
-
---subsytem\SpecialChar ~
-<subsystem_name> Specify which Lustre subsystems have debug output
- recorded in the log.
-\end_deeper 
-\layout Description
-
-
-\emph on 
--
-\emph default 
--add\SpecialChar ~
-net Adds a network device descriptor for the given node, with parameters
- as indicated.
-\begin_deeper 
-\layout Standard
-
-The arguments required are:
-\layout Description
-
---node\SpecialChar ~
-''node_name'' This will create a new node with the given name if not
- already present.
- This is also used to specify a specific node for other elements.
-\layout Description
-
---nettype\SpecialChar ~
-<type> Specify the network type.This can be 
-\series bold 
-tcp, elan, gm.
-\layout Description
-
---nid\SpecialChar ~
-nid The network 
-\emph on 
-id
-\emph default 
-, e.g.
- ElanID or IP address as used by Portals.
- If 
-\emph on 
-nid
-\emph default 
- is '*', then the local address of the interface with specified 
-\series bold 
-nettype 
-\series default 
-is will be substituted when the node is configured with lconf.
- An 
-\emph on 
-nid
-\emph default 
- of 
-\emph on 
-'*'
-\emph default 
- should be used only for the generic 
-\emph on 
-client
-\emph default 
- configuration.
-\layout Description
-
---cluster_id\SpecialChar ~
-id Specify the cluster ID.
-\layout Description
-
---hostaddr\SpecialChar ~
-addr Specify the host address.
- lconf will transfer it to the real host address.
-\layout Description
-
---router Optional flag to mark this node as a router
-\layout Description
-
---port\SpecialChar ~
-[port] Optional arguement to indicate the tcp port.
- The default is 988.
-\layout Description
-
---tcpbuf\SpecialChar ~
-<size> Optional arguement.
- The default TCP buffer size is 1MB.
-\layout Description
-
---irq_affinity\SpecialChar ~
-0|1 Optional arguement.
- Default is 0.
-\layout Description
-
---nid_exchange\SpecialChar ~
-0|1 Optional arguement since some OSTs might not have the
- required support.
- This is turned off by default, value of 1 will turn it ON.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-mds
-\begin_deeper 
-\layout Description
-
---node\SpecialChar ~
-<node\SpecialChar ~
-name> Name of the node on which the MDS resides
-\layout Description
-
---mds\SpecialChar ~
-<mds_name> Specify MDS name.
-\layout Description
-
---mdsuuid\SpecialChar ~
-<uuid> Specify MDS uuid.
-\layout Description
-
---failover Enable failover support on MDS.
-\layout Description
-
---dev\SpecialChar ~
-<pathname> Path of device on local system.
- If the is a file, then a loop device is created and used as the block device.
-\layout Description
-
---backdev\SpecialChar ~
-<pathname> Path of the device for backing storage on local system.
-\layout Description
-
---size\SpecialChar ~
-<size> Optional argument indicating the size (in KB) of the device
- to be created (used typically for loop devices).
-\layout Description
-
---node\SpecialChar ~
-<nodename> Adds an MDS to the specified node.
- This requires a 
-\emph on 
---node
-\emph default 
- argument, and it must not be a profile node.
-\layout Description
-
---fstype\SpecialChar ~
-extN|ext3 Optional argument used to specify the file system type.
- Default is ext3.
-\layout Description
-
---backfstype\SpecialChar ~
-ext3|tmpfs Optional argument to specify the backing filesystem
- type.
-\layout Description
-
---nspath Local mount point of server namespace.
-\layout Description
-
---inode_size\SpecialChar ~
-<size> Specify new inode size for underlying ext3 file system.
-\layout Description
-
---mkfsoptions\SpecialChar ~
-<options> Optional argument to mkfs.
-\layout Description
-
---mountfsoptions\SpecialChar ~
-<options> Optional argument to mount fs.
- Mount options will be passed by this argument.
- For example, extents are to be enabled by adding ",extents" to the --mountfsopt
-ions option.
-\begin_inset Quotes eld
-\end_inset 
-
-errors=remount-ro
-\begin_inset Quotes erd
-\end_inset 
-
- and 
-\begin_inset Quotes eld
-\end_inset 
-
-asyncdel
-\begin_inset Quotes erd
-\end_inset 
-
- can also be added to it.
-\layout Description
-
---journal_size\SpecialChar ~
-<size> Optional arguement to specify the journal size for
- the ext2/ext3 file system.
- The size should be in the units expected by 
-\series bold 
-mkfs
-\series default 
-, so for ext3 it should be in MB.
- If this is option is not used, the ext2/ext3 filesystem will be configured
- with the default journal size.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-lov Creates an LOV with the specified parameters.
- The 
-\emph on 
-mds_name
-\emph default 
- must already exist in the descriptor.
-\begin_deeper 
-\layout Description
-
---lov\SpecialChar ~
-<name> Specify LOV name.
-\layout Description
-
---mds\SpecialChar ~
-<name> Specify the mds name.
-\layout Description
-
---stripe_sz\SpecialChar ~
-<size> Specify the stripe size in bytes.
-\layout Description
-
---stripe_cnt\SpecialChar ~
-<count> A value of 0 for this means to stripe on all available
- OSTs.
- Default is 0.
-\layout Description
-
---stripe_pattern\SpecialChar ~
-<pattern> Only Pattern 0 (RAID 0) is supported currently.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-ost Creates an OBD, OST, and OSC.
- The OST and OBD are created on the specified node.
-\begin_deeper 
-\layout Description
-
---ost\SpecialChar ~
-<name> Assign a name to the OST device.
-\layout Description
-
---node\SpecialChar ~
-<nodename> Node on which the OST service is run, can not be a profile
- node.
-\layout Description
-
---failover Enable failover support on OST.
-\layout Description
-
---dev\SpecialChar ~
-<pathname> Path of device on local system.
- If this is a file, then a loop device is created and used as the block
- device.
-\layout Description
-
---backdev\SpecialChar ~
-<pathname> Path of the device for backing storage on local system.
-\layout Description
-
---size\SpecialChar ~
-[size] Optional argument indicating the size (in KB) of the device
- to be created (used typically for loop devices).
-\layout Description
-
---osdtype\SpecialChar ~
-obdfilter|obdecho Specify the type of OSD.
-\layout Description
-
---lov\SpecialChar ~
-<name> Optional arguement.
- Name of LOV to which this OSC will be attached.
-\layout Description
-
---ostuuid\SpecialChar ~
-UUID Specify the UUID of the OST device.
-\layout Description
-
---fstype\SpecialChar ~
-extN|ext3 Optional arguement used to specify the file system type.
- Default is ext3.
-\layout Description
-
---backfstype\SpecialChar ~
-ext3|tmpfs Optional argument to specify the backing filesystem
- type.
-\layout Description
-
---inode_size\SpecialChar ~
-<size> Specify new inode size for underlying ext3 file system.
-\layout Description
-
---nspath Local mount point of server namespace.
-\layout Description
-
---mkfsoptions\SpecialChar ~
-<options> Optional argument to mkfs.
-\layout Description
-
---mountfsoptions\SpecialChar ~
-<options> Optional argument to mount fs.
- Mount options will be passed by this argument.
- For example, extents are to be enabled by adding ",extents" to the --mountfsopt
-ions option.
-\begin_inset Quotes eld
-\end_inset 
-
-errors=remount-ro
-\begin_inset Quotes erd
-\end_inset 
-
- and 
-\begin_inset Quotes eld
-\end_inset 
-
-asyncdel
-\begin_inset Quotes erd
-\end_inset 
-
- can also be added to it.
-\layout Description
-
---journal_size\SpecialChar ~
-<size> Optional arguement to specify the journal size for
- the ext2/ext3 file system.
- The size should be in the units expected by 
-\series bold 
-mkfs
-\series default 
-, so for ext3 it should be in MB.
- If this is option is not used, the ext2/ext3 filesystem will be configured
- with the default journal size.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-mtpt Creates a mount-point on the specified node.
- Either an LOV or OSC name can be used.
-\begin_deeper 
-\layout Description
-
---node\SpecialChar ~
-node Node or profile node that will use the 
-\emph on 
-mtpt
-\emph default 
-.
-\layout Description
-
---path\SpecialChar ~
-/mnt/path Specify the mountpoint for Lustre.
-\layout Description
-
---mds\SpecialChar ~
-mds_name Specify the mds name, which will provide service for this
- client.
-\layout Description
-
---ost\SpecialChar ~
-ost_name\SpecialChar ~
-|\SpecialChar ~
---lov\SpecialChar ~
-lov_name Specify the ost or lov, which will provide service
- for this client.
-\layout Description
-
---clientoptions Specify the options for Lustre, such as async.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-route Creates a static route through a gateway to a specific 
-\emph on 
-nid
-\emph default 
- or a range of 
-\emph on 
-nid
-\emph default 
-'s.
-\begin_deeper 
-\layout Description
-
---node\SpecialChar ~
-node Node to add the route to.
-\layout Description
-
---router Optional flag to mark a node as router.
-\layout Description
-
---gw\SpecialChar ~
-nid The 
-\emph on 
-nid
-\emph default 
- of the gateway (must be a local interface or a peer).
-\layout Description
-
---gateway_cluster_id\SpecialChar ~
-id Specify the id of the cluster, to which the gateway
- belongs.
-\layout Description
-
---target_cluster_id\SpecialChar ~
-id Specify the id of the cluster, to which the target
- of the route belongs.
-\layout Description
-
---lo\SpecialChar ~
-nid For a range route, this is the lo value 
-\emph on 
-nid.
-\layout Description
-
---hi\SpecialChar ~
-nid For a range route, this is the hi value 
-\emph on 
-nid.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-echo-client Used for testing purpose only.
-\begin_deeper 
-\layout Description
-
---node\SpecialChar ~
-nodename
-\emph on 
-\emph default 
-Node on which the echo-client resides.
-\end_deeper 
-\layout Description
-
---add\SpecialChar ~
-mgmt Management/monitoring service.
-\begin_deeper 
-\layout Description
-
---node\SpecialChar ~
-nodename
-\emph on 
-\emph default 
-Node on which the mgmt service resides.
-\layout Description
-
---mgmt\SpecialChar ~
-<mgmt_service_name> Specify management/monitoring service name.
-\end_deeper 
-\layout List
-\labelwidthstring 00.00.0000
-
-
-\series bold 
---add\SpecialChar ~
-cobd 
-\series default 
-Create the cobd on the specified node.
-\begin_deeper 
-\layout Description
-\noindent \align left 
---node\SpecialChar ~
-nodename
-\emph on 
-\emph default 
-Node on which the cobd resides.
-\layout Description
-
---cache_obd\SpecialChar ~
-obd_name Specify the cache device for the cache obd system.
-\layout Description
-
---real_obd\SpecialChar ~
-obd_name
-\emph on 
-\emph default 
-Specify the real device for the cache obd system.
-\end_deeper 
-\layout List
-\labelwidthstring 00.00.0000
-
-
-\series bold 
-Options
-\layout Description
-
---reference Print short reference for commands.
-\layout Description
-
---verbose Print system commands as they are run.
-\layout Description
-
---batch\SpecialChar ~
-filename Used to execute lmc commands in batch mode.
-\layout Description
-
---output\SpecialChar ~
-filename Send output to the file.
- If the file exists, it will be overwritten.
-\layout Description
-
---merge\SpecialChar ~
-filename
-\emph on 
-\emph default 
-Add the new element to an existing file.
-\layout Subsection
-
-EXAMPLES
-\layout Standard
-
-Real life examples are given in the Lustre-conf manual page.
-\layout Subsection
-
-BUGS
-\layout Standard
-
-None are known.
-\the_end
+#LyX 1.3 created this file. For more info see http://www.lyx.org/\r
+\lyxformat 221\r
+\textclass amsart\r
+\language english\r
+\inputencoding auto\r
+\fontscheme times\r
+\graphics default\r
+\paperfontsize default\r
+\spacing single \r
+\papersize letterpaper\r
+\paperpackage a4\r
+\use_geometry 0\r
+\use_amsmath 0\r
+\use_natbib 0\r
+\use_numerical_citations 0\r
+\paperorientation portrait\r
+\secnumdepth 3\r
+\tocdepth 3\r
+\paragraph_separation skip\r
+\defskip medskip\r
+\quotes_language english\r
+\quotes_times 2\r
+\papercolumns 1\r
+\papersides 1\r
+\paperpagestyle default\r
+\r
+\layout Section\r
+\r
+lmc\r
+\layout Subsection\r
+\r
+NAME\r
+\layout Description\r
+\r
+lmc Lustre configuration maker.\r
+\layout Subsection\r
+\r
+SYNOPSIS\r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc [options] --add <objectype> [args] \r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc [options] --remove <objecttype> [args] -- [NOT IMPLEMENTED]\r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc [options] --convert [args] -- [NOT IMPLEMENTED]\r
+\layout Subsection\r
+\r
+DESCRIPTION\r
+\layout Standard\r
+\r
+At present \r
+\series bold \r
+\emph on \r
+lmc\r
+\series default \r
+\emph default \r
+, when invoked, adds configuration data to the config file.\r
+ In future, \r
+\series bold \r
+\emph on \r
+lmc\r
+\series default \r
+\emph default \r
+ will also be able to remove configuration data or convert its format.\r
+ A Lustre cluster consists of several components - MDS's, mount-points,\r
+ OSTs, LOVs and whatever those reference (e.g nets and profiles).\r
+ A single configuration file would be generated for the complete cluster.\r
+ In the \r
+\series bold \r
+\emph on \r
+lmc\r
+\series default \r
+\emph default \r
+ command line interface, each of these components is associated with an\r
\r
+\emph on \r
+objecttype\r
+\emph default \r
+.\r
\r
+\layout Standard\r
+\r
+The \r
+\emph on \r
+objecttype\r
+\emph default \r
+ refers to a collection of related configuration entities and can be one\r
+ of \r
+\series bold \r
+net\r
+\series default \r
+,\r
+\series bold \r
+ MDS\r
+\series default \r
+,\r
+\series bold \r
+ LOV\r
+\series default \r
+,\r
+\series bold \r
+ OST\r
+\series default \r
+,\r
+\series bold \r
+ mtpt\r
+\series default \r
+,\r
+\series bold \r
+ route\r
+\series default \r
+,\r
+\series bold \r
+ echo_client, or cobd.\r
\r
+\series default \r
+We describe the arguments required for the addition of each \r
+\emph on \r
+objecttype\r
+\emph default \r
+.\r
\r
+\layout Standard\r
+\r
+To generate configuration data associated with systems in a Lustre cluster:\r
+\layout Description\r
+\r
+\r
+\emph on \r
+-\r
+\emph default \r
+-add\SpecialChar ~\r
+node Adds a new node in the cluster configuration.\r
\r
+\begin_deeper \r
+\layout Standard\r
+\r
+The arguments required are:\r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+''node_name'' This will create a new node with the given name if not\r
+ already present.\r
+\layout Description\r
+\r
+--timeout\SpecialChar ~\r
+<num> Timeout before going into recovery\r
+\layout Description\r
+\r
+--lustre_upcall\SpecialChar ~\r
+<path> Set the location of the Lustre upcall scripts used\r
+ by the client for recovery\r
+\layout Description\r
+\r
+--portals_upcall\SpecialChar ~\r
+<path> Specify the location of the Portals upcall scripts\r
+ used by the client for recovery\r
+\layout Description\r
+\r
+--upcall\SpecialChar ~\r
+<path> Specify the location of both (Lustre and Portals) upcall\r
+ scripts used by the client for recovery\r
+\layout Description\r
+\r
+--ptldebug\SpecialChar ~\r
+<debug_level> Set the portals debug level.\r
+\layout Description\r
+\r
+--subsytem\SpecialChar ~\r
+<subsystem_name> Specify which Lustre subsystems have debug output\r
+ recorded in the log.\r
+\end_deeper \r
+\layout Description\r
+\r
+\r
+\emph on \r
+-\r
+\emph default \r
+-add\SpecialChar ~\r
+net Adds a network device descriptor for the given node, with parameters\r
+ as indicated.\r
+\begin_deeper \r
+\layout Standard\r
+\r
+The arguments required are:\r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+''node_name'' This will create a new node with the given name if not\r
+ already present.\r
+ This is also used to specify a specific node for other elements.\r
+\layout Description\r
+\r
+--nettype\SpecialChar ~\r
+<type> Specify the network type.This can be \r
+\series bold \r
+tcp, elan, gm.\r
+\layout Description\r
+\r
+--nid\SpecialChar ~\r
+nid The network \r
+\emph on \r
+id\r
+\emph default \r
+, e.g.\r
+ ElanID or IP address as used by Portals.\r
+ If \r
+\emph on \r
+nid\r
+\emph default \r
+ is '*', then the local address of the interface with specified \r
+\series bold \r
+nettype \r
+\series default \r
+is will be substituted when the node is configured with lconf.\r
+ An \r
+\emph on \r
+nid\r
+\emph default \r
+ of \r
+\emph on \r
+'*'\r
+\emph default \r
+ should be used only for the generic \r
+\emph on \r
+client\r
+\emph default \r
+ configuration.\r
+\layout Description\r
+\r
+--cluster_id\SpecialChar ~\r
+id Specify the cluster ID.\r
+\layout Description\r
+\r
+--hostaddr\SpecialChar ~\r
+addr Specify the host address.\r
+ lconf will transfer it to the real host address.\r
+\layout Description\r
+\r
+--router Optional flag to mark this node as a router\r
+\layout Description\r
+\r
+--port\SpecialChar ~\r
+[port] Optional arguement to indicate the tcp port.\r
+ The default is 988.\r
\r
+\layout Description\r
+\r
+--tcpbuf\SpecialChar ~\r
+<size> Optional arguement.\r
+ The default TCP buffer size is 1MB.\r
+\layout Description\r
+\r
+--irq_affinity\SpecialChar ~\r
+0|1 Optional arguement.\r
+ Default is 0.\r
+\layout Description\r
+\r
+--nid_exchange\SpecialChar ~\r
+0|1 Optional arguement since some OSTs might not have the\r
+ required support.\r
+ This is turned off by default, value of 1 will turn it ON.\r
\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+mds\r
+\begin_deeper \r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+<node\SpecialChar ~\r
+name> Name of the node on which the MDS resides\r
+\layout Description\r
+\r
+--mds\SpecialChar ~\r
+<mds_name> Specify MDS name.\r
+\layout Description\r
+\r
+--mdsuuid\SpecialChar ~\r
+<uuid> Specify MDS uuid.\r
+\layout Description\r
+\r
+--failover Enable failover support on MDS.\r
+\layout Description\r
+\r
+--dev\SpecialChar ~\r
+<pathname> Path of device on local system.\r
+ If the is a file, then a loop device is created and used as the block device.\r
+\layout Description\r
+\r
+--backdev\SpecialChar ~\r
+<pathname> Path of the device for backing storage on local system.\r
+\layout Description\r
+\r
+--size\SpecialChar ~\r
+<size> Optional argument indicating the size (in KB) of the device\r
+ to be created (used typically for loop devices).\r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+<nodename> Adds an MDS to the specified node.\r
+ This requires a \r
+\emph on \r
+--node\r
+\emph default \r
+ argument, and it must not be a profile node.\r
+\layout Description\r
+\r
+--fstype\SpecialChar ~\r
+extN|ext3 Optional argument used to specify the file system type.\r
+ Default is ext3.\r
+\layout Description\r
+\r
+--backfstype\SpecialChar ~\r
+ext3|tmpfs Optional argument to specify the backing filesystem\r
+ type.\r
+\layout Description\r
+\r
+--nspath Local mount point of server namespace.\r
+\layout Description\r
+\r
+--inode_size\SpecialChar ~\r
+<size> Specify new inode size for underlying ext3 file system.\r
+\layout Description\r
+\r
+--mkfsoptions\SpecialChar ~\r
+<options> Optional argument to mkfs.\r
+\layout Description\r
+\r
+--mountfsoptions\SpecialChar ~\r
+<options> Optional argument to mount fs.\r
+ Mount options will be passed by this argument.\r
+ For example, extents are to be enabled by adding ",extents" to the --mountfsopt\r
+ions option.\r
\r
+\begin_inset Quotes eld\r
+\end_inset \r
+\r
+errors=remount-ro\r
+\begin_inset Quotes erd\r
+\end_inset \r
+\r
+ and \r
+\begin_inset Quotes eld\r
+\end_inset \r
+\r
+asyncdel\r
+\begin_inset Quotes erd\r
+\end_inset \r
+\r
+ can also be added to it.\r
+\layout Description\r
+\r
+--journal_size\SpecialChar ~\r
+<size> Optional arguement to specify the journal size for\r
+ the ext2/ext3 file system.\r
+ The size should be in the units expected by \r
+\series bold \r
+mkfs\r
+\series default \r
+, so for ext3 it should be in MB.\r
+ If this is option is not used, the ext2/ext3 filesystem will be configured\r
+ with the default journal size.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+lov Creates an LOV with the specified parameters.\r
+ The \r
+\emph on \r
+mds_name\r
+\emph default \r
+ must already exist in the descriptor.\r
+\begin_deeper \r
+\layout Description\r
+\r
+--lov\SpecialChar ~\r
+<name> Specify LOV name.\r
+\layout Description\r
+\r
+--mds\SpecialChar ~\r
+<name> Specify the mds name.\r
+\layout Description\r
+\r
+--stripe_sz\SpecialChar ~\r
+<size> Specify the stripe size in bytes.\r
+\layout Description\r
+\r
+--stripe_cnt\SpecialChar ~\r
+<count> A value of 0 for this means to stripe on all available\r
+ OSTs.\r
+ Default is 0.\r
+\layout Description\r
+\r
+--stripe_pattern\SpecialChar ~\r
+<pattern> Only Pattern 0 (RAID 0) is supported currently.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+ost Creates an OBD, OST, and OSC.\r
+ The OST and OBD are created on the specified node.\r
+\begin_deeper \r
+\layout Description\r
+\r
+--ost\SpecialChar ~\r
+<name> Assign a name to the OST device.\r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+<nodename> Node on which the OST service is run, can not be a profile\r
+ node.\r
+\layout Description\r
+\r
+--failover Enable failover support on OST.\r
+\layout Description\r
+\r
+--dev\SpecialChar ~\r
+<pathname> Path of device on local system.\r
+ If this is a file, then a loop device is created and used as the block\r
+ device.\r
+\layout Description\r
+\r
+--backdev\SpecialChar ~\r
+<pathname> Path of the device for backing storage on local system.\r
+\layout Description\r
+\r
+--size\SpecialChar ~\r
+[size] Optional argument indicating the size (in KB) of the device\r
+ to be created (used typically for loop devices).\r
+\layout Description\r
+\r
+--osdtype\SpecialChar ~\r
+obdfilter|obdecho Specify the type of OSD.\r
+\layout Description\r
+\r
+--lov\SpecialChar ~\r
+<name> Optional arguement.\r
+ Name of LOV to which this OSC will be attached.\r
\r
+\layout Description\r
+\r
+--ostuuid\SpecialChar ~\r
+UUID Specify the UUID of the OST device.\r
\r
+\layout Description\r
+\r
+--fstype\SpecialChar ~\r
+extN|ext3 Optional arguement used to specify the file system type.\r
+ Default is ext3.\r
+\layout Description\r
+\r
+--backfstype\SpecialChar ~\r
+ext3|tmpfs Optional argument to specify the backing filesystem\r
+ type.\r
+\layout Description\r
+\r
+--inode_size\SpecialChar ~\r
+<size> Specify new inode size for underlying ext3 file system.\r
+\layout Description\r
+\r
+--nspath Local mount point of server namespace.\r
+\layout Description\r
+\r
+--mkfsoptions\SpecialChar ~\r
+<options> Optional argument to mkfs.\r
+\layout Description\r
+\r
+--mountfsoptions\SpecialChar ~\r
+<options> Optional argument to mount fs.\r
+ Mount options will be passed by this argument.\r
+ For example, extents are to be enabled by adding ",extents" to the --mountfsopt\r
+ions option.\r
\r
+\begin_inset Quotes eld\r
+\end_inset \r
+\r
+errors=remount-ro\r
+\begin_inset Quotes erd\r
+\end_inset \r
+\r
+ and \r
+\begin_inset Quotes eld\r
+\end_inset \r
+\r
+asyncdel\r
+\begin_inset Quotes erd\r
+\end_inset \r
+\r
+ can also be added to it.\r
+\layout Description\r
+\r
+--journal_size\SpecialChar ~\r
+<size> Optional arguement to specify the journal size for\r
+ the ext2/ext3 file system.\r
+ The size should be in the units expected by \r
+\series bold \r
+mkfs\r
+\series default \r
+, so for ext3 it should be in MB.\r
+ If this is option is not used, the ext2/ext3 filesystem will be configured\r
+ with the default journal size.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+mtpt Creates a mount-point on the specified node.\r
+ Either an LOV or OSC name can be used.\r
+\begin_deeper \r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+node Node or profile node that will use the \r
+\emph on \r
+mtpt\r
+\emph default \r
+.\r
+\layout Description\r
+\r
+--path\SpecialChar ~\r
+/mnt/path Specify the mountpoint for Lustre.\r
+\layout Description\r
+\r
+--mds\SpecialChar ~\r
+mds_name Specify the mds name, which will provide service for this\r
+ client.\r
+\layout Description\r
+\r
+--ost\SpecialChar ~\r
+ost_name\SpecialChar ~\r
+|\SpecialChar ~\r
+--lov\SpecialChar ~\r
+lov_name Specify the ost or lov, which will provide service\r
+ for this client.\r
+\layout Description\r
+\r
+--clientoptions Specify the options for Lustre, such as async.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+route Creates a static route through a gateway to a specific \r
+\emph on \r
+nid\r
+\emph default \r
+ or a range of \r
+\emph on \r
+nid\r
+\emph default \r
+'s.\r
+\begin_deeper \r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+node Node to add the route to.\r
+\layout Description\r
+\r
+--router Optional flag to mark a node as router.\r
+\layout Description\r
+\r
+--gw\SpecialChar ~\r
+nid The \r
+\emph on \r
+nid\r
+\emph default \r
+ of the gateway (must be a local interface or a peer).\r
+\layout Description\r
+\r
+--gateway_cluster_id\SpecialChar ~\r
+id Specify the id of the cluster, to which the gateway\r
+ belongs.\r
+\layout Description\r
+\r
+--target_cluster_id\SpecialChar ~\r
+id Specify the id of the cluster, to which the target\r
+ of the route belongs.\r
+\layout Description\r
+\r
+--lo\SpecialChar ~\r
+nid For a range route, this is the lo value \r
+\emph on \r
+nid.\r
+\layout Description\r
+\r
+--hi\SpecialChar ~\r
+nid For a range route, this is the hi value \r
+\emph on \r
+nid.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+echo-client Used for testing purpose only.\r
\r
+\begin_deeper \r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+nodename\r
+\emph on \r
\r
+\emph default \r
+Node on which the echo-client resides.\r
+\end_deeper \r
+\layout Description\r
+\r
+--add\SpecialChar ~\r
+mgmt Management/monitoring service.\r
+\begin_deeper \r
+\layout Description\r
+\r
+--node\SpecialChar ~\r
+nodename\r
+\emph on \r
\r
+\emph default \r
+Node on which the mgmt service resides.\r
+\layout Description\r
+\r
+--mgmt\SpecialChar ~\r
+<mgmt_service_name> Specify management/monitoring service name.\r
+\end_deeper \r
+\layout List\r
+\labelwidthstring 00.00.0000\r
+\r
+\r
+\series bold \r
+--add\SpecialChar ~\r
+cobd \r
+\series default \r
+Create the cobd on the specified node.\r
+\begin_deeper \r
+\layout Description\r
+\noindent \align left \r
+--node\SpecialChar ~\r
+nodename\r
+\emph on \r
\r
+\emph default \r
+Node on which the cobd resides.\r
+\layout Description\r
+\r
+--cache_obd\SpecialChar ~\r
+obd_name Specify the cache device for the cache obd system.\r
+\layout Description\r
+\r
+--real_obd\SpecialChar ~\r
+obd_name\r
+\emph on \r
\r
+\emph default \r
+Specify the real device for the cache obd system.\r
+\end_deeper \r
+\layout List\r
+\labelwidthstring 00.00.0000\r
+\r
+\r
+\series bold \r
+Options\r
+\layout Description\r
+\r
+--reference Print short reference for commands.\r
+\layout Description\r
+\r
+--verbose Print system commands as they are run.\r
+\layout Description\r
+\r
+--batch\SpecialChar ~\r
+filename Used to execute lmc commands in batch mode.\r
+\layout Description\r
+\r
+--output\SpecialChar ~\r
+filename Send output to the file.\r
+ If the file exists, it will be overwritten.\r
+\layout Description\r
+\r
+--merge\SpecialChar ~\r
+filename\r
+\emph on \r
\r
+\emph default \r
+Add the new element to an existing file.\r
\r
+\layout Subsection\r
+\r
+EXAMPLES\r
+\layout Subsubsection\r
+\r
+--add net\r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc --node adev3 --add net --nid adev3 --cluster_id 0x1000 --nettype tcp\r
+ --hostaddr adev3-eth0 --port 988\r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc --node adev3 --add net --nid adev3 --cluster_id 0x2000 --nettype tcp\r
+ --hostaddr adev3-eth1 --port 989\r
+\series default \r
+\emph on \r
\r
+\layout Standard\r
+\r
+Used to add a Lustre node to a specified Lustre cluster through a network\r
+ interface.\r
+ In this example, Lustre node adev3 has been added to 2 Lustre clusters\r
+ whose cluster_id are 0x1000 and 0x2000 separately through 2 network interface\r
+ cards: adev3-eth0 and adev3-eth1.\r
+ adev3 would listen in some specified port(s) to prepare for possible connection\r
+ requests from nodes in these two clusters.\r
+\layout Subsubsection\r
+\r
+--add route\r
+\layout Standard\r
+\r
+\r
+\series bold \r
+lmc --node adev3 --add route --nettype tcp --gw 5 --gateway_cluster_id 0x1000\r
+ --target_cluster_id 0x1000 --lo 4 --hi 7\r
+\layout Standard\r
+\r
+Used to add a route entry for a Lustre node.\r
+ Here Lustre node adev3 is told it has a new route entry that now it could\r
+ send packets to Lustre nodes whose nids is from 4 to 7 with the help of\r
+ Lustre gateway node whose nid is 5.\r
+ Besides, Lustre gateway node is in cluster whose id is 0x1000 and target\r
+ of the route belongs to cluster whose id is also 0x1000.\r
+ The network in this route path is a tcp network.\r
+\layout Subsection\r
+\r
+BUGS\r
+\layout Standard\r
+\r
+None are known.\r
+\the_end\r