X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flctl.8;h=0820d857a1afe5c1af2ba00b4120c220309f8ae7;hb=7ec8e4751fdf22894eef67972b094cd9f28ec3a0;hp=0ade6ff14cae3c1c76c32bc86b38904bfc6ae245;hpb=19b33c5ed4a5c8296b0a2ba576de874e83faa8fd;p=fs%2Flustre-release.git diff --git a/lustre/doc/lctl.8 b/lustre/doc/lctl.8 index 0ade6ff..0820d85 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 > @@ -224,7 +234,9 @@ 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 +265,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 +359,16 @@ Delete an existing UID or GID mapping from a nodemap. .RS 4 Modify a nodemap property. .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 +396,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/-