注意
本文档适用于 Ceph 的开发版本。
客户端配置
更新客户端配置
某些客户端配置可以在运行时应用。要检查配置选项是否可以在运行时应用（由客户端生效），请使用 config help 命令
ceph config help debug_client
debug_client - Debug level for client
(str, advanced) Default: 0/5
Can update at runtime: true
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.
config help 会告知给定的配置是否可以在运行时应用，以及默认值和配置选项的描述。
要在运行时更新配置选项，请使用 config set 命令
ceph config set client debug_client 20/20
请注意，这会更改所有客户端的给定配置。
要检查已配置的选项，请使用 config get 命令
ceph config get client
WHO MASK LEVEL OPTION VALUE RO
client advanced debug_client 20/20
global advanced osd_pool_default_min_size 1
global advanced osd_pool_default_size 3
客户端配置参考
- client_acl_type
设置 ACL 类型。目前，唯一可能的值是
"posix_acl"以启用 POSIX ACL，或者空字符串。此选项仅在fuse_default_permissions设置为false时生效。- 类型:
str
- client_cache_mid
设置客户端缓存中点。中点将最近最少使用列表分为热列表和温列表。
- 类型:
float- 默认值:
0.75
- client_cache_size
设置客户端在元数据缓存中保留的 inode 数量。
- 类型:
大小- 默认值:
16Ki
- client_caps_release_delay
设置能力释放之间的延迟（以秒为单位）。此延迟设置客户端等待释放不再需要的能力的时间（以秒为单位），以防另一个用户空间操作需要这些能力。
- 类型:
秒- 默认值:
5
- client_debug_force_sync_read
如果设置为
true，客户端直接从 OSD 读取数据，而不是使用本地页面缓存。- 类型:
bool- 默认值:
false
- client_dirsize_rbytes
此选项启用 CephFS 功能，该功能将递归目录大小（目录及其后代中文件使用的字节数）存储在 stat 结构的 st_size 字段中。
- 类型:
bool- 默认值:
true
- client_fscrypt_as
为锁定/解锁状态启用 fscrypt 访问语义。
- 类型:
bool- 默认值:
true
- client_fscrypt_dummy_encryption
启用 fscrypt 模拟加密
- 类型:
bool- 默认值:
false
- client_max_inline_size
设置存储在文件 inode 中而不是 RADOS 中单独数据对象中的内联数据的最大大小。此设置仅在 MDS 映射上设置了
inline_data标志时才适用。- 类型:
大小- 默认值:
4Ki
- client_metadata
发送到每个 MDS 的客户端元数据的逗号分隔字符串，除了自动生成的版本、主机名和其他元数据。
- 类型:
str
- client_mount_gid
设置 CephFS 挂载的组 ID。
- 类型:
int- 默认值:
-1
- client_mount_timeout
设置 CephFS 挂载的超时时间（以秒为单位）。
- 类型:
秒- 默认值:
5 minutes
- client_mount_uid
设置 CephFS 挂载的用户 ID。
- 类型:
int- 默认值:
-1
- client_mountpoint
用于挂载 CephFS 文件系统的目录。这是
ceph-fuse命令的-r选项的替代方案。- 类型:
str- 默认值:
/
- client_oc
启用对象缓存
- 类型:
bool- 默认值:
true
- client_oc_max_dirty
设置对象缓存中脏字节的最大数量。
- 类型:
大小- 默认值:
100Mi
- client_oc_max_dirty_age
设置对象缓存中脏数据的最大存在时间（以秒为单位），超过此时间后会回写。
- 类型:
float- 默认值:
5.0
- client_oc_max_objects
设置对象缓存中对象的最大数量。
- 类型:
int- 默认值:
1000
- client_oc_size
设置客户端将缓存多少字节的数据。
- 类型:
大小- 默认值:
200Mi
- client_oc_target_dirty
设置脏数据的目标大小。建议将此数字保持较低。
- 类型:
大小- 默认值:
8Mi
- client_permissions
在所有 I/O 操作上检查客户端权限。
- 类型:
bool- 默认值:
true
- client_quota_df
为
statfs操作报告根目录配额。- 类型:
bool- 默认值:
true
- client_readahead_max_bytes
设置客户端为未来读取操作预读的最大字节数。被
client_readahead_max_periods设置覆盖。- 类型:
大小- 默认值:
0B
- client_readahead_max_periods
设置客户端预读的文件布局周期数（对象大小 * 条带数）。覆盖
client_readahead_max_bytes设置。- 类型:
int- 默认值:
4
- client_readahead_min
设置客户端预读的最小字节数。
- 类型:
大小- 默认值:
128Ki
- client_reconnect_stale
当会话变为陈旧时重新连接
- 类型:
bool- 默认值:
false
- client_respect_subvolume_snapshot_visibility
用于决定是否尊重在每个子卷的快照域中设置的 is_snapdir_visible 标志的选项
- 类型:
bool- 默认值:
false
- client_snapdir
设置快照目录名称。
- 类型:
str- 默认值:
.snap
- client_tick_interval
设置能力续订和其他维护之间的时间间隔（以秒为单位）。
- 类型:
秒- 默认值:
1
- client_use_random_mds
为每个请求选择随机 MDS。
- 类型:
bool- 默认值:
false
- fuse_default_permissions
当设置为
false时，ceph-fuse实用程序会执行自己的权限检查，而不是依赖 FUSE 中的权限强制执行。与client acl type=posix_acl选项一起设置为false以启用 POSIX ACL。- 类型:
bool- 默认值:
false
- fuse_max_write
设置单个写入操作的最大字节数。值为 0 表示不更改；FUSE 默认值 128 kbytes 保持有效。
- 类型:
大小- 默认值:
0B
- fuse_disable_pagecache
如果设置为
true，则会禁用ceph-fuse挂载的内核页面缓存。当多个客户端同时读/写文件时，读取器可能会从页面缓存中获取陈旧数据。由于 FUSE 的限制，ceph-fuse无法动态禁用页面缓存。- 类型:
bool- 默认值:
false
开发人员选项
重要
这些是内部选项。此处列出它们只是为了完善选项列表。
- client_debug_getattr_caps
- 类型:
bool- 默认值:
false
- client_debug_inject_tick_delay
- 类型:
秒- 默认值:
0
- client_inject_fixed_oldest_tid
- 类型:
bool- 默认值:
false
- client_inject_release_failure
- 类型:
bool- 默认值:
false
- client_trace
包含客户端操作跟踪的文件
- 类型:
str