RapidFS缓存实例提供元数据缓存加速和数据缓存加速能力。在Master托管部署模式，需至少添加1台Cache节点，否则无法实现数据读取加速。该模式下实例由以下核心模块组成：

• Master服务：负责系统整体管理，包括元数据缓存及管理、数据缓存任务调度以及Cache节点管理。
• Cache节点：提供分布式数据缓存加速能力，负责缓存预热及缓存加速读取。Cache节点数量可根据缓存容量需求进行线性扩展。

添加节点

1. 登录数据湖存储加速⼯具RapidFS控制台。
2. 点击RapidFS缓存实例名称。
3. 在导航栏中选择Cache节点管理。
4. 在Cache节点管理页，点击添加节点按钮。
5. 在添加Cache节点页中，配置如下参数。

参数		说明
节点选择	实例类型	添加Cache节点的实例类型。与创建RapidFS缓存实例时设置的托管实例类型保持一致
	节点选择	当实例类型为云服务器BCC时，可直接选择对应BCC实例添加为Cache节点。 1. 支持按实例名称、实例ID、IP地址快速搜索BCC实例，也可通过实例标签或导入实例名称/ID/IP清单进行批量筛选BCC实例。 2. 注意事项 最大性能：Master托管模式下，RapidFS实例最大性能取决于节点机器配置和数量，可参考本文档常见问题说明。 网络要求：仅支持选择与RapidFS实例同一VPC的节点机器（BCC实例），建议选择同一可用区以保证性能。 节点要求：仅可选择实例状态运行中、BSM Agent状态在线且未加入其他RapidFS实例的节点。 Cache节点数量限制：M1型最多支持50个Cache节点；M2型最多支持400个Cache节点。
		当实例类型为自有 IDC 服务器时，可通过导入机器清单的方式添加 Cache 节点。请按 user:password@ip:port 的格式输入机器信息（其中 port 为 服务器使用的 SSH 通信端口），多台机器请使用换行分隔。
数据盘配置	推荐：格式化挂载（是）	推荐您进行格式化挂载，此时需要设置设备名称和挂载路径。 设备名称：输入设备名称（例如sdb、vdb、nvme1等），仅支持尚未创建文件系统的新块设备进行格式化挂载。 挂载路径：输入挂载路径，若路径不存在将自动创建。 挂载的数据盘建议RapidFS独享，否则已有业务数据可能导致不可控的性能和容量风险。 M1型单个节点挂载的设备数不能超过4个；M2型单个节点挂载的设备数不能超过8个。
	格式化挂载（否）	若不进行格式化挂载，需要设置挂载路径和缓存容量 挂载路径：输入挂载路径，若路径不存在将自动创建。 缓存容量：需小于数据盘的可用容量。若某数据盘设置的缓存容量超过其实际可用容量且当前可用容量 ≥ 10GiB 时，系统会自动下调，否则会添加失败。 挂载的数据盘建议RapidFS独享，否则已有业务数据可能导致不可控的性能和容量风险。 M1型单个节点挂载的设备数不能超过4个；M2型单个节点挂载的设备数不能超过8个。
高级配置		高级配置中包含服务部署路径、节点系统配置、节点资源限制、节点内数据服务配置。无需修改，保持默认即可。默认配置如下： 服务部署路径：/home/.rapidfs/。请确保所填写的服务部署路径剩余可用空间不少于30GB 部署配置： { "systemConfig": { "vm.max_map_count": 524288, "fs.aio-max-nr": 10485760 }, "resourceConfig": { "requestCpu": 4, "limitCpu": 16, "requestMem": "2GiB", "limitMem": "8GiB" }, "serviceConfig": { "min_log_level": 1 } } systemConfig 参数说明： vm.max_map_count：控制一个进程可以拥有的内存映射区域（memory-mapped regions）的最大数量，默认 524288，最小 65536； fs.aio-max-nr：控制系统中异步 I/O（AIO）上下文的最大数量，默认 10485760，最小 1048576； resourceConfig 参数说明： requestCpu：Cache 节点容器请求的 CPU 核数，默认 4，最小 1，最大不超过所在节点核数； limitCpu：Cache节点容器限制的 CPU 核数，默认 4，最小 1，最大不超过所在节点核数； requestMem：Cache 节点容器请求的内存大小，默认 2GiB，最小 1GiB，最大不超过所在节点内存剩余大小； limitMem：Cache节点容器限制的的内存大小，默认 8GiB，最小 4GiB，最大不超过所在节点内存总大小； serviceConfig 参数说明： min_log_level：表示 Cache节点缓存服务的日志级别，取值范围 [0, 1, 2, 3, 4], 其中 0=INFO 1=NOTICE 2=WARNING 3=ERROR 4=FATAL，默认 1。。

