]>
Commit | Line | Data |
---|---|---|
9f95a23c TL |
1 | Client Configuration |
2 | ==================== | |
3 | ||
4 | Updating Client Configuration | |
5 | ----------------------------- | |
6 | ||
7 | Certain client configurations can be applied at runtime. To check if a configuration option can be applied (taken into affect by a client) at runtime, use the `config help` command:: | |
8 | ||
9 | ceph config help debug_client | |
10 | debug_client - Debug level for client | |
11 | (str, advanced) Default: 0/5 | |
12 | Can update at runtime: true | |
13 | ||
14 | The value takes the form 'N' or 'N/M' where N and M are values between 0 and 99. N is the debug level to log (all values below this are included), and M is the level to gather and buffer in memory. In the event of a crash, the most recent items <= M are dumped to the log file. | |
15 | ||
16 | `config help` tells if a given configuration can be applied at runtime along with the defaults and a description of the configuration option. | |
17 | ||
18 | To update a configuration option at runtime, use the `config set` command:: | |
19 | ||
20 | ceph config set client debug_client 20/20 | |
21 | ||
22 | Note that this changes a given configuration for all clients. | |
23 | ||
24 | To check configured options use the `config get` command:: | |
25 | ||
26 | ceph config get client | |
27 | WHO MASK LEVEL OPTION VALUE RO | |
28 | client advanced debug_client 20/20 | |
29 | global advanced osd_pool_default_min_size 1 | |
30 | global advanced osd_pool_default_size 3 | |
31 | ||
32 | Client Config Reference | |
33 | ------------------------ | |
7c673cae | 34 | |
f67539c2 | 35 | ``client_acl_type`` |
7c673cae FG |
36 | |
37 | :Description: Set the ACL type. Currently, only possible value is ``"posix_acl"`` to enable POSIX ACL, or an empty string. This option only takes effect when the ``fuse_default_permissions`` is set to ``false``. | |
38 | ||
39 | :Type: String | |
40 | :Default: ``""`` (no ACL enforcement) | |
41 | ||
f67539c2 | 42 | ``client_cache_mid`` |
7c673cae FG |
43 | |
44 | :Description: Set client cache midpoint. The midpoint splits the least recently used lists into a hot and warm list. | |
45 | :Type: Float | |
46 | :Default: ``0.75`` | |
47 | ||
f67539c2 | 48 | ``client_cache_size`` |
7c673cae FG |
49 | |
50 | :Description: Set the number of inodes that the client keeps in the metadata cache. | |
51 | :Type: Integer | |
52 | :Default: ``16384`` | |
53 | ||
f67539c2 | 54 | ``client_caps_release_delay`` |
7c673cae FG |
55 | |
56 | :Description: Set the delay between capability releases in seconds. The delay sets how many seconds a client waits to release capabilities that it no longer needs in case the capabilities are needed for another user space operation. | |
57 | :Type: Integer | |
58 | :Default: ``5`` (seconds) | |
59 | ||
f67539c2 | 60 | ``client_debug_force_sync_read`` |
7c673cae FG |
61 | |
62 | :Description: If set to ``true``, clients read data directly from OSDs instead of using a local page cache. | |
63 | :Type: Boolean | |
64 | :Default: ``false`` | |
65 | ||
f67539c2 | 66 | ``client_dirsize_rbytes`` |
7c673cae FG |
67 | |
68 | :Description: If set to ``true``, use the recursive size of a directory (that is, total of all descendants). | |
69 | :Type: Boolean | |
70 | :Default: ``true`` | |
71 | ||
f67539c2 | 72 | ``client_max_inline_size`` |
7c673cae FG |
73 | |
74 | :Description: Set the maximum size of inlined data stored in a file inode rather than in a separate data object in RADOS. This setting only applies if the ``inline_data`` flag is set on the MDS map. | |
75 | :Type: Integer | |
76 | :Default: ``4096`` | |
77 | ||
f67539c2 | 78 | ``client_metadata`` |
7c673cae FG |
79 | |
80 | :Description: Comma-delimited strings for client metadata sent to each MDS, in addition to the automatically generated version, host name, and other metadata. | |
81 | :Type: String | |
82 | :Default: ``""`` (no additional metadata) | |
83 | ||
f67539c2 | 84 | ``client_mount_gid`` |
7c673cae FG |
85 | |
86 | :Description: Set the group ID of CephFS mount. | |
87 | :Type: Integer | |
88 | :Default: ``-1`` | |
89 | ||
f67539c2 | 90 | ``client_mount_timeout`` |
7c673cae FG |
91 | |
92 | :Description: Set the timeout for CephFS mount in seconds. | |
93 | :Type: Float | |
94 | :Default: ``300.0`` | |
95 | ||
f67539c2 | 96 | ``client_mount_uid`` |
7c673cae FG |
97 | |
98 | :Description: Set the user ID of CephFS mount. | |
99 | :Type: Integer | |
100 | :Default: ``-1`` | |
101 | ||
f67539c2 | 102 | ``client_mountpoint`` |
7c673cae FG |
103 | |
104 | :Description: Directory to mount on the CephFS file system. An alternative to the ``-r`` option of the ``ceph-fuse`` command. | |
105 | :Type: String | |
106 | :Default: ``"/"`` | |
107 | ||
f67539c2 | 108 | ``client_oc`` |
7c673cae FG |
109 | |
110 | :Description: Enable object caching. | |
111 | :Type: Boolean | |
112 | :Default: ``true`` | |
113 | ||
f67539c2 | 114 | ``client_oc_max_dirty`` |
7c673cae FG |
115 | |
116 | :Description: Set the maximum number of dirty bytes in the object cache. | |
117 | :Type: Integer | |
118 | :Default: ``104857600`` (100MB) | |
119 | ||
f67539c2 | 120 | ``client_oc_max_dirty_age`` |
7c673cae FG |
121 | |
122 | :Description: Set the maximum age in seconds of dirty data in the object cache before writeback. | |
123 | :Type: Float | |
124 | :Default: ``5.0`` (seconds) | |
125 | ||
f67539c2 | 126 | ``client_oc_max_objects`` |
7c673cae FG |
127 | |
128 | :Description: Set the maximum number of objects in the object cache. | |
129 | :Type: Integer | |
130 | :Default: ``1000`` | |
131 | ||
f67539c2 | 132 | ``client_oc_size`` |
7c673cae FG |
133 | |
134 | :Description: Set how many bytes of data will the client cache. | |
135 | :Type: Integer | |
136 | :Default: ``209715200`` (200 MB) | |
137 | ||
f67539c2 | 138 | ``client_oc_target_dirty`` |
7c673cae FG |
139 | |
140 | :Description: Set the target size of dirty data. We recommend to keep this number low. | |
141 | :Type: Integer | |
142 | :Default: ``8388608`` (8MB) | |
143 | ||
f67539c2 | 144 | ``client_permissions`` |
7c673cae FG |
145 | |
146 | :Description: Check client permissions on all I/O operations. | |
147 | :Type: Boolean | |
148 | :Default: ``true`` | |
149 | ||
f67539c2 | 150 | ``client_quota`` |
7c673cae FG |
151 | |
152 | :Description: Enable client quota checking if set to ``true``. | |
153 | :Type: Boolean | |
154 | :Default: ``true`` | |
155 | ||
f67539c2 | 156 | ``client_quota_df`` |
7c673cae FG |
157 | |
158 | :Description: Report root directory quota for the ``statfs`` operation. | |
159 | :Type: Boolean | |
160 | :Default: ``true`` | |
161 | ||
f67539c2 | 162 | ``client_readahead_max_bytes`` |
7c673cae | 163 | |
11fdf7f2 | 164 | :Description: Set the maximum number of bytes that the client reads ahead for future read operations. Overridden by the ``client_readahead_max_periods`` setting. |
7c673cae FG |
165 | :Type: Integer |
166 | :Default: ``0`` (unlimited) | |
167 | ||
f67539c2 | 168 | ``client_readahead_max_periods`` |
7c673cae | 169 | |
11fdf7f2 | 170 | :Description: Set the number of file layout periods (object size * number of stripes) that the client reads ahead. Overrides the ``client_readahead_max_bytes`` setting. |
7c673cae FG |
171 | :Type: Integer |
172 | :Default: ``4`` | |
173 | ||
f67539c2 | 174 | ``client_readahead_min`` |
7c673cae | 175 | |
11fdf7f2 | 176 | :Description: Set the minimum number bytes that the client reads ahead. |
7c673cae FG |
177 | :Type: Integer |
178 | :Default: ``131072`` (128KB) | |
179 | ||
f67539c2 | 180 | ``client_reconnect_stale`` |
7c673cae FG |
181 | |
182 | :Description: Automatically reconnect stale session. | |
183 | :Type: Boolean | |
184 | :Default: ``false`` | |
185 | ||
f67539c2 | 186 | ``client_snapdir`` |
7c673cae FG |
187 | |
188 | :Description: Set the snapshot directory name. | |
189 | :Type: String | |
190 | :Default: ``".snap"`` | |
191 | ||
f67539c2 | 192 | ``client_tick_interval`` |
7c673cae FG |
193 | |
194 | :Description: Set the interval in seconds between capability renewal and other upkeep. | |
195 | :Type: Float | |
196 | :Default: ``1.0`` (seconds) | |
197 | ||
f67539c2 | 198 | ``client_use_random_mds`` |
7c673cae FG |
199 | |
200 | :Description: Choose random MDS for each request. | |
201 | :Type: Boolean | |
202 | :Default: ``false`` | |
203 | ||
f67539c2 | 204 | ``fuse_default_permissions`` |
7c673cae FG |
205 | |
206 | :Description: When set to ``false``, ``ceph-fuse`` utility checks does its own permissions checking, instead of relying on the permissions enforcement in FUSE. Set to ``false`` together with the ``client acl type=posix_acl`` option to enable POSIX ACL. | |
207 | :Type: Boolean | |
208 | :Default: ``true`` | |
209 | ||
f67539c2 | 210 | ``fuse_max_write`` |
11fdf7f2 | 211 | |
f67539c2 TL |
212 | :Description: Set the maximum number of bytes in a single write operation. |
213 | A value of 0 indicates no change; the | |
214 | FUSE default of 128 kbytes remains in force. | |
11fdf7f2 TL |
215 | :Type: Integer |
216 | :Default: ``0`` | |
217 | ||
f67539c2 | 218 | ``fuse_disable_pagecache`` |
9f95a23c | 219 | |
f67539c2 TL |
220 | :Description: If set to ``true``, kernel page cache is disabled for ``ceph-fuse`` |
221 | mounts. When multiple clients read/write to a file at the same | |
222 | time, readers may get stale data from page cache. Due to | |
223 | limitations of FUSE, ``ceph-fuse`` can't disable page cache dynamically. | |
9f95a23c TL |
224 | :Type: Boolean |
225 | :Default: ``false`` | |
226 | ||
7c673cae FG |
227 | Developer Options |
228 | ################# | |
229 | ||
230 | .. important:: These options are internal. They are listed here only to complete the list of options. | |
231 | ||
f67539c2 | 232 | ``client_debug_getattr_caps`` |
7c673cae FG |
233 | |
234 | :Description: Check if the reply from the MDS contains required capabilities. | |
235 | :Type: Boolean | |
236 | :Default: ``false`` | |
237 | ||
f67539c2 | 238 | ``client_debug_inject_tick_delay`` |
7c673cae FG |
239 | |
240 | :Description: Add artificial delay between client ticks. | |
241 | :Type: Integer | |
242 | :Default: ``0`` | |
243 | ||
f67539c2 | 244 | ``client_inject_fixed_oldest_tid`` |
7c673cae FG |
245 | |
246 | :Description: | |
247 | :Type: Boolean | |
248 | :Default: ``false`` | |
249 | ||
f67539c2 | 250 | ``client_inject_release_failure`` |
7c673cae FG |
251 | |
252 | :Description: | |
253 | :Type: Boolean | |
254 | :Default: ``false`` | |
255 | ||
f67539c2 | 256 | ``client_trace`` |
7c673cae FG |
257 | |
258 | :Description: The path to the trace file for all file operations. The output is designed to be used by the Ceph `synthetic client <../../man/8/ceph-syn>`_. | |
259 | :Type: String | |
260 | :Default: ``""`` (disabled) | |
261 |