X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flmc.lyx;h=48fcb4b2a58c5b9f7e672a18ab9d935cc77fc0c7;hb=5900da4464d90468519964571c441382cd512232;hp=39e602f1882944f1c69208447b46fd6cb72b4926;hpb=47931b97e6bc52ae62d45a3015d096e686dd7757;p=fs%2Flustre-release.git diff --git a/lustre/doc/lmc.lyx b/lustre/doc/lmc.lyx index 39e602f..48fcb4b 100644 --- a/lustre/doc/lmc.lyx +++ b/lustre/doc/lmc.lyx @@ -1,5 +1,5 @@ -#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 @@ -30,9 +30,9 @@ lmc \layout Subsection NAME -\layout Standard +\layout Description -lmc - lustre configuration maker. +lmc Lustre configuration maker. \layout Subsection SYNOPSIS @@ -45,82 +45,235 @@ lmc [options] --add [args] \series bold -NOT IMPLEMENTED -- lmc [options] --remove [args] +lmc [options] --remove [args] -- [NOT IMPLEMENTED] \layout Standard \series bold -NOT IMPLEMENTED -- 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 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) +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 objecttype refers to a collection of related configuration entities - and can be one of +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 -net, mds, lov, ost, mtpt, route, oscref. + 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. - [NOT implemented] Lmc can also remove items from or convert the format - of configuration data. +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. +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 ---add\SpecialChar ~ +--node\SpecialChar ~ +''node_name'' This will create a new node with the given name if not + already present. +\layout Description + +--timeout\SpecialChar ~ + Timeout before going into recovery +\layout Description + +--lustre_upcall\SpecialChar ~ + Set the location of the Lustre upcall scripts used + by the client for recovery +\layout Description + +--portals_upcall\SpecialChar ~ + Specify the location of the Portals upcall scripts + used by the client for recovery +\layout Description + +--upcall\SpecialChar ~ + Specify the location of both (Lustre and Portals) upcall + scripts used by the client for recovery +\layout Description + +--group_upcall\SpecialChar ~ + Specify the location of the group upcall scripts used by the MDS + for determiningsupplementary group membership +\layout Description + +--ptldebug\SpecialChar ~ + Set the portals debug level. +\layout Description + +--subsytem\SpecialChar ~ + 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 +The arguments required are: \layout Description --node\SpecialChar ~ -''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 +''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 ~ - this can be + Specify the network type.This can be \series bold -tcp, elan, gm +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. +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 ---router optional flag to mark this node as a router +--hostaddr\SpecialChar ~ +addr Specify the host address. + lconf will transfer it to the real host address. \layout Description ---profile optional flag to mark this node as a profile node. - This is automatically true if the the --nid argument contains a '*'. +--router Optional flag to mark this node as a router \layout Description --port\SpecialChar ~ -[port] optional argument to indicate the tcp port. +[port] Optional arguement to indicate the tcp port. The default is 988. \layout Description --tcpbuf\SpecialChar ~ - optional argument + 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 @@ -129,47 +282,130 @@ mds \begin_deeper \layout Description +--node\SpecialChar ~ + Name of the node on which the MDS resides +\layout Description + --mds\SpecialChar ~ - + Specify MDS name. \layout Description ---device\SpecialChar ~ - +--mdsuuid\SpecialChar ~ + Specify MDS uuid. +\layout Description + +--failover Enable failover support on MDS. +\layout Description + +--dev\SpecialChar ~ + 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 --size\SpecialChar ~ - optional argument indicating the size of the device to be created - (used typically for loop devices). + Optional argument indicating the size (in KB) 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. + This requires a +\emph on +--node +\emph default + argument, and it must not be a profile node. +\layout Description + +--fstype\SpecialChar ~ +ldiskfs|ext3 Optional argument used to specify the file system type. + Default is ext3. For 2.6 kernels the ldiskfs filesystem must be used. +\layout Description + +--inode_size\SpecialChar ~ + Specify new inode size for underlying ext3 file system. Must be a + power of 2 between 128 and 4096. The default inode size is selected based + on the default number of stripes specified for the filesystem. +\layout Description + +--group_upcall\SpecialChar ~ + The group upcall program to call for resolving a user's secondary + groups. The default value is NONE, which means that the MDS will use whatever + supplementary group is passed from the client. The supplied upcall is + /usr/sbin/l_getgroups, which gets groups from the MDS's /etc/group file + based on the client-supplied UID. + +--mkfsoptions\SpecialChar ~ + Optional argument to mkfs. +\layout Description + +--mountfsoptions\SpecialChar ~ + 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 ~ + Optional arguement to specify the journal size for + the 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 ext3 filesystem will be configured + with a journal size dependent upon how large the filesystem is. \end_deeper \layout Description --add\SpecialChar ~ lov Creates an LOV with the specified parameters. - The mds_name must already exist in the descriptor. + The +\emph on +mds_name +\emph default + must already exist in the descriptor. \begin_deeper \layout Description ---lov_ +--lov\SpecialChar ~ + Specify LOV name. \layout Description ---mds_ +--mds\SpecialChar ~ + Specify the mds name. \layout Description ---stripesize\SpecialChar ~ - +--stripe_sz\SpecialChar ~ + Specify the stripe size in bytes. This much data is written to each + stripe before starting to write in the next stripe. Default is 1048576. \layout Description ---stripecount\SpecialChar ~ - +--stripe_cnt\SpecialChar ~ + A value of 0 for this means to use the currently optimal number + of stripes. Default is 1 stripe per file. \layout Description ---pattern\SpecialChar ~ - Pattern can be 0. +--stripe_pattern\SpecialChar ~ + Only Pattern 0 (RAID 0) is supported currently. \end_deeper \layout Description @@ -180,7 +416,7 @@ ost Creates an OBD, OST, and OSC. \layout Description --ost\SpecialChar ~ - [NOT IMPLEMENTED] Name to give to this OST target. + Assign a name to the OST device. \layout Description --node\SpecialChar ~ @@ -188,123 +424,268 @@ ost Creates an OBD, OST, and OSC. node. \layout Description ---device\SpecialChar ~ +--failover Enable failover support on OST. +\layout Description +--dev\SpecialChar ~ + 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 --size\SpecialChar ~ -[size] +[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 of LOV to which this OSC will be attached. + 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 ~ +ldiskfs|ext3 Optional arguement used to specify the file system type. + Default is ext3. +\layout Description + +--inode_size\SpecialChar ~ + Specify new inode size for underlying ext3 file system. +\layout Description + +--mkfsoptions\SpecialChar ~ + Optional argument to mkfs. +\layout Description + +--mountfsoptions\SpecialChar ~ + 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 ---obduuid\SpecialChar ~ -UUID specify the UUID of the OBD device. - The default value is OBD_nodename_UUID. +--journal_size\SpecialChar ~ + Optional arguement to specify the journal size for + the 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 ext3 filesystem will be configured + with a journal size dependent upon how large the filesystem is. \end_deeper \layout Description --add\SpecialChar ~ -mtpt Creates a mount point on the specified node. - Either an LOV or OSC name can be used. +mtpt Creates a mount-point on the specified node for the given LOV. \begin_deeper \layout Description --node\SpecialChar ~ -node node or profile node that will use the mtpt +node Node or profile node that will use the +\emph on +mtpt +\emph default +. \layout Description --path\SpecialChar ~ -/mnt/path\SpecialChar ~ - +/mnt/path Specify the mountpoint for Lustre. \layout Description --mds\SpecialChar ~ -mds_name +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 ---mdc\SpecialChar ~ -lov_name|osc_name +--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 nid or - a range of nids. +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 or profile node to add the route to +node Node to add the route to. +\layout Description + +--router Optional flag to mark a node as router. \layout Description --gw\SpecialChar ~ -nid the nid of the gateway (must be a local interface or a peer) +nid The +\emph on +nid +\emph default + 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 +--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 nid +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 nid +nid For a range route, this is the hi value +\emph on +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. +echo-client Used for testing purpose only. + \begin_deeper \layout Description --node\SpecialChar ~ -node node or profile node to add the OSC ref to +nodename +\emph on + +\emph default +Node on which the echo-client resides. +\end_deeper \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 List +\labelwidthstring 00.00.0000 + + +\series bold +Options \layout Description -Options: -\begin_deeper +--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 Sends output to the file. +filename Send output to the file. If the file exists, it will be overwritten. \layout Description --merge\SpecialChar ~ -filename Add the new element to an existing file. +filename +\emph on + +\emph default +Add the new element to an existing file. -\end_deeper \layout Subsection EXAMPLES +\layout Subsubsection + +--add net \layout Standard -Real life examples are given in the lustre-conf man page. -\layout Subsection -BUGS +\series bold +lmc --node adev3 --add net --nid adev3 --cluster_id 0x1000 --nettype tcp + --hostaddr adev3-eth0 --port 988 \layout Standard -None are known. + +\series bold +lmc --node adev3 --add net --nid adev3 --cluster_id 0x2000 --nettype tcp + --hostaddr adev3-eth1 --port 989 +\series default +\emph on + +\layout Standard + +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. +\layout Subsubsection + +--add route +\layout Standard + + +\series bold +lmc --node adev3 --add route --nettype tcp --gw 5 --gateway_cluster_id 0x1000 + --target_cluster_id 0x1000 --lo 4 --hi 7 +\layout Standard + +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. \layout Subsection -AUTHOR +BUGS \layout Standard -Cluster File Systems, Inc. - 2002 - created +None are known. \the_end