1 .TH LCTL-SET_PARAM 8 "2019-05-10" Lustre "configuration utilities"
3 lctl-set_param \- Lustre filesystem set parameter utility
5 .B "\fBlctl set_param "
10 .RB [ \-t [ \fITHREAD_COUNT ]]
11 .RI < parameter \= value ...>
13 .IR "\fBlctl set_param -F " < filename >
15 Set the value of the named Lustre or LNet
19 on the local node. Parameter names consist of one or more components,
20 separated by a '.' (period). Each component may be specified by plain text
21 or by a wildcard in the
23 format. When wildcards are used, more than one parameter may match and
24 be changed. Parameters are often, but not always, of the form
25 .IR obd_name.obd_instance.parameter_name ,
28 is one of the OBD object types, like
29 .BR ldlm ", " llite ", " lmv ", " lov ", " mdc ", " osc ,
32 is the name of a Lustre device, like
34 but may be a specific component, or contain wildcards to match some or all
35 devices on the node. Parameters can only be modified by the root user for
39 Remove the permanent setting (only for parameters set with the
46 instead of from the command-line. The contents of
48 is YAML format, created as an output from
49 .BR ' "lctl --device MGS llog_print " < \fIfsname\fR >- client '
50 or any other valid llog configuration log as listed by
51 .RB ' "lctl --device MGS llog_catlist" '
54 Disable printing of the parameter name after setting it.
61 nodes connected to the MGS on which the command is run. To limit wildcard
63 matching to specific filesystems or parameters, ensure that
65 contains a suitably-specific expression for the
69 such as the filesystem and/or target name. This option is only available
70 in Lustre 2.5.0 and later clients, older clients cannot set persistent
71 parameters, nor will they see them.
74 Spawn threads to set multiple parameters in parallel, optionally specifying
75 the maximum number of threads to run (with no space between
79 Without this option parameter(s) are set serially.
82 was compiled without pthread support, a warning message will be
83 printed and parameters will be set serially. If
85 is specified without any argument, it runs up to 8 threads by default.
87 .B # lctl set_param fail_loc=0 timeout=20
93 .B # lctl set_param -n fail_loc=0 timeout=20
100 # lctl set_param -t2 "ldlm.namespaces.*osc*.lru_size=clear"
102 ldlm.namespaces.fsname-OST0001-osc-MDT0000.lru_size=clear
104 ldlm.namespaces.fsname-OST0000-osc-MDT0000.lru_size=clear
106 .B # lctl set_param -P osc.testfs-OST*.max_dirty_mb=512
108 osc.testfs-OST0000-osc-ffff8803c9c0f000.max_dirty_mb=512
110 osc.testfs-OST0001-osc-ffff8803c9c0f000.max_dirty_mb=512
112 osc.testfs-OST0002-osc-ffff8803c9c0f000.max_dirty_mb=512
114 osc.testfs-OST0003-osc-ffff8803c9c0f000.max_dirty_mb=512
116 osc.testfs-OST0004-osc-ffff8803c9c0f000.max_dirty_mb=512
121 .BR lctl-get_param (8),
122 .BR lctl-list_param (8),
123 .BR lctl-llog_catlist (8),
124 .BR lctl-llog_print (8)