From: radhikav Date: Thu, 24 Oct 2002 18:47:04 +0000 (+0000) Subject: New lmc manpage that describes the new lmc command line interface. X-Git-Tag: v1_7_100~4408 X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;ds=sidebyside;h=47931b97e6bc52ae62d45a3015d096e686dd7757;hp=36bdc5a55f831101b566a22c7914873e19264b3e;p=fs%2Flustre-release.git New lmc manpage that describes the new lmc command line interface. --- diff --git a/lustre/doc/lmc.lyx b/lustre/doc/lmc.lyx index f28944f..39e602f 100644 --- a/lustre/doc/lmc.lyx +++ b/lustre/doc/lmc.lyx @@ -32,7 +32,7 @@ lmc NAME \layout Standard -lctl - low level Lustre file system configuration utility +lmc - lustre configuration maker. \layout Subsection SYNOPSIS @@ -40,84 +40,253 @@ SYNOPSIS \series bold -lmc [options] [cmd args] +lmc [options] --add [args] +\layout Standard + + +\series bold +NOT IMPLEMENTED -- lmc [options] --remove [args] +\layout Standard + + +\series bold +NOT IMPLEMENTED -- lmc [options] --convert [args] \layout Subsection DESCRIPTION \layout Standard -lmc can be invoked to generate configuration data associated with systems - in a Lustre cluster. +At present lmc when invoked adds configuration data to the config file. + lmc will also be able to remove configuration data or convert its forma. + 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. + net's and profiles) +\layout Standard + +The objecttype refers to a collection of related configuration entities + and can be one of +\series bold +net, mds, lov, ost, mtpt, route, oscref. +\series default +We describe the arguments required for the addition of each objecttype. + [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 Description + +--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'' By itself, this will create a new node. +''node_name'' If not present this will create a new node with the + given name. This is also used to specify a specific node for other elements, and the \layout Description ---net\SpecialChar ~ -host_name\SpecialChar ~ -net_type\SpecialChar ~ -[port] Adds a network interface to a node. +--nettype\SpecialChar ~ + this can be +\series bold +tcp, elan, gm +\layout Description + +--nid\SpecialChar ~ +nid the network id, e.g. + ElanID or IP address as used by portals. If host_name is '*', then the local address while be substituted when the node is configured with lconf. - This requires a --node argument. +\layout Description + +--router optional flag to mark this node as a router +\layout Description + +--profile optional flag to mark this node as a profile node. + This is automatically true if the the --nid argument contains a '*'. +\layout Description + +--port\SpecialChar ~ +[port] optional argument to indicate the tcp port. + The default is 988. + +\layout Description + +--tcpbuf\SpecialChar ~ + optional argument +\end_deeper +\layout Description + +--add\SpecialChar ~ +mds +\begin_deeper \layout Description --mds\SpecialChar ~ -mds_name Adds an MDS to the specified node. - This requires a --node argument. + \layout Description ---lov\SpecialChar ~ -lov_name\SpecialChar ~ -mds_name\SpecialChar ~ -stripe_sz\SpecialChar ~ -stripe_off\SpecialChar ~ -pattern Creates an LOV with the - specified parameters. +--device\SpecialChar ~ + +\layout Description + +--size\SpecialChar ~ + optional argument indicating the size of the device to be created + (used typically for loop devices). +\layout Description + +--node\SpecialChar ~ + Adds an MDS to the specified node. + This requires a --node argument, and it must not be a profile node. +\end_deeper +\layout Description + +--add\SpecialChar ~ +lov Creates an LOV with the specified parameters. The mds_name must already exist in the descriptor. - When used as an argument to other commands, only the lov_name is specified. +\begin_deeper \layout Description ---ost\SpecialChar ~ -device\SpecialChar ~ -[size] Creates an OBD, OST, and OSC. +--lov_ +\layout Description + +--mds_ +\layout Description + +--stripesize\SpecialChar ~ + +\layout Description + +--stripecount\SpecialChar ~ + +\layout Description + +--pattern\SpecialChar ~ + Pattern can be 0. +\end_deeper +\layout Description + +--add\SpecialChar ~ +ost Creates an OBD, OST, and OSC. The OST and OBD are created on the specified node. - If an lov option is used, then the OSC will be added to the LOV. - Requires: --node. +\begin_deeper +\layout Description + +--ost\SpecialChar ~ + [NOT IMPLEMENTED] Name to give to this OST target. +\layout Description + +--node\SpecialChar ~ + Node on which the OST service is run, can not be a profile + node. +\layout Description + +--device\SpecialChar ~ + +\layout Description + +--size\SpecialChar ~ +[size] +\layout Description + +--lov\SpecialChar ~ + Name of LOV to which this OSC will be attached. + \layout Description --obduuid\SpecialChar ~ UUID specify the UUID of the OBD device. - + The default value is OBD_nodename_UUID. +\end_deeper \layout Description ---mtpt\SpecialChar ~ -/mnt/path\SpecialChar ~ -mdc_uuid\SpecialChar ~ -lov_uuid|osc_uuid Creates a mount point on the specified - node. +--add\SpecialChar ~ +mtpt Creates a mount point on the specified node. Either an LOV or OSC name can be used. - The default OSC name currently used is OSC_. - Requires: --node +\begin_deeper +\layout Description + +--node\SpecialChar ~ +node node or profile node that will use the mtpt +\layout Description + +--path\SpecialChar ~ +/mnt/path\SpecialChar ~ + +\layout Description + +--mds\SpecialChar ~ +mds_name +\layout Description + +--mdc\SpecialChar ~ +lov_name|osc_name +\end_deeper +\layout Description + +--add\SpecialChar ~ +route Creates a static route through a gateway to a specific nid or + a range of nids. +\begin_deeper +\layout Description + +--node\SpecialChar ~ +node node or profile node to add the route to +\layout Description + +--gw\SpecialChar ~ +nid the nid of the gateway (must be a local interface or a peer) +\layout Description + +--tgt\SpecialChar ~ +nid for a specific route, this is the target nid +\layout Description + +--lo\SpecialChar ~ +nid for a range route, this is the lo value nid +\layout Description + +--hi\SpecialChar ~ +nid for a range route, this is the hi value nid +\end_deeper +\layout Description + +--add\SpecialChar ~ +oscref Adds an OSC reference to a node. + This is only necessary when the the OSC will be used without a mountpoint. +\begin_deeper +\layout Description + +--node\SpecialChar ~ +node node or profile node to add the OSC ref to +\layout Description + +--osc\SpecialChar ~ +osc_name Name of the OSC to add a reference to. + The --add ost command automatically creates the OSC, and the name will + be OSC_, where node is the name of node the OST is on. +\end_deeper \layout Description Options: \begin_deeper \layout Description ---output filename Sends output to the file. +--output\SpecialChar ~ +filename Sends output to the file. If the file exists, it will be overwritten. \layout Description ---merge filename Add the new element to an existing file. +--merge\SpecialChar ~ +filename Add the new element to an existing file. -\layout Description - ---format Turns on autoformat. - The block devices for MDS and OBD will be formatted if necessary. \end_deeper \layout Subsection