X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flctl.8;h=53ea4eec6d1837e87444e311b516eb4a2ad1d976;hb=refs%2Ftags%2F2.0.63.0;hp=79c581222a983b381da5051702272fa12af896a6;hpb=70e80ade90af09300396706b8910e196a7928520;p=fs%2Flustre-release.git diff --git a/lustre/doc/lctl.8 b/lustre/doc/lctl.8 index 79c5812..53ea4ee 100644 --- a/lustre/doc/lctl.8 +++ b/lustre/doc/lctl.8 @@ -92,12 +92,156 @@ Show all the local Lustre OBDs. AKA .PP .SS Device Operations .TP -.BI conf_param " " +.BI list_param " [-F|-R] " +List the Lustre or LNet parameter name +.br +.B -F +Add '/', '@' or '=' for dirs, symlinks and writeable files, respectively. +.br +.B -R +Recursively list all parameters under the specified path. If +.I param_path +is unspecified, all the parameters will be shown. +.br +.B Examples: +.br +.B +# lctl list_param ost.* +.br + ost.OSS +.br + ost.num_refs +.br +.B +# lctl list_param -F ost.* debug +.br + ost.OSS/ +.br + ost.num_refs +.br + debug= +.br +.B +# lctl list_param -R mdt +.br + mdt +.br + mdt.lustre-MDT0000 +.br + mdt.lustre-MDT0000.capa +.br + mdt.lustre-MDT0000.capa_count +.br + mdt.lustre-MDT0000.capa_key_timeout +.br + mdt.lustre-MDT0000.capa_timeout +.br + mdt.lustre-MDT0000.commit_on_sharing +.br + mdt.lustre-MDT0000.evict_client +.br + ... +.TP +.BI get_param " [-n|-N|-F] " +Get the value of Lustre or LNET parameter from the specified path. +.br +.B -n +Print only the value and not parameter name. +.br +.B -N +Print only matched parameter names and not the values. (Especially useful when using patterns.) +.br +.B -F +When -N specified, add '/', '@' or '=' for directories, symlinks and writeable files, respectively. +.br +.B Examples: +.br +.B +# lctl get_param ost.* +.br + ost.OSS +.br + ost.num_refs +.br +.B +# lctl get_param -n debug timeout +.br + super warning dlmtrace error emerg ha rpctrace vfstrace config console +.br + 20 +.br +.B +# lctl get_param -N ost.* debug +.br + ost.OSS +.br + ost.num_refs +.br + debug +.br +lctl "get_param -NF" is equivalent to "list_param -F". +.TP +.BI set_param " [-n] " +Set the value of Lustre or LNET parameter from the specified path. +.br +.B -n +Disable printing of the key name when printing values. +.br +.B Examples: +.br +.B +# lctl set_param fail_loc=0 timeout=20 +.br + fail_loc=0 +.br + timeout=20 +.br +.B +# lctl set_param -n fail_loc=0 timeout=20 +.br + 0 +.br + 20 +.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. +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. +.br +.B Parameters: +.br +All of the writable parameters under +.B lctl list_param +(e.g. +.I lctl list_param -F osc.*.* | grep = +) can be permanently set using +.B lctl conf_param +, but the format is slightly different. For conf_param, the device is specified first, then the obdtype. (See examples below.) Wildcards are not supported. +.br +Additionally, failover nodes may be added (or removed), and some system-wide parameters may be set as well (sys.at_max, sys.at_min, sys.at_extra, sys.at_early_margin, sys.at_history, sys.timeout, sys.ldlm_timeout.) is ignored for system wide parameters. +.br +.B Examples: +.br +# lctl conf_param testfs.sys.at_max=1200 +.br +# lctl conf_param testfs.llite.max_read_ahead_mb=16 +.br +# lctl conf_param testfs-MDT0000.lov.stripesize=2M +.br +# lctl conf_param lustre-OST0001.osc.active=0 +.br +# lctl conf_param testfs-OST0000.osc.max_dirty_mb=29.15 +.br +# lctl conf_param testfs-OST0000.ost.client_cache_seconds=15 +.br +# lctl conf_param testfs-OST0000.failover.node=1.2.3.4@tcp1 .TP .BI activate -Reactivate an import after deactivating, below. +Reactivate an import after deactivating, below. This setting is only effective until the next restart (see +.B conf_param +). .TP .BI deactivate Deactivate an import, in particular meaning do not assign new file stripes @@ -120,6 +264,17 @@ Detach the virtual block device. .BI blockdev_info " " Acquire which lustre file was attached to the device node. .PP +.SS Changelogs +.TP +.BI changelog_register +Register a new changelog user for a particular device. Changelog entries +will not be purged beyond any registered users' set point. (See lfs changelog_clear.) +.TP +.BI changelog_deregister " " +Unregister an existing changelog user. If the user's "clear" record number +is the minimum for the device, changelog records will be purged until the +next minimum. +.PP .SS Debug .TP .BI debug_daemon @@ -159,7 +314,7 @@ number. See .TP .B --ignore_errors | ignore_errors Ignore errors during script processing -.TP + .SH EXAMPLES # lctl .br @@ -172,8 +327,6 @@ lctl > dk /tmp/log Debug log: 87 lines, 87 kept, 0 dropped. .br lctl > quit -.PP -# lctl conf_param testfs-MDT0000 sys.timeout=40 .SH BUGS Please report all bugs to Sun Microsystems, Inc. http://bugzilla.lustre.org/