查询节点

在Cache节点管理页面，可以按节点IP或节点ID搜索目标节点。列表中可以查看节点IP/ID、运行状态、连接状态、节点类型/规格、云服务器名称/ID、云服务器可用区、已用量/节点容量/容量使用率、加入时间、最后汇报时间。点击节点ID查看节点详情信息，除列表基本信息外，还可查看节点挂载的数据盘信息和高级配置信息。

节点常见状态说明：

状态	说明
加入中	节点正在加入中，不支持任何操作。
加入失败	节点加入失败，支持移出节点。
运行中	节点正常运行中，支持停止、重启。请停止节点后再移出节点
停止中	节点正在停止中，不支持任何操作。
停止失败	节点停止失败，支持停止、重启和移出节点。
已停止	节点已停止，支持启动、重启和移出节点。
启动中	节点正在启动中，不支持任何操作。
启动失败	节点启动失败，支持启动、重启和移出节点。
重启中	节点正在重启中，不支持任何操作。
移出中	节点正常移出中，不支持任何操作。
移出失败	节点移出失败，支持移出节点。
服务异常	节点服务异常，支持启动、重启和移出节点。

停止节点

在Cache节点管理页面，可以对运行中、停止失败的节点进行（批量）停止操作。提供两种停止方式：

• 迁移数据并停止（推荐）：将节点的缓存数据至其他节点（过程较长，当实例仅剩一个运行中节点时，实际不会迁移数据）后再停止进程。后续重新启动该节点时，会触发所有节点缓存数据重新均衡。
• 立即停止：立即停止该节点进程，不执行数据迁移。

启动节点

在Cache节点管理页面，可以对已停止、启动失败、服务异常的节点进行（批量）启动操作。

重启节点

在Cache节点管理页面，可以对运行中、已停止、停止失败、启动失败、服务异常的节点进行（批量）重启操作。

移出节点

在Worker节点管理页面，可以对加入失败、已停止、停止失败、启动失败、服务异常、移出失败的节点进行移出节点。

注意:

1. 移出节点后，该节点上线的数据将无法访问。
2. 该节点再次加入时，无需重新格式化和挂载。
3. 若节点已离线，可以选择“强制退出”进行移出。

常见问题

1. Master 托管模式下，RapidFS缓存实例的性能情况？

答：整个实例的 IO 性能等于所有 Cache 节点 IO 性能之和。单个 Cache 节点的 IO 性能由以下三项能力中的最小值决定：

• 网络带宽：指节点的 TCP 网络带宽，取决于机型与网卡规格（详见 云服务器BCC实例规格 ）。受业务影响按 0.8 折算。
• 磁盘总带宽：指节点接入磁盘带宽之和。NVMe 盘通常为 2GB/s、HDD 为 30–100 MB/s（详见 云磁盘CDS类型），非独占磁盘受业务影响，按0.8折算。
• 缓存服务软件栈能力：单节点缓存服务最大读吞吐为 10 GB/s（受节点CPU和内存资源影响）。

因此，单个 Cache 节点的峰值吞吐为：min { 0.8 × 节点网络带宽，0.8 × 接入 NVMe 设备峰值总吞吐，10GB/s }

2. 添加Cache节点有哪些前置要求？

答：

• 端口要求：需开放 8000–9000 的入向 TCP 端口。
• 磁盘空间要求：接入节点 /home/ 目录需至少保留 20 GB 可用空间。