X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flmc.1;h=9197ead23e694684791fee4331f2ed7182d020d1;hb=6fcafc03046e2c8aad4873485080e9d9d26049ea;hp=3e2d19bb871735818d387c9101757e2e35115c16;hpb=d3f14b341f24e28a453c02a99c7072d2bd39b86a;p=fs%2Flustre-release.git diff --git a/lustre/doc/lmc.1 b/lustre/doc/lmc.1 index 3e2d19b..9197ead 100644 --- a/lustre/doc/lmc.1 +++ b/lustre/doc/lmc.1 @@ -51,6 +51,9 @@ Specify the location of the Portals upcall scripts used by the client for recove --upcall Specify the location of both (Lustre and Portals) upcall scripts used by the client for recovery. .TP +--group_upcall +Specify the location of the group upcall scripts used by the MDS for determiningsupplementary group membership. +.TP --ptldebug Set the portals debug level. .TP @@ -102,9 +105,6 @@ Common name of the MDS. .TP --mdsuuid Specify MDS uuid. -.TP ---failover -Enable failover support on MDS. .TP --dev Path of device on local system. If the is a file, then a loop device is created and used as the block device. @@ -118,17 +118,21 @@ Optional argument indicating the size (in KB) of the device to be created (used --node Adds an MDS to the specified node. This requires a --node argument, and it must not be a profile node. .TP ---fstype extN|ext3 +--fstype ldiskfs|ext3 Optional argument used to specify the file system type. Default is ext3. -.TP ---backfstype ext3|tmpfs -Specify the backing filesystem type. -.TP ---nspath -Local mount point of server namespace. +For 2.6 kernels the ldiskfs filesystem must be used. .TP --inode_size -Specify new inode size for underlying ext3 file system. +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. +.TP +--group_upcall +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. .TP --mkfsoptions Optional argument to mkfs. @@ -137,7 +141,7 @@ Optional argument to mkfs. 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 --mountfsoptions option. "errors=remount-ro" and "asyncdel" can also be added to it. .TP --journal_size -Optional arguement to specify the journal size for the ext2/ext3 file system. The size should be in the units expected by mkfs, 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. +Optional arguement to specify the journal size for the ext3 file system. The size should be in the units expected by mkfs, so for ext3 it should be in MB. If this is option is not used, the ext3 filesystem will be configured with the default journal size. .PP .B --add lov Creates an LOV with the specified parameters. The mds_name must already exist in the descriptor. @@ -149,10 +153,10 @@ Common name for the LOV Common name for the MDS .TP --stripe_sz -Stripe size +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. .TP --stripe_cnt -A value of 0 for this means to stripe on all available OSTs. Default is 0. +A value of 0 for this means to use the currently optimal number of stripes. Default is 1 stripe per file. .TP --stripe_pattern Only Pattern 0 (RAID 0) is supported currently. @@ -166,15 +170,15 @@ Assign a name to the OST device. --node Node on which the OST service is run, can not be a profile node. .TP ---failover +--failout +Disable failover support on OST. +.TP +--failover Enable failover support on OST. .TP --dev Path of device on local system. If this is a file, then a loop device is created and used as the block device. .TP ---backdev -Path of the device for backing storage on local system. -.TP --size [size] Optional argument indicating the size (in KB) of the device to be created (used typically for loop devices). .TP @@ -188,17 +192,11 @@ Optional arguement. Name of LOV to which this OSC will be attached. Specify the UUID of the OST device. .TP --fstype -extN|ext3 Optional arguement used to specify the file system type. Default is ext3. -.TP ---backfstype ext3|tmpfs -Optional argument to specify the backing filesystem type. +ldiskfs|ext3 Optional arguement used to specify the file system type. Default is ext3. .TP --inode_size Specify new inode size for underlying ext3 file system. .TP ---nspath -Local mount point of server namespace. -.TP --mkfsoptions Optional argument to mkfs. .TP @@ -206,10 +204,10 @@ Optional argument to mkfs. 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 --mountfsoptions option. "errors=remount-ro" and "asyncdel" can also be added to it. .TP --journal_size -Optional arguement to specify the journal size for the ext2/ext3 file system. The size should be in the units expected by mkfs, 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. +Optional arguement to specify the journal size for the ext3 file system. The size should be in the units expected by mkfs, 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. .PP .B --add mtpt -Creates a mount-point on the specified node. Either an LOV or OSC name can be used. +Creates a mount-point on the specified node for the given LOV. .TP --node node Node that will use the mtpt. @@ -222,9 +220,6 @@ MDS name .TP --ost ost_name | --lov lov_name OST or LOV name as specified earlier in the configuration -.TP ---clientoptions options -Specify the options for Lustre, such as async. .PP .B --add route Creates a static route through a gateway to a specific nid or a range of nid's. @@ -257,27 +252,6 @@ Used for testing purpose only. Name of the node that echo client should run on, .TP --obd obd_name -.PP -.B --add mgmt -Management/monitoring service. -.TP ---node nodename -Node on which the mgmt service resides. -.TP ---mgmt -Specify management/monitoring service name. -.PP -.B --add cobd -Create the cobd on the specified node. -.TP ---node nodename -Node on which the cobd resides. -.TP ---cache_obd obd_name -Specify the cache device for the cache obd system. -.TP ---real_obd obd_name -Specify the real device for the cache obd system. .SH OPTIONS One of the following options should be specified. .TP 12 @@ -296,6 +270,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.