-#LyX 1.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 220
+#LyX 1.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 221
\textclass amsart
\language english
\inputencoding auto
\series bold
-\emph on
lmc [options] --add <objectype> [args]
\layout Standard
\series bold
-NOT IMPLEMENTED
-\emph on
--- lmc [options] --remove <objecttype> [args]
+lmc [options] --remove <objecttype> [args] -- [NOT IMPLEMENTED]
\layout Standard
\series bold
-NOT IMPLEMENTED
-\emph on
--- lmc [options] --convert [args]
+lmc [options] --convert [args] -- [NOT IMPLEMENTED]
\layout Subsection
DESCRIPTION
\layout Standard
-At present lmc, when invoked, adds configuration data to the config file.
- lmc will also be able to remove configuration data or convert its format.
- One generates a single config file for the cluster at present including,
- at the minimum, MDS's, mtpt's, and OST's and whatever those reference (e.g.
- nets and profiles).
+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
refers to a collection of related configuration entities and can be one
of
\series bold
-net, MDS, LOV, OST, mtpt, route, or oscref.
+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
objecttype
\emph default
.
- [NOT IMPLEMENTED] lmc can also remove items from or convert the format
- of configuration data.
+
\layout Standard
To generate configuration data associated with systems in a Lustre cluster:
-\layout List
-\labelwidthstring 00.00.0000
+\layout Description
-\series bold
\emph on
---add\SpecialChar ~
-net
-\series default
+-
\emph default
- Adds a network device descriptor for the given node, with parameters as
- indicated.
+-add\SpecialChar ~
+node Adds a new node in the cluster configuration.
+
\begin_deeper
\layout Standard
The arguments required are:
-\layout List
-\labelwidthstring 00.00.0000
+\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
-\series bold
\emph on
---node\SpecialChar ~
-''node_name''
-\series default
+-
\emph default
- 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 List
-\labelwidthstring 00.00.0000
+-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
-\series bold
-\emph on
--nettype\SpecialChar ~
-<type>
-\series default
-\emph default
- This can be
+<type> Specify the network type.This can be
\series bold
tcp, elan, gm.
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--nid\SpecialChar ~
-nid
-\series default
-\emph default
- The network
+nid The network
\emph on
id
\emph default
ElanID or IP address as used by Portals.
If
\emph on
-host_name
+nid
\emph default
- is '*', then the local address while be substituted when the node is configured
- with lconf.
-\layout List
-\labelwidthstring 00.00.0000
-
-
+ is '*', then the local address of the interface with specified
\series bold
-\emph on
---router
+nettype
\series default
+is will be substituted when the node is configured with lconf.
+ An
+\emph on
+nid
\emph default
- Optional flag to mark this node as a router
-\layout List
-\labelwidthstring 00.00.0000
-
-
-\series bold
+ of
\emph on
---profile
-\series default
+'*'
\emph default
- Optional flag to mark this node as a profile node.
- This is automatically true if the the
+ should be used only for the generic
\emph on
---nid
+client
\emph default
- argument contains a '*'.
-\layout List
-\labelwidthstring 00.00.0000
+ 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
-\series bold
-\emph on
--port\SpecialChar ~
-[port]
-\series default
-\emph default
- Optional argument to indicate the tcp port.
+[port] Optional arguement to indicate the tcp port.
The default is 988.
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--tcpbuf\SpecialChar ~
-<size>
-\series default
-\emph default
- Optional argument.
-\end_deeper
-\layout List
-\labelwidthstring 00.00.0000
+<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
-\series bold
-\emph on
--add\SpecialChar ~
mds
\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
+\layout Description
+--node\SpecialChar ~
+<node\SpecialChar ~
+name> Name of the node on which the MDS resides
+\layout Description
-\series bold
-\emph on
--mds\SpecialChar ~
-<mds_name>
-\series default
-\emph default
-
-\layout List
-\labelwidthstring 00.00.0000
+<mds_name> Specify MDS name.
+\layout Description
+--failover Enable failover support on MDS.
+\layout Description
-\series bold
-\emph on
--dev\SpecialChar ~
-<pathname>
-\series default
-\emph default
- Path of device on local system.
+<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 List
-\labelwidthstring 00.00.0000
+\layout Description
+--backdev\SpecialChar ~
+<pathname> Path of the device for backing storage on local system.
+\layout Description
-\series bold
-\emph on
--size\SpecialChar ~
-<size>
-\series default
-\emph default
- Optional argument indicating the size of the device to be created (used
- typically for loop devices).
-\layout List
-\labelwidthstring 00.00.0000
-
+<size> Optional argument indicating the size (in KB) of the device
+ to be created (used typically for loop devices).
+\layout Description
-\series bold
-\emph on
--node\SpecialChar ~
-<nodename>
-\series default
-\emph default
- Adds an MDS to the specified node.
+<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.
-\end_deeper
-\layout List
-\labelwidthstring 00.00.0000
+\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
-\emph on
---add\SpecialChar ~
-lov
+mkfs
\series default
-\emph default
- Creates an LOV with the specified parameters.
+, 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 List
-\labelwidthstring 00.00.0000
-
-
-\series bold
-\emph on
---lov_<name>
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
---mds_<name>
-\layout List
-\labelwidthstring 00.00.0000
+--lov\SpecialChar ~
+<name> Specify LOV name.
+\layout Description
+--mds\SpecialChar ~
+<name> Specify the mds name.
+\layout Description
-\series bold
-\emph on
--stripe_sz\SpecialChar ~
-<size>
-\layout List
-\labelwidthstring 00.00.0000
-
+<size> Specify the stripe size in bytes.
+\layout Description
-\series bold
-\emph on
--stripe_cnt\SpecialChar ~
-<count>
-\layout List
-\labelwidthstring 00.00.0000
-
+<count> A value of 0 for this means to stripe on all available
+ OSTs.
+ Default is 0.
+\layout Description
-\series bold
-\emph on
--stripe_pattern\SpecialChar ~
-<pattern>
-\series default
-\emph default
- Pattern can be 0.
+<pattern> Only Pattern 0 (RAID 0) is supported currently.
\end_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--add\SpecialChar ~
-ost
-\series default
-\emph default
- Creates an OBD, OST, and OSC.
+ost Creates an OBD, OST, and OSC.
The OST and OBD are created on the specified node.
\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
-
-\series bold
-\emph on
---obd\SpecialChar ~
-<name>
-\series default
-\emph default
- Assign a name to the OBD device.
-\layout List
-\labelwidthstring 00.00.0000
+\layout Description
+--ost\SpecialChar ~
+<name> Assign a name to the OST device.
+\layout Description
-\series bold
-\emph on
--node\SpecialChar ~
-<nodename>
-\series default
-\emph default
- Node on which the OST service is run, can not be a profile node.
-\layout List
-\labelwidthstring 00.00.0000
+<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
-\series bold
-\emph on
--dev\SpecialChar ~
-<pathname>
-\series default
-\emph default
- Path of device on local system.
+<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 List
-\labelwidthstring 00.00.0000
+\layout Description
+--backdev\SpecialChar ~
+<pathname> Path of the device for backing storage on local system.
+\layout Description
-\series bold
-\emph on
--size\SpecialChar ~
-[size]
-\layout List
-\labelwidthstring 00.00.0000
+[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
-\series bold
-\emph on
--lov\SpecialChar ~
-<name>
-\series default
-\emph default
+<name> Optional arguement.
Name of LOV to which this OSC will be attached.
-\layout List
-\labelwidthstring 00.00.0000
+\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
---obduuid\SpecialChar ~
-UUID
+mkfs
\series default
- Specify the UUID of the OBD device.
- The default value is
-\emph on
-OBD_nodename_UUID
-\emph 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 List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--add\SpecialChar ~
-mtpt
-\series default
-\emph default
- Creates a mount-point on the specified node.
+mtpt Creates a mount-point on the specified node.
Either an LOV or OSC name can be used.
\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--node\SpecialChar ~
-node
-\series default
-\emph default
- Node or profile node that will use the
+node Node or profile node that will use the
\emph on
mtpt
\emph default
.
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--path\SpecialChar ~
-/mnt/path\SpecialChar ~
-
-\layout List
-\labelwidthstring 00.00.0000
-
+/mnt/path Specify the mountpoint for Lustre.
+\layout Description
-\series bold
-\emph on
--mds\SpecialChar ~
-mds_name
-\layout List
-\labelwidthstring 00.00.0000
-
+mds_name Specify the mds name, which will provide service for this
+ client.
+\layout Description
-\series bold
-\emph on
---obd\SpecialChar ~
-lov_name|osc_name
+--ost\SpecialChar ~
+ost_name\SpecialChar ~
+|\SpecialChar ~
+--lov\SpecialChar ~
+lov_name Specify the ost or lov, which will provide service
+ for this client.
\end_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--add\SpecialChar ~
-route
-\series default
-\emph default
- Creates a static route through a gateway to a specific
+route Creates a static route through a gateway to a specific
\emph on
nid
\emph default
\emph default
's.
\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--node\SpecialChar ~
-node
-\series default
-\emph default
- Node or profile node to add the route to.
-\layout List
-\labelwidthstring 00.00.0000
+node Node to add the route to.
+\layout Description
+--router Optional flag to mark a node as router.
+\layout Description
-\series bold
-\emph on
--gw\SpecialChar ~
-nid
-\series default
-\emph default
- The
+nid The
\emph on
nid
\emph default
of the gateway (must be a local interface or a peer).
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
---tgt\SpecialChar ~
-nid
-\series default
-\emph default
- For a specific route, this is the target
-\emph on
-nid.
-\layout List
-\labelwidthstring 00.00.0000
+--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
-\series bold
-\emph on
--lo\SpecialChar ~
-nid
-\series default
-\emph default
- For a range route, this is the lo value
+nid For a range route, this is the lo value
\emph on
nid.
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--hi\SpecialChar ~
-nid
-\series default
-\emph default
- For a range route, this is the hi value
+nid For a range route, this is the hi value
\emph on
nid.
\end_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--add\SpecialChar ~
-oscref
-\series default
-\emph default
- Adds an OSC reference to a node.
- This is only necessary when the the OSC will be used without a mount-point.
+echo-client Used for testing purpose only.
+
\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--node\SpecialChar ~
-node
-\series default
-\emph default
-Node or profile node to add the
+nodename
\emph on
-oscref
+
\emph default
- to.
+Node on which the echo-client resides.
+\end_deeper
\layout List
\labelwidthstring 00.00.0000
\series bold
-\emph on
---osc\SpecialChar ~
-osc_name
+--add\SpecialChar ~
+cobd
\series default
-\emph default
- Name of the OSC to add a reference to.
- The
+Create the cobd on the specified node.
+\begin_deeper
+\layout Description
+\noindent \align left
+--node\SpecialChar ~
+nodename
\emph on
---add
+
\emph default
- OST command automatically creates the OSC, and the name will be
+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
-OSC_<node>
+
\emph default
-, where node is the name of node the OST is on.
+Specify the real device for the cache obd system.
\end_deeper
\layout List
\labelwidthstring 00.00.0000
\series bold
Options
-\begin_deeper
-\layout List
-\labelwidthstring 00.00.0000
+\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
-\series bold
-\emph on
--output\SpecialChar ~
-filename
-\series default
-\emph default
- Send output to the file.
+filename Send output to the file.
If the file exists, it will be overwritten.
-\layout List
-\labelwidthstring 00.00.0000
-
+\layout Description
-\series bold
-\emph on
--merge\SpecialChar ~
-filename
-\series default
+filename
+\emph on
+
\emph default
Add the new element to an existing file.
-\end_deeper
\layout Subsection
EXAMPLES