-#LyX 1.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 220
-\textclass manpage
+#LyX 1.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 221
+\textclass amsart
\language english
\inputencoding auto
\fontscheme times
\layout Section
+lmc
+\layout Subsection
+
NAME
-\layout Standard
+\layout Description
-lctl - low level Lustre file system configuration utility
-\layout Section
+lmc Lustre configuration maker.
+\layout Subsection
SYNOPSIS
\layout Standard
\series bold
-lctl
+lmc [options] --add <objectype> [args]
\layout Standard
\series bold
-lctl\SpecialChar ~
---device\SpecialChar ~
-<devno> <command\SpecialChar ~
-[args]>
+lmc [options] --remove <objecttype> [args] -- [NOT IMPLEMENTED]
\layout Standard
\series bold
-lctl\SpecialChar ~
---threads\SpecialChar ~
-<numthreads>\SpecialChar ~
-<verbose>\SpecialChar ~
-<devno>\SpecialChar ~
-<command [args]>
-\layout Section
+lmc [options] --convert [args] -- [NOT IMPLEMENTED]
+\layout Subsection
DESCRIPTION
\layout Standard
-The program can be invoked in interactive mode by issuing
+At present
\series bold
-lctl.
-
+\emph on
+lmc
\series default
- After than commands are issued as below.
+\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
-For non-interactive single threaded use, one uses the second invocation
- which runs
+The
\emph on
-command
+objecttype
\emph default
- after connecting to the
+ 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
-device.
-
+objecttype
\emph default
+.
+\layout Standard
+
+To generate configuration data associated with systems in a Lustre cluster:
\layout Description
---device The device number to be used for the operation.
- The value of devno is an integer, normally found by calling
+
\emph on
-lctl name2dev
+-
\emph default
-on a device name.
+-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
---threads How many threads should be forked doing the command specified.
- The numthreads variable is a strictly positivie integer indicating how
- many threads should be started.
- Verbose can take values <XXXX>,
+--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
-devno
+-
\emph default
-is used as above.
-\layout Section
+-add\SpecialChar ~
+net Adds a network device descriptor for the given node, with parameters
+ as indicated.
+\begin_deeper
+\layout Standard
-SUBCOMMANDS
+The arguments required are:
\layout Description
-network\SpecialChar ~
-config
+--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, ibnal.
+\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
-network\SpecialChar ~
-<tcp/elans/myrinet> Indicate what kind of network applies for the
- configuration commands that follow.
+--node\SpecialChar ~
+<node\SpecialChar ~
+name> Name of the node on which the MDS resides
\layout Description
-connect\SpecialChar ~
-[[<hostname>\SpecialChar ~
-<port>]\SpecialChar ~
-|\SpecialChar ~
-<elan\SpecialChar ~
-id>]
+--mds\SpecialChar ~
+<mds_name> Specify MDS name.
\layout Description
-disconnect
+--mdsuuid\SpecialChar ~
+<uuid> Specify MDS uuid.
\layout Description
-mynid
+--failover Enable failover support on MDS.
\layout Description
-add_uuid
+--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
-close_uuid
+--backdev\SpecialChar ~
+<pathname> Path of the device for backing storage on local system.
\layout Description
-del_uuid
+--size\SpecialChar ~
+<size> Optional argument indicating the size (in KB) of the device
+ to be created (used typically for loop devices).
\layout Description
-add_route
+--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
-del_route
+--backfstype\SpecialChar ~
+ext3|tmpfs Optional argument to specify the backing filesystem
+ type.
\layout Description
-route_list
+--nspath Local mount point of server namespace.
\layout Description
-recv_mem
+--inode_size\SpecialChar ~
+<size> Specify new inode size for underlying ext3 file system.
\layout Description
-send_mem
+--mkfsoptions\SpecialChar ~
+<options> Optional argument to mkfs.
\layout Description
-nagle
+--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
-device\SpecialChar ~
-selection
+--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
-newdev
+--lov\SpecialChar ~
+<name> Specify LOV name.
+\layout Description
+
+--mds\SpecialChar ~
+<name> Specify the mds name.
\layout Description
-name2dev
+--stripe_sz\SpecialChar ~
+<size> Specify the stripe size in bytes.
\layout Description
-device
+--stripe_cnt\SpecialChar ~
+<count> A value of 0 for this means to stripe on all available
+ OSTs.
+ Default is 0.
\layout Description
-device_list
+--stripe_pattern\SpecialChar ~
+<pattern> Only Pattern 0 (RAID 0) is supported currently.
\end_deeper
\layout Description
-device\SpecialChar ~
-config
+--add\SpecialChar ~
+ost Creates an OBD, OST, and OSC.
+ The OST and OBD are created on the specified node.
\begin_deeper
\layout Description
-attach
+--ost\SpecialChar ~
+<name> Assign a name to the OST device.
\layout Description
-setup
+--node\SpecialChar ~
+<nodename> Node on which the OST service is run, can not be a profile
+ node.
\layout Description
-cleanup
+--failover Enable failover support on OST.
\layout Description
-detach
+--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
-lovconfig
-\end_deeper
+--backdev\SpecialChar ~
+<pathname> Path of the device for backing storage on local system.
\layout Description
-device\SpecialChar ~
-operations
-\begin_deeper
+--size\SpecialChar ~
+[size] Optional argument indicating the size (in KB) of the device
+ to be created (used typically for loop devices).
\layout Description
-probe
+--osdtype\SpecialChar ~
+obdfilter|obdecho Specify the type of OSD.
\layout Description
-close
+--lov\SpecialChar ~
+<name> Optional arguement.
+ Name of LOV to which this OSC will be attached.
+
\layout Description
-getattr
+--ostuuid\SpecialChar ~
+UUID Specify the UUID of the OST device.
+
\layout Description
-setattr
+--fstype\SpecialChar ~
+extN|ext3 Optional arguement used to specify the file system type.
+ Default is ext3.
\layout Description
-create
+--backfstype\SpecialChar ~
+ext3|tmpfs Optional argument to specify the backing filesystem
+ type.
\layout Description
-destroy
+--inode_size\SpecialChar ~
+<size> Specify new inode size for underlying ext3 file system.
\layout Description
-test_getattr
+--nspath Local mount point of server namespace.
\layout Description
-test_brw
+--mkfsoptions\SpecialChar ~
+<options> Optional argument to mkfs.
\layout Description
-test_ldlm
+--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
-ldlm_regress_start
+--path\SpecialChar ~
+/mnt/path Specify the mountpoint for Lustre.
\layout Description
-ldlm_regress_stop
+--mds\SpecialChar ~
+mds_name Specify the mds name, which will provide service for this
+ client.
\layout Description
-dump_ldlm
+--ost\SpecialChar ~
+ost_name\SpecialChar ~
+|\SpecialChar ~
+--lov\SpecialChar ~
+lov_name Specify the ost or lov, which will provide service
+ for this client.
\layout Description
-newconn
+--clientoptions Specify the options for Lustre, such as async.
\end_deeper
\layout Description
-debug
+--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
-debug_kernel
+--node\SpecialChar ~
+node Node to add the route to.
\layout Description
-debug_file
+--router Optional flag to mark a node as router.
\layout Description
-clear
+--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
-mark
+--target_cluster_id\SpecialChar ~
+id Specify the id of the cluster, to which the target
+ of the route belongs.
\layout Description
-filter
+--lo\SpecialChar ~
+nid For a range route, this is the lo value
+\emph on
+nid.
\layout Description
-show
+--hi\SpecialChar ~
+nid For a range route, this is the hi value
+\emph on
+nid.
+\end_deeper
\layout Description
-debug_list\SpecialChar ~
-modules
+--add\SpecialChar ~
+echo-client Used for testing purpose only.
+
+\begin_deeper
\layout Description
-panic
+--node\SpecialChar ~
+nodename
+\emph on
+
+\emph default
+Node on which the echo-client resides.
\end_deeper
\layout Description
-control
+--add\SpecialChar ~
+mgmt Management/monitoring service.
\begin_deeper
\layout Description
-help
+--node\SpecialChar ~
+nodename
+\emph on
+
+\emph default
+Node on which the mgmt service resides.
\layout Description
-exit
+--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
-quit
+--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 Section
+\layout List
+\labelwidthstring 00.00.0000
-EXAMPLES
-\layout Section
-BUGS
+\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
-None are known.
-\layout Section
+Real life examples are given in the Lustre-conf manual page.
+\layout Subsection
-AUTHOR
+BUGS
\layout Standard
-Cluster File Systems, Inc.
- 2002 - created
+None are known.
\the_end
git://git.whamcloud.com / fs / lustre-release.git / blobdiff