X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flctl.8;h=b3be0e810b17a494ea667600e044d316e4b47c99;hb=49f51ae420912b0259f9b9648cff32534fe11b50;hp=0ade6ff14cae3c1c76c32bc86b38904bfc6ae245;hpb=19b33c5ed4a5c8296b0a2ba576de874e83faa8fd;p=fs%2Flustre-release.git diff --git a/lustre/doc/lctl.8 b/lustre/doc/lctl.8 index 0ade6ff..b3be0e8 100644 --- a/lustre/doc/lctl.8 +++ b/lustre/doc/lctl.8 @@ -1,4 +1,4 @@ -.TH lctl 1 "2016 Sep 8" Lustre "configuration utilities" +.TH lctl 8 "2017 Jan 12" Lustre "configuration utilities" .SH NAME lctl \- Low level Lustre filesystem configuration utility .SH SYNOPSIS @@ -7,6 +7,10 @@ lctl \- Low level Lustre filesystem configuration utility .br .B lctl --device .br +.B lctl --version +.br +.B lctl --list-commands +.br .SH DESCRIPTION .B lctl is used to directly control Lustre via an ioctl interface, allowing @@ -26,7 +30,7 @@ can be invoked in interactive mode by issuing lctl command. After that, commands .BR quit . To get a complete listing of available commands, type -.B help +.B --list-commands at the lctl prompt. To get basic help on the meaning and syntax of a command, type .B help @@ -35,6 +39,12 @@ command, type For non-interactive use, one uses the second invocation, which runs command after connecting to the device. +.SS System Configuration +The on-line tool set for backup or removal of Lustre system configuration. For detail, please see: +.PP +\fBlctl-lcfg\fR(8) +.RS 4 + .SS Network Configuration .TP .BR network " <" up / down >|< tcp / o2ib > @@ -49,7 +59,7 @@ Print all Network Identifiers on the local node. LNET must be running. From a list of nids for a remote node, show which interface communication will take place on. .TP -.BI replace_nids " [,nid2,nid3 ...]" +.BI replace_nids " [,nid2,nid3:nid4,nid5:nid6 ...]" Replace the LNET Network Identifiers for a given device, as when the server's IP address has changed. This command must be run on the MGS node. @@ -58,6 +68,8 @@ in another cases). To start the MGS service only: mount -t lustre -o nosvc Note the replace_nids command skips any invalidated records in the configuration log. The previous log is backed up with the suffix '.bak'. +Failover nids must be passed after ':' symbol. More then +one failover can be set (every failover nids after ':' symbol). .TP .BI ping " timeout" Check LNET connectivity via an LNET ping. This will use the fabric @@ -219,12 +231,23 @@ Remove the permanent setting (only with -P option) # lctl set_param -P osc.*.max_dirty_mb=32 .br .TP +.BI "set_param -F " +.br +Apply configuration file specified by +.br +File is in YAML format, created as an output from +\fBlctl --device MGS llog_print -client\fR or any other valid +llog_file from the output of \fBlctl --device MGS llog_catlist\fR +.br +.TP .BI conf_param " [-d] .=" Set a permanent configuration parameter for any device via the MGS. This command must be run on the MGS node. .br .B -d . -Delete a parameter setting (use the default value at the next restart). A null value for also deletes the parameter setting. +Delete a parameter setting (use the default value at the next restart). +A null value for also deletes the parameter setting. This is +useful if an incorrect or obsolete parameter is in the configuration. .br .B Parameters: .br @@ -253,6 +276,8 @@ Additionally, failover nodes may be added (or removed), and some system-wide par # lctl conf_param testfs-OST0000.ost.client_cache_seconds=15 .br # lctl conf_param testfs-OST0000.failover.node=1.2.3.4@tcp1 +.br +# lctl conf_param -d testfs-OST0000.bad_param .TP .BI activate Reactivate an import after deactivating, below. This setting is only effective until the next restart (see @@ -345,7 +370,26 @@ Delete an existing UID or GID mapping from a nodemap. .RS 4 Modify a nodemap property. .RE - +.PP +\fBlctl-nodemap-set-fileset\fR(8) +.RS 4 +Add a fileset to a nodemap. +.RE +.PP +\fBlctl-nodemap-set-sepol\fR(8) +.RS 4 +Set SELinux policy info on a nodemap. +.RE +.SS Configuration logs +.TP +.BI clear_conf " " +This command runs on MGS node having MGS device mounted with -o +nosvc. It cleans up configuration files stored in the CONFIGS/ directory +of any records marked SKIP. If the device name is given, then the +specific logs for that filesystem (e.g. testfs-MDT0000) is processed. +Otherwise, if a filesystem name is given then all configuration files for the +specified filesystem are cleared. +.PP .SS LFSCK An on-line Lustre consistency check and repair tool. It is used for totally replacing the old lfsck tool for kinds of Lustre inconsistency verification, @@ -373,6 +417,81 @@ Stop LFSCK on the specified MDT or OST device. .RS 4 Get the LFSCK global status via the specified MDT device. .RE + +.SS BARRIER +The tools set for write (modify) barrier on all MDTs. For detail, please see: +.PP +\fBlctl-barrier\fR(8) +.RS 4 + +.SS SNAPSHOT +ZFS backend based snapshot tools set. The tool loads system configuration +from the file +.B /etc/ldev.conf +on the MGS, and call related ZFS commands to +maintain Lustre snapshot pieces on all targets (MGS/MDT/OST). +The configuration file +.B /etc/ldev.conf +is not only for snapshot, but also +for other purpose. The format is: + foreign/-