UBSIO-MemStore 安装部署指南 ​

本文档介绍 UBSIO-MemStore 的使用场景、节点规划、环境要求，以及安装、启动和卸载流程。

使用场景 ​

UBSIO-MemStore 适用于证券交易等对内存 KV 访问和跨节点副本同步时延敏感的业务。应用通过 KV 接口和批量操作接口访问内存数据，并通过多副本机制支持数据保护和故障恢复。

可根据业务处理与内存数据管理的进程关系选择部署模式：

• 融合部署：UBSIO-MemStore 与用户进程共同运行，适用于由应用统一初始化和管理内存服务的场景。
• 分离部署：内存数据管理由独立的 mmsd 进程承载，客户端集成在用户进程中，适用于需要分别管理业务进程与内存服务进程、隔离业务进程退出影响的场景。

软件安装 ​

节点规划 ​

安装前，请完成以下规划，并将节点清单用于后续逐节点安装和配置：

1. 确定安装节点和软件包。 所有 UBSIO-MemStore 集群节点都必须安装相同版本的 ubs-io-memstore 运行包及其运行依赖。仅在需要编译或集成应用的节点上额外安装匹配版本的 ubs-io-memstore-devel 开发包；各依赖包的用途见下文“运行依赖包”。根据规划的集群节点数配置 mms.cm.node.num，并在各节点保持一致。
2. 提前准备集群节点 IP。 整理每个节点的主机名、业务 IP 地址及网段掩码；管理网络与业务网络分离时，另行记录用于登录和安装的管理 IP。根据本节点的业务网卡地址设置 mms.net.rpc.ip_mask，规划 mms.net.rpc.listen_port 等通信端口，并确认节点间业务网络互通。
3. 规划 ZooKeeper 服务地址。 提前准备 ZooKeeper 服务节点的 IP 和端口，用于配置 mms.cm.zk_host。ZooKeeper 服务部署在规划的服务节点上，所有 UBSIO-MemStore 节点均需能够访问该服务。
4. 规划内存和 CPU 资源。 根据各节点实际的 NUMA 拓扑预留内存、规划通信和后台任务使用的 CPU 核，并据此填写各节点配置，避免直接照搬其他节点的 NUMA ID 或绑核范围。

环境要求 ​

安装部署 UBSIO-MemStore 前，请检查物理环境、依赖软件及其版本是否满足要求。满足前置环境要求是成功安装部署和正常运行应用程序的先决条件。

硬件要求

UBSIO-MemStore 安装在计算节点上，集群中各计算节点的硬件要求如表 1所示。

表 1 硬件要求

软件要求

安装 UBSIO-MemStore 前，需要先按节点角色准备依赖软件。建议遵循各软件的安全标准进行安装。部署环境涉及的软件版本要求如表 2所示，以下软件不在交付范围内；ZooKeeper 服务及其 Java 运行环境部署在规划的 ZooKeeper 服务节点上。

表 2 软件要求

运行依赖包

UBSIO-MemStore 的运行依赖包如表 3所示。使用 yum 在线安装 UBSIO-MemStore 时，yum 会自动解析并安装这些依赖，无需逐个安装；使用 rpm 离线安装时，需要提前准备产品包及其依赖 RPM。

表 3 运行依赖包

系统基础运行库由操作系统提供，不需要单独准备。

软件包说明 ​

UBSIO-MemStore 提供运行包和开发包，具体用途如表 4所示。

表 4 软件包说明

安装前提条件 ​

• ZooKeeper 已由用户在指定节点完成安装和配置，并已规划可供 UBSIO-MemStore 使用的服务地址。本文档不提供 ZooKeeper 安装方法。
• UBSIO-MemStore 的运行用户和用户组已在所有目标节点创建，且 UID、GID 保持一致。

（可选）清理环境 ​

须知：

重新安装前，请确保环境中不存在旧版本 UBSIO-MemStore，并在卸载前停止相关业务和 UBSIO-MemStore 进程。

在已安装旧版本的节点上执行：

yum remove ubs-io-memstore-devel ubs-io-memstore

安装 UBSIO-MemStore ​

1. 按节点规划清单，使用 root 用户登录待安装的 UBSIO-MemStore 集群节点。所有集群节点均需执行以下安装流程。

2. 选择以下任一方式安装 UBSIO-MemStore。

   在线安装

   仅部署和运行 UBSIO-MemStore 时，安装运行包：

   bash

   yum install ubs-io-memstore -y

   编译或集成 UBSIO-MemStore 应用时，安装开发包：

   bash

   yum install ubs-io-memstore-devel -y

   ubs-io-memstore-devel 依赖同版本的运行包。使用 yum 安装开发包时，会自动安装匹配的 ubs-io-memstore，无需重复执行运行包安装命令。

   离线安装

   rpm 不会自动从软件源下载缺失的依赖。离线安装前，根据使用场景将表 4中的产品 RPM 与表 3中的依赖 RPM 放在同一独立目录中。安装开发包时，还必须准备版本匹配的运行包。然后执行：

   bash

   rpm -ivh ./*.rpm

3. 按照相同流程在其他节点上安装 UBSIO-MemStore。

安装目录 ​

安装完成后的主要目录和文件如表 5所示。

表 5 软件包目录结构

安装后配置 ​

1. 根据业务场景配置 /etc/mms/mms.conf。具体配置项和 TLS 认证操作请参见配置说明。
2. 确保所有节点的集群规模、ZooKeeper 地址、部署模式和 TLS 开关等公共配置保持一致。

软件启动 ​

启动前提条件 ​

启动 UBSIO-MemStore 前，请确认：

• ZooKeeper 服务已经启动且运行正常，所有 UBSIO-MemStore 节点均可访问该服务。
• /etc/mms/mms.conf 中的 mms.cm.zk_host 与实际 ZooKeeper 服务地址一致。
• 各节点间的业务网络连通，TLS 开启时所需证书、私钥和口令密文文件可由运行用户读取。

配置 RDMA 无损网络 ​

说明：

不使用 RDMA 协议时，可跳过本节。

如果安装环境配置了 RoCE 网卡，并且 UBSIO-MemStore 使用 RDMA 协议，需要先配置 RDMA 无损网络参数，避免数据通信过程中出现错误。具体配置方法请参见网卡厂商提供的 RDMA 使用说明。

启动 UBSIO-MemStore ​

融合部署模式 ​

融合部署模式下，UBSIO-MemStore 没有独立进程，而是与用户进程共同运行。

1. 将 mms.conf 中的 mms.deployment.mode 配置为 converge。
2. 用户进程链接 libmms_server.so，并调用 MmsInitialize 启动服务。

分离部署模式 ​

分离部署模式下，Server 端以独立进程运行并读取 mms.conf，Client 端集成在用户进程中。

1. 将 mms.conf 中的 mms.deployment.mode 配置为 separate。

2. 在每个 Server 节点启动 mmsd：

   bash

   mmsd &

3. 用户进程链接 libmms_client.so，并调用 MmsInitialize 启动 Client 端服务。

软件卸载 ​

须知：

卸载前，请停止相关业务和 UBSIO-MemStore 进程，并根据安全要求妥善清理证书、私钥和口令密文文件。

在每个安装节点执行：

yum remove ubs-io-memstore-devel ubs-io-memstore