安装手册

# 前言

本文档为金蝶Apusic分布式缓存（AMDC）V2.0.5产品的安装手册，提供产品在各种部署模式（含单机、哨兵、集群）下，于各操作系统及容器环境中的安装部署过程指导，以及相关配置说明。

# 适用对象

本文档适用于AMDC运维工程师、IT系统运维工程师、开发工程师、软件架构师等人员。

# 相关文档

了解更多AMDC V2.0.5产品相关的信息，请参阅以下AMDC V2.0.5产品手册文档集：

序号 手册文档 说明
1 金蝶Apusic分布式缓存 V2.0.5 快速使用手册 简单介绍了如何快速上手使用AMDC。
2 金蝶Apusic分布式缓存 V2.0.5 安装手册 详细介绍如何在各操作系统上安装AMDC，以及AMDC服务启停操作和产品注册过程。
3 金蝶Apusic分布式缓存 V2.0.5 缓存核心用户手册 详细介绍 AMDC 相关功能的使用、配置、管理及配套工具的使用方法。
4 金蝶Apusic分布式缓存 V2.0.5 管控台用户手册 详细介绍AMDC管控台相关功能的使用和操作说明。
5 金蝶Apusic分布式缓存 V2.0.5 开发手册 详细介绍基于各开发语言进行AMDC客户端应用开发的说明。
6 金蝶Apusic分布式缓存 V2.0.5 迁移手册 详细介绍AMDC历史版本迁移升级到V2.0.5版本的说明，以及Redis迁移到AMDC的说明。
7 金蝶Apusic分布式缓存 V2.0.5 运维手册 详细介绍AMDC的监控、运维、安全加固等运维说明。
8 金蝶Apusic分布式缓存 V2.0.5 性能优化手册 详细介绍AMDC性能调优的说明。

# 技术支持

AMDC产品提供全面的技术支持服务，您可以通过以下方式获得技术支持：

  • 网址：www.apusic.com

  • 电话：400-855-5800

  • 邮箱：support@apusic.com

  • 金蝶云社区：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技术支持时，请提供如下信息：

  1. 您的姓名

  2. 公司信息与联系方式

  3. 操作系统及其版本

  4. 产品版本号

  5. 出现异常及错误的日志、截图等详细信息

# 相关概念

名词 含义 使用说明
单机 存储数据，负责数据读写，负责数据同步 AMDC的默认模式，单机模式下只有一个节点
主从 从主节点复制数据，负责数据读取，不参与写操作 主节点数据的实时副本。它主动连接到指定的主节点，并接收主节点发送的数据流，从而保持与主节点的数据同步。默认情况下，从节点是只读的，所有写操作必须发送到主节点。
哨兵 监控主从节点，负责主节点故障转移，负责主从节点同步 哨兵模式，当主节点挂掉时，自动将从节点切换为主节点，实现故障自动转移。
集群 由多台相互独立的计算机组成的计算机服务系统 在本文中，主从/哨兵/集群三种模式都可以算是集群，cluster集群模式特指多主节点数据分片存储的模式。

# 安装说明

# 概述

AMDC 产品包分为缓存和控制台两个部分，其中缓存是AMDC核心组件，控制台是AMDC管理组件。

# 环境支持

平台类型 系统类型
芯片类型 华为鲲鹏、海思、飞腾、兆芯等X86/ARM架构芯片
操作系统 银河麒麟系列、统信UOS、中标麒麟等
其他Linux系列 RedHat系列、CentOS系列、Ubuntu系列等

# 推荐配置

部署模式 操作系统 安装内容 硬件规格 (CPU/内存/硬盘) 服务器台数
单机 Linux AMDC服务 8核/16G/100G 1
主从 Linux AMDC服务 8核/16G/100G 2
哨兵 Linux AMDC哨兵服务 8核/16G/100G 3
集群 Linux AMDC控制台、AMDC服务 8核/16G/100G 3

# AMDC缓存安装

# 缓存核心安装包命名规范

  • 解压安装包：AMDC-版本-构建日期-CPU架构.tar.gz 解压到目标机器任意路径即可使用。
  • docker安装包：AMDC-Docker-构建日期-CPU架构-基础操作系统.tar.gz。
  • RPM包：AMDC-构建日期-CPU架构.rpm，使用rpm -ivh 安装包名安装，安装完成后，其安装路径为/opt/amdc。

注：构建日期为AMDC产品包具体构建日期，同一个版本可能存在多个构建日期，获取安装包以最新日期为准。

# 单机模式

安装步骤：

  1. 上传AMDC缓存核心安装包(AMDC-版本-构建日期-CPU架构.tar.gz)至目标服务器的安装目录下（如：/opt目录下）
  2. 解压安装包：tar -zxf AMDC-版本-构建日期-CPU架构.tar.gz
  3. 进入解压后的文件夹：cd amdc
  4. 上传授权文件license.lic至每个节点安装目录/opt/amdc下。授权可参考本文档的AMDC 授权管理指南
    [root@private amdc]# tree -L 2
.
├── acls.properties
├── amdc-benchmark
├── amdc-check-aof
├── amdc-check-rdb
├── amdc-cli
├── amdc-conf-conv
├── amdc-sentinel
├── amdc-server
├── amdc.yaml
├── license.lic      # 授权文件
└── sentinel.yaml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
  5. 执行启动命令启动AMDC缓存核心：./amdc-server amdc.yaml

# 验证安装

./amdc-cli
1

若正常打出info信息，即连接成功。

./amdc-cli
127.0.0.1:6359> info
# Server
amdc_version:2.0.5
amdc_git_sha1:61420466
amdc_git_dirty:0
amdc_build_id:905134ad61530534
amdc_build_date:2026-06-04
amdc_mode:standalone
os:Linux 5.10.0-281.0.0.184.oe2203sp4.aarch64 aarch64
arch_bits:64
monotonic_clock:ARM CNTVCT @ 100 ticks/us
multiplexing_api:epoll
atomicvar_api:atomic-builtin
gcc_version:10.3.1
process_id:321475
process_supervised:no
run_id:69ffa6dd5f6bfa0250f5b0ee2bd38f8b9de143a3
tcp_port:6359
server_time_usec:1770275528738835
uptime_in_seconds:5201
uptime_in_days:0
hz:10
configured_hz:10
lru_clock:2168302
executable:/opt/amdc/amdc-server
config_file:/opt/amdc/amdc.yaml
worker_threads:1
mptcp_enabled:0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# 主从模式

主从部署图

如上图，将部署三个AMDC缓存核心，其中一个主节点，两个从节点，其部署步骤是：

  • 1.准备三个服务器节点（以下节点为示例）

    • 主节点： 10.0.1.46（示例IP，请替换为实际IP）
    • 从节点： 10.0.1.66（示例IP，请替换为实际IP）和10.0.1.32（示例IP，请替换为实际IP）

  • 2.上传AMDC缓存核心安装包(AMDC-版本-构建日期-CPU架构.tar.gz)至目标服务器的安装目录下(如：/opt目录下)

  • 3.解压安装包： tar -zxf AMDC-版本-构建日期-CPU架构.tar.gz

  • 4.进入解压后的文件夹：cd amdc

  • 5.上传授权文件license.lic至每个节点安装目录/opt/amdc下。授权可参考本文档的AMDC 授权管理指南

    [root@private amdc]# tree -L 2
.
├── acls.properties
├── amdc-benchmark
├── amdc-check-aof
├── amdc-check-rdb
├── amdc-cli
├── amdc-conf-conv
├── amdc-sentinel
├── amdc-server
├── amdc.yaml
├── license.lic      # 授权文件
└── sentinel.yaml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13

  • 6.配置amdc.yaml文件

    • 主节点： 修改amdc.yaml中的bind为当前机器IP

      NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 修改为本机IP地址
    - "-::1"
# 保护模式，当未指定 bind 且无密码时，仅允许本地回环地址和 Unix 域套接字连接
      1
      2
      3
      4
      5
      6

    • 从节点：

      • 10.0.1.66（示例IP，请替换为实际IP）: 修改amdc.yaml中的bind为当前机器IP和replicaof为主节点IP和端口
        NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
  - "10.0.1.66（示例IP，请替换为实际IP）"  # 添加本机IP
  - "-::1"

# 省略非配置项
REPLICATION:
  replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"  # 添加主节点IP和端口
        1
        2
        3
        4
        5
        6
        7
        8
        9
      • 10.0.1.32（示例IP，请替换为实际IP）: 修改amdc.yaml中的bind为当前机器IP和replicaof为主节点IP和端口
        NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
  - "10.0.1.32（示例IP，请替换为实际IP）"  # 添加本机IP
  - "-::1"

# 省略非配置项
REPLICATION:
  replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"  # 添加主节点IP和端口
        1
        2
        3
        4
        5
        6
        7
        8
        9

  • 7.在每个节点上启动AMDC缓存核心

    • 启动主节点：./amdc-server amdc.yaml
    • 启动从节点：./amdc-server amdc.yaml

  • 8.验证安装

    # 在主节点上执行
./amdc-cli -h 10.0.1.46（示例IP，请替换为实际IP） -p 6359 然后输入info replication
```bash
10.0.1.46（示例IP，请替换为实际IP）:6359> info replication
# Replication
role:master
connected_slaves:2
slave0:ip=10.0.1.66（示例IP，请替换为实际IP）,port=6359,state=online,offset=322,lag=0
slave1:ip=10.0.1.32（示例IP，请替换为实际IP）,port=6359,state=online,offset=322,lag=1
master_failover_state:no-failover
master_replid:c246dd7c8902e4ca62fc72df6473d9386b502c8e
master_replid2:0000000000000000000000000000000000000000
master_repl_offset:322
second_repl_offset:-1
repl_backlog_active:1
repl_backlog_size:1048576
repl_backlog_first_byte_offset:1
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    1. 如上述输出所示，成功出现两个从节点信息，标志启动三节点的主从模式成功

# 哨兵模式

哨兵模式部署图

如上图，将部署三个AMDC缓存核心+三个哨兵，其部署步骤是：

  • 1.准备三个服务器节点（以下节点为示例）

    • 10.0.1.46（示例IP，请替换为实际IP）: 主节点+哨兵
    • 10.0.1.66（示例IP，请替换为实际IP）: 从节点+哨兵
    • 10.0.1.32（示例IP，请替换为实际IP）: 从节点+哨兵

  • 2.上传AMDC缓存核心安装包(AMDC-版本-构建日期-CPU架构.tar.gz)至目标服务器的安装目录下(如：/opt目录下)

  • 3.解压安装包： tar -zxf AMDC-版本-构建日期-CPU架构.tar.gz

  • 4.进入解压后的文件夹: cd amdc

  • 5.上传授权文件license.lic至每个节点安装目录/opt/amdc下。授权可参考本文档的AMDC 授权管理指南

  • 6.缓存配置amdc.yaml文件

    • 主节点： 修改amdc.yaml中的bind为当前机器IP

      NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 修改为本机IP地址
    - "-::1"
# 保护模式，当未指定 bind 且无密码时，仅允许本地回环地址和 Unix 域套接字连接
      1
      2
      3
      4
      5
      6

    • 从节点：

      • 10.0.1.66（示例IP，请替换为实际IP）: 修改amdc.yaml中的bind为当前机器IP和replicaof为主节点IP和端口
        NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
  - "10.0.1.66（示例IP，请替换为实际IP）"  # 添加本机IP
  - "-::1"

# 省略非配置项
REPLICATION:
  replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"  # 添加主节点IP和端口
        1
        2
        3
        4
        5
        6
        7
        8
        9
      • 10.0.1.32（示例IP，请替换为实际IP）: 修改amdc.yaml中的bind为当前机器IP和replicaof为主节点IP和端口
        NETWORK:
# 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
bind:
  - "10.0.1.32（示例IP，请替换为实际IP）"  # 添加本机IP
  - "-::1"

# 省略非配置项
REPLICATION:
  replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"  # 添加主节点IP和端口
        1
        2
        3
        4
        5
        6
        7
        8
        9

  • 7.哨兵配置

    • 10.0.1.46（示例IP，请替换为实际IP） 节点哨兵修改bind为当前IP，以及主节点的IP
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
      - "10.0.1.46（示例IP，请替换为实际IP）"
      - "-::1"
# 省略非配置项
SENTINEL:
  # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
  sentinel monitor: mymaster 10.0.1.46（示例IP，请替换为实际IP） 6359 2
      1
      2
      3
      4
      5
      6
      7
      8
      9
    • 10.0.1.66（示例IP，请替换为实际IP） 节点哨兵修改bind为当前IP，以及主节点的IP
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
      - "10.0.1.66（示例IP，请替换为实际IP）"
      - "-::1"
# 省略非配置项
SENTINEL:                                                                             # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
  sentinel monitor: mymaster 10.0.1.46（示例IP，请替换为实际IP） 6359 2
      1
      2
      3
      4
      5
      6
      7
      8
    • 10.0.1.32（示例IP，请替换为实际IP） 节点哨兵修改bind为当前IP，以及主节点的IP
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
      - "10.0.1.32（示例IP，请替换为实际IP）"
      - "-::1"
# 省略非配置项
SENTINEL:
  # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
  sentinel monitor: mymaster 10.0.1.46（示例IP，请替换为实际IP） 6359 2
      1
      2
      3
      4
      5
      6
      7
      8
      9

  • 8.在每个节点上启动缓存和哨兵

    • 启动主节点：./amdc-server amdc.yaml
    • 启动从节点：./amdc-server amdc.yaml
    • 启动哨兵：./amdc-sentinel sentinel.yaml

  • 9.验证哨兵模式

    • 使用amdc-cli客户端工具通过指定-p和-h参数，指定哨兵的IP和端口
      ./amdc-cli -p 26359 -h 10.0.1.46（示例IP，请替换为实际IP）
10.0.1.46（示例IP，请替换为实际IP）:26359> info sentinel
# Sentinel
sentinel_masters:1
sentinel_tilt:0
sentinel_running_scripts:0
sentinel_scripts_queue_length:0
sentinel_simulate_failure_flags:0
master0:name=mymaster,status=ok,address=10.0.1.46（示例IP，请替换为实际IP）:6359,slaves=2,sentinels=3
      1
      2
      3
      4
      5
      6
      7
      8
      9
    • 如出现主节点信息、从节点数量和哨兵数量均正确，即表示部署成功。

# 哨兵模式运维 FAQ

一. 哨兵集群状态错乱、节点信息异常（主从 / 哨兵互相识别紊乱）

现象

  • 哨兵频繁切换主节点、切换逻辑混乱；
  • sentinel info 查看发现存在大量已下线、已删除的旧主库、从库、哨兵记录；
  • 新旧节点混杂，判定主从关系错误，频繁误触发故障转移；
  • 手动下线节点后哨兵仍残留该节点信息，无法自动清理。

根因

哨兵运行时会自动在 sentinel.yaml 文件底部追加持久化记录：

  • known-replica：记录关联主库的所有从节点
  • known-sentinel：记录同集群其他哨兵节点

known-replica 与实际主从节点关系存在差异，导致主从关系识别错误。

修复步骤

  1. 停止所有哨兵进程
amdc-cli -h 哨兵Ip -p 哨兵Port -a 密码 shutdown 

systemctl stop amdc_26359 (在一些机器上会配置自动重启，需要用systemctl stop 命令手动停止节点)
1
2
3
  1. 编辑所有哨兵配置文件 sentinel.yaml

删除配置文件末尾config rewrite自动生成的全部 known-sentinel、known-replica 等配置行，保留手动编写的基础配置（sentinel monitor、认证、故障切换参数等不动）。

删除前：

SENTINEL:
    # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
    sentinel monitor: mymaster 127.0.0.1 6111 2
    # 主从节点的认证用户名，格式为 <master-name> <username>
    sentinel auth-user: mymaster ""
    # 主从节点的认证密码，格式为 <master-name> <password>
    sentinel auth-pass: mymaster ""
    # 判定节点主观下线的超时时间（毫秒），默认 30000（30 秒）
    sentinel down-after-milliseconds: mymaster 30000
    # Sentinel 之间通信的认证用户名
    sentinel sentinel-user: ""
    # Sentinel 之间通信的认证密码其他设置
    sentinel sentinel-pass: ""
    # 故障转移时从节点同步新主节点的并发数量，默认 1
    sentinel parallel-syncs: mymaster 1
    # 故障转移超时时间（毫秒），默认 180000（3 分钟）
    sentinel failover-timeout: mymaster 180000
    # 发生警告级事件时执行的通知脚本（如邮件、短信通知），格式为 <master-name> <script-path>
    sentinel notification-script: mymaster ""
    # 故障转移后通知客户端重新配置的脚本，格式为 <master-name> <script-path>
    sentinel client-reconfig-script: mymaster ""
    # 是否禁止运行时修改脚本配置，默认 yes
    sentinel deny-scripts-reconfig: yes
    # 重命名命令，格式为 <master-name> <old-command-name> <new-command-name>
    sentinel rename-command: mymaster "" ""
    # 是否支持主机名（默认 no，需依赖 DNS）
    sentinel resolve-hostnames: no
    # 是否对外公布主机名（默认 no）
    sentinel announce-hostnames: no
    # NAT/Docker 环境下对外公布的 IP
    sentinel announce-ip: ""
    # NAT/Docker 环境下对外公布的端口
    sentinel announce-port: 0
    # 控制主节点重启加载数据时，Sentinel 要不要触发故障转移，默认 0 主节点只要在加载数据，Sentinel 绝对不切换主库
    sentinel master-reboot-down-after-period: mymaster 1
    
CONFIG REWRITE:
    sentinel myid: 7354c3cc4fb8faa5fc5de06781f8b497e60d25dc
    sentinel config-epoch: mymaster 0
    sentinel leader-epoch: mymaster 0
    sentinel current-epoch: 0
    sentinel known-replica: mymaster 127.0.0.1 6112
    sentinel known-sentinel: mymaster 127.0.0.1 26359 a2d89d7c88f0975fb61dcb5df7f78b297e2099ca
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
删除后：

SENTINEL:
    # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
    sentinel monitor: mymaster 127.0.0.1 6111 2
    # 主从节点的认证用户名，格式为 <master-name> <username>
    sentinel auth-user: mymaster ""
    # 主从节点的认证密码，格式为 <master-name> <password>
    sentinel auth-pass: mymaster ""
    # 判定节点主观下线的超时时间（毫秒），默认 30000（30 秒）
    sentinel down-after-milliseconds: mymaster 30000
    # Sentinel 之间通信的认证用户名
    sentinel sentinel-user: ""
    # Sentinel 之间通信的认证密码其他设置
    sentinel sentinel-pass: ""
    # 故障转移时从节点同步新主节点的并发数量，默认 1
    sentinel parallel-syncs: mymaster 1
    # 故障转移超时时间（毫秒），默认 180000（3 分钟）
    sentinel failover-timeout: mymaster 180000
    # 发生警告级事件时执行的通知脚本（如邮件、短信通知），格式为 <master-name> <script-path>
    sentinel notification-script: mymaster ""
    # 故障转移后通知客户端重新配置的脚本，格式为 <master-name> <script-path>
    sentinel client-reconfig-script: mymaster ""
    # 是否禁止运行时修改脚本配置，默认 yes
    sentinel deny-scripts-reconfig: yes
    # 重命名命令，格式为 <master-name> <old-command-name> <new-command-name>
    sentinel rename-command: mymaster "" ""
    # 是否支持主机名（默认 no，需依赖 DNS）
    sentinel resolve-hostnames: no
    # 是否对外公布主机名（默认 no）
    sentinel announce-hostnames: no
    # NAT/Docker 环境下对外公布的 IP
    sentinel announce-ip: ""
    # NAT/Docker 环境下对外公布的端口
    sentinel announce-port: 0
    # 控制主节点重启加载数据时，Sentinel 要不要触发故障转移，默认 0 主节点只要在加载数据，Sentinel 绝对不切换主库
    sentinel master-reboot-down-after-period: mymaster 1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
  1. 校验集群主从节点映射关系是否与 Sentinel 的 monitor 监控配置保持一致；若存在不匹配，可通过修改 sentinel monitor 配置项，或执行slaveof命令手动调整节点主从归属。
检查哨兵节点 sentinel monitor 配置项

SENTINEL:
    # 定义要监控的主节点，格式为 <master-name> <ip> <amdc-port> <quorum>（如 mymaster 127.0.0.1 6359 2 表示至少 2 个 Sentinel 认为主节点下线才判定为客观下线）
    sentinel monitor: mymaster 127.0.0.1 6111 2
1
2
3
4
5
检查主从节点信息

127.0.0.1:6111> info replication
# Replication
role:master
connected_slaves:1
slave0:ip=127.0.0.1,port=6112,state=online,offset=102202,lag=1,worker-thread=0
master_failover_state:no-failover
master_replid:b4a214a5cecfbd69098c2bcdc8237a58770095ef
master_replid2:0000000000000000000000000000000000000000
master_repl_offset:102202
second_repl_offset:-1
repl_backlog_active:1
repl_backlog_size:1048576
repl_backlog_first_byte_offset:1
repl_backlog_histlen:102202
repl_mptcp_enabled:0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  1. 逐个重启哨兵节点
amdc-sentinel sentinel.yaml

systemctl start amdc_26359 (在一些机器上会配置自动重启，需要用systemctl start 命令手动启动节点)
1
2
3
  1. 校验哨兵集群拓扑
# 连接任意哨兵
amdc-cli -h 哨兵Ip -p 哨兵Port -a 密码
SENTINEL MASTERS
SENTINEL REPLICAS mymaster
SENTINEL SENTINELS mymaster
1
2
3
4
5

确认主从/哨兵节点关系是否正常。

二. 哨兵误触发故障转移

现象

主节点网络短暂抖动、负载高响应延迟，哨兵判定主库下线，自动切主。

排查 & 解决

  • 调整故障转移投票等待时长，避免瞬时抖动触发切换 sentinel down-after-milliseconds mymaster 50000；
  • 检查主库 CPU、磁盘、网络带宽，优化主节点性能；
  • 多哨兵分散部署在不同机房 / 服务器，避免单点网络故障全员误判。

三. 哨兵之间无法互相发现、哨兵投票不生效

现象

多哨兵部署，但 SENTINEL SENTINELS 只能看到自身，无法完成故障转移投票。

排查点

  • 防火墙放行 26379 哨兵端口，节点间互通；
  • 配置文件 sentinel monitor 集群名称完全一致；
  • 清理配置文件底部冗余 known-sentinel 记录后重启哨兵；
  • 检查密码配置，主从、哨兵认证密码统一。

# 集群模式

集群部署图

集群节点规划

服务器IP 角色 端口
10.0.1.46（示例IP，请替换为实际IP） 集群节点1+从节点1 6359，6360
10.0.1.66（示例IP，请替换为实际IP） 集群节点2+从节点2 6359，6360
10.0.1.32（示例IP，请替换为实际IP） 集群节点3+从节点3 6359，6360

# 集群安装步骤

  • 1.准备服务器节点

  • 2.上传AMDC缓存核心安装包(AMDC-版本-构建日期-CPU架构.tar.gz)至上述目标服务器的安装目录下(如：/opt目录下)

  • 3.解压安装包： tar -zxf AMDC-版本-构建日期-CPU架构.tar.gz

  • 4.复制一份安装包为slave节点: cp -r amdc amdc-slave

  • 5.上传授权文件license.lic至每个节点安装目录/opt/amdc/下，（包括slave）。授权可参考本文档的AMDC 授权管理指南

    [root@private opt]# tree -L 2
.
├── amdc
│   ├── acls.properties
│   ├── amdc-benchmark
│   ├── amdc-check-aof
│   ├── amdc-check-rdb
│   ├── amdc-cli
│   ├── amdc-conf-conv
│   ├── amdc-sentinel
│   ├── amdc-server
│   ├── amdc.yaml
│   ├── license.lic #授权文件
│   └── sentinel.yaml
└── amdc-slave          # 从节点目录
    ├── acls.properties
    ├── amdc-benchmark
    ├── amdc-check-aof
    ├── amdc-check-rdb
    ├── amdc-cli
    ├── amdc-conf-conv
    ├── amdc-sentinel
    ├── amdc-server
    ├── amdc.yaml
    ├── license.lic #授权文件
    └── sentinel.yaml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26

  • 6.集群配置

    • 集群节点1（10.0.1.46（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"
GENERAL:
    # 是否以守护进程模式运行
    daemonize: yes
# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
    • 集群节点2（10.0.1.66（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.66（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"

# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
    • 集群节点3（10.0.1.32（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.32（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"

# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10

  • 7.从节点配置

    • 由于主节点和从节点在同一台机器上，这里修改监听端口为：6360
    • 下面操作进入amdc-slave目录下操作
    • 从节点1（10.0.1.46（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP、Port和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"
  port: 6360
GENERAL:
    # 是否以守护进程模式运行
    daemonize: yes
    # pid 文件路径
    pidfile: "/var/run/amdc-server-slave.pid"
# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
  # 集群配置文件路径，由节点自动维护
  cluster-config-file: "node-6360.conf"
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
    • 从节点2（10.0.1.66（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP、Port和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.66（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"
  port: 6360
GENERAL:
    # 是否以守护进程模式运行
    daemonize: yes
    # pid 文件路径
    pidfile: "/var/run/amdc-server-slave.pid"
# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
  # 集群配置文件路径，由节点自动维护
  cluster-config-file: "node-6360.conf"
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
    • 从节点3（10.0.1.32（示例IP，请替换为实际IP））： 修改amdc.yaml中的bind为当前机器IP、Port和开启集群模式，并开启后台运行模式
      NETWORK:
  # 监听的网络地址，默认仅监听本地回环地址，注释此行可监听所有接口（暴露在公网有安全风险)
  bind:
    - "10.0.1.32（示例IP，请替换为实际IP）"  # 添加本机IP
    - "-::1"
  port: 6360
GENERAL:
    # 是否以守护进程模式运行
    daemonize: yes
    # pid 文件路径
    pidfile: "/var/run/amdc-server-slave.pid"
# 省略非配置项
CLUSTER:
  # 是否启用集群模式
  cluster-enabled: yes
  # 集群配置文件路径，由节点自动维护
  cluster-config-file: "node-6360.conf"
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17

  • 8.在每个节点上启动缓存和从节点

    • 启动主节点：./amdc-server amdc.yaml
    • 启动从节点（切换至amdc-slave）：./amdc-server amdc.yaml

  • 9.使用amdc-cli客户端工具创建集群

    • amdc-cli: ./amdc-cli --cluster create 10.0.1.46（示例IP，请替换为实际IP）:6359 10.0.1.66（示例IP，请替换为实际IP）:6359 10.0.1.32（示例IP，请替换为实际IP）:6359 10.0.1.46（示例IP，请替换为实际IP）:6360 10.0.1.66（示例IP，请替换为实际IP）:6360 10.0.1.32（示例IP，请替换为实际IP）:6360 --cluster-replicas 1

      注： amdc-cli --cluster 命令使用手册可参考用户手册。

    • 创建过程中，要输入“yes”，确认集群节点安排，如下：
    [root@private amdc]# ./amdc-cli --cluster create 10.0.1.46（示例IP，请替换为实际IP）:6359 10.0.1.66（示例IP，请替换为实际IP）:6359 10.0.1.32（示例IP，请替换为实际IP）:6359 10.0.1.46（示例IP，请替换为实际IP）:6360 10.0.1.66（示例IP，请替换为实际IP）:6360 10.0.1.32（示例IP，请替换为实际IP）:6360  --cluster-replicas 1
>>> Performing hash slots allocation on 6 nodes...
Master[0] -> Slots 0 - 5460
Master[1] -> Slots 5461 - 10922
Master[2] -> Slots 10923 - 16383
Adding replica 10.0.1.66（示例IP）:6360 to 10.0.1.46（示例IP）:6359
Adding replica 10.0.1.32（示例IP）:6360 to 10.0.1.66（示例IP）:6359
Adding replica 10.0.1.46（示例IP）:6360 to 10.0.1.32（示例IP）:6359
M: a11b0a053f596321a4e310046e2b69bca8c96d4a 10.0.1.46（示例IP）:6359
  slots:[0-5460] (5461 slots) master
M: ab6dcd5d434ce3ec8ad199ac1a3d610ac33f3a7f 10.0.1.66（示例IP）:6359
  slots:[5461-10922] (5462 slots) master
M: 70451b10ef6f7793083b47a994c900cccc218b39 10.0.1.32（示例IP）:6359
  slots:[10923-16383] (5461 slots) master
S: 37ffc8538d24b332d45d6732b1df7e9386114522 10.0.1.46（示例IP）:6360
  replicates 70451b10ef6f7793083b47a994c900cccc218b39
S: 3ffc63268838f02dd4e1d66f11b5a6ffdc83cdfe 10.0.1.66（示例IP）:6360
  replicates a11b0a053f596321a4e310046e2b69bca8c96d4a
S: 4862dfb143cf5de0bebb64370f77c8bbe5bfc917 10.0.1.32（示例IP）:6360
  replicates ab6dcd5d434ce3ec8ad199ac1a3d610ac33f3a7f
Can I set the above configuration? (type 'yes' to accept): yes
>>> Nodes configuration updated
>>> Assign a different config epoch to each node
>>> Sending CLUSTER MEET messages to join the cluster
Waiting for the cluster to join
.
>>> Performing Cluster Check (using node 10.0.1.46（示例IP）:6359)
M: a11b0a053f596321a4e310046e2b69bca8c96d4a 10.0.1.46（示例IP）:6359
  slots:[0-5460] (5461 slots) master
  1 additional replica(s)
S: 4862dfb143cf5de0bebb64370f77c8bbe5bfc917 10.0.1.32（示例IP）:6360
  slots: (0 slots) slave
  replicates ab6dcd5d434ce3ec8ad199ac1a3d610ac33f3a7f
S: 37ffc8538d24b332d45d6732b1df7e9386114522 10.0.1.46（示例IP）:6360
  slots: (0 slots) slave
  replicates 70451b10ef6f7793083b47a994c900cccc218b39
S: 3ffc63268838f02dd4e1d66f11b5a6ffdc83cdfe 10.0.1.66（示例IP）:6360
  slots: (0 slots) slave
  replicates a11b0a053f596321a4e310046e2b69bca8c96d4a
M: 70451b10ef6f7793083b47a994c900cccc218b39 10.0.1.32（示例IP）:6359
  slots:[10923-16383] (5461 slots) master
  1 additional replica(s)
M: ab6dcd5d434ce3ec8ad199ac1a3d610ac33f3a7f 10.0.1.66（示例IP）:6359
  slots:[5461-10922] (5462 slots) master
  1 additional replica(s)
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49

  • 10.查看集群状态

    • ./amdc-cli --cluster info
    [root@private amdc]# ./amdc-cli --cluster info
10.0.1.46（示例IP）:6359> cluster info
cluster_state:ok
cluster_slots_assigned:16384
cluster_slots_ok:16384
cluster_slots_pfail:0
cluster_slots_fail:0
cluster_known_nodes:6
cluster_size:3
cluster_current_epoch:7
cluster_my_epoch:1
cluster_stats_messages_ping_sent:100
cluster_stats_messages_pong_sent:131
cluster_stats_messages_auth-ack_sent:1
cluster_stats_messages_sent:232
cluster_stats_messages_ping_received:131
cluster_stats_messages_pong_received:96
cluster_stats_messages_fail_received:1
cluster_stats_messages_auth-req_received:1
cluster_stats_messages_received:229
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20

# Docker容器环境安装

AMDC提供arm和x86的Docker安装包，可通过AMDC-Docker安装包直接部署AMDC.

# 安装包说明

  1. AMDC-Docker压缩安装包名称
  • x86_64: AMDC-Docker-20260604-amd64-kylin.tar.gz
  • arm64: AMDC-Docker-20260604-arm64-kylin.tar.gz

注： 安装包日期可能不同，请根据实际情况选择。

  1. 安装包目录结构
tree -L 1 AMDC-Docker-20260604-amd64-kylin
AMDC-Docker-20260604-amd64-kylin             # docker安装包解压后目录
|-- AMDC-Docker-20260604-amd64-kylin.tar.gz  # docker镜像文件
|-- amdc
|   |-- amdc.conf                                     # AMDC配置文件
|   |-- license.xml                                   # 授权文件
|-- amdc-dockercompose.yaml                   # docker compose配置文件
1
2
3
4
5
6
7

# 安装步骤

下面的操作以AMDC-Docker-20260604-amd64-kylin.tar.gz为例说明。

  1. 解压和导入镜像
  • 解压tar -zxvf AMDC-Docker-20260604-amd64-kylin.tar.gz
  • 进入解压后的文件夹cd AMDC-Docker-20260604-amd64-kylin
  • 加载镜像： docker load < AMDC-Docker-20260604-amd64-kylin.tar.gz
  1. 修改授权文件

AMDC授权文件需要挂载到容器内部安装目录，将不同授权文件放入当前amdc目录下，启动容器前，请确认授权文件有效，按需检查或替换授权文件。

授权文件挂载说明

  • license.xml 旧授权挂载目标路径：/usr/local/bin/license.xml
  • license.lic KBC授权挂载目标路径：/usr/local/bin/license.lic
  • acls.properties统一授权配置文件挂载目标路径：/usr/local/bin/acls.properties
  1. 镜像启动与停止
  • 启动命令： docker-compose -f amdc-dockercompose.yaml up -d
  • 停止命令： docker-compose -f amdc-dockercompose.yaml down
  1. amdc-dockercompose.yaml配置说明
version: '3'
services:
  amdc:
    image: docker_image_tag
    ports:
      - 6359:6359
    volumes:
      - ./amdc:/opt/amdc:z  # 将宿主机 ./amdc 目录挂载至容器 /opt/amdc
      - ./amdc/license.xml:/usr/local/bin/license.xml  # 将授权文件挂载到目标位置，lic授权文件也同样挂载
    working_dir: /opt/amdc  # 将容器启动默认工作目录配置为挂载路径 /opt/amdc，该路径与业务配置文件 amdc.yaml 中 dir 参数填写路径统一，保证程序读取目录一致。
    command: /usr/local/bin/amdc-server # amdc-cli / amdc-server / amdc-sentinel 等其他可执行文件都在docker内部 /usr/local/bin/ 目录下
1
2
3
4
5
6
7
8
9
10
11

# RPM包安装

RPM（Red Hat Package Manager）安装包是一种在 Linux 系统中用于软件包管理的格式，最初由 Red Hat 开发，现在广泛用于基于 Red Hat 的发行版，AMDC提供arm和x86的RPM安装包，可通过rpm命令安装。其支持的操作系统有：

  • Kylin
  • OpenEuler
  • CentOS

# 安装包安装

  • x86_64: AMDC-2.0.5-20260206-1.el7.x86_64.rpm
  • arm64: AMDC-2.0.5-20260206-1.el7.aarch64.rpm
  1. 安装命令：
rpm -ivh AMDC-2.0.5-20260206-1.el7.x86_64.rpm
Preparing...                          ################################# [100%]
Updating / installing...
   1:amdc-2.0.5-1.el7                 ################################# [100%]
1
2
3
4
  1. 安装完后，产品介质安装目录在/opt/amdc-2.0.5目录下
  2. 将授权文件导入到/opt/amdc-2.0.5/license.xml文件中
  3. 启动命令：/opt/amdc-2.0.5/amdc-server

# 停止缓存核心服务

AMDC 缓存核心提供多种停止方式，为确保数据安全和系统稳定性，建议按照以下优先级顺序选择合适的停止方法：

# 停止方式

  1. 通过客户端发送 SHUTDOWN 命令

    这是最安全的停止方式，AMDC 会在完成数据持久化后再退出，确保数据完整性。

    ./amdc-cli -h [IP地址] -p [端口] -a [密码] shutdown
    1

  2. 交互式客户端停止

    当已连接到 AMDC 客户端时，可直接执行 shutdown 命令：

    127.0.0.1:6359> shutdown
    1

执行流程：

  1. 断开所有客户端连接
  2. 根据配置执行 RDB/AOF 持久化操作
  3. 安全退出服务进程

# 紧急停止方式

当 AMDC 服务无响应或无法正常停止时，可使用此方式。注意：此操作可能导致数据丢失！

操作步骤：

  1. 查找 AMDC 进程 PID：

    ss -nltp | grep amdc
# 或者
ps -ef | grep amdc
    1
    2
    3

  2. 强制终止进程：

    kill -9 [进程ID]
    1

# 停止方式对比

停止方式 数据安全性 适用场景 推荐度
客户端 SHUTDOWN 命令 高 正常维护、计划停机 推荐
交互式 shutdown 高 调试、测试环境 推荐
强制 kill -9 低 服务无响应、紧急故障处理 不推荐

重要提示：生产环境中请优先使用优雅停机方式，避免因强制终止导致的数据丢失风险。只有在 AMDC 服务完全无响应且无法通过正常方式停止时，才考虑使用强制终止方式。

# License（许可）授权管理

# 授权模式概述

金蝶Apusic分布式缓存（AMDC）V2.0.5 支持四种License许可授权验证模式，用户可根据实际需求选择合适的授权方式：

授权模式 适用场景 配置文件 特点
金蝶天燕本地授权 独立部署、离线环境 license.xml 本地文件授权，支持绑定IP、MAC地址
金蝶KBC授权 标准生产环境 license.lic 本地授权文件，通过授权码方式验证
金蝶统一授权中心 多租户、云环境 acls.properties 集中式授权管理，支持多租户
金蝶统一授权中心环境变量 多租户、云环境 acls.properties env 集中式授权管理，支持多租户

默认授权模式：金蝶天燕本地授权和金蝶KBC授权验证

注意: AMDC V2.0.5 版本优化授权文件加载逻辑，授权文件仅需放置在 amdc-server 同级目录，无需再通过 amdc.yaml 配置授权路径，简化部署配置流程。

# 授权配置详解

# 金蝶天燕本地授权

适用场景：离线环境、独立部署、测试环境

配置步骤：

  1. 获取 license.xml 授权文件
  2. 将授权文件放置在AMDC安装目录下

# 金蝶KBC授权

适用场景：标准生产环境、需要设备绑定的场景、离线环境

配置步骤：

  1. 获取设备特征码

    执行AMDC服务启动命令，系统将自动输出设备特征码：

    ./amdc-server
    1

    输出示例：

    400987:C 05 Feb 2026 17:33:59.232 # Warning: no config file specified, using the ./amdc.yaml
400987:C 05 Feb 2026 17:33:59.232 # oO0OoO0OoO0Oo AMDC is starting oO0OoO0OoO0Oo
400987:C 05 Feb 2026 17:33:59.232 * AMDC KBC authorization code: 'SZTY-1486655719' for mac: 00-00-00-00-00-00（示例MAC地址）
400987:C 05 Feb 2026 17:33:59.235 # No valid license file found: ./license.xml or ./license.lic
400987:C 05 Feb 2026 17:33:59.235 # Local license verification failed!
    1
    2
    3
    4
    5

    特征码说明：

    • 格式：SZTY-XXXXXXXXXX（以SZTY开头）
    • 绑定信息：MAC地址或其他硬件特征
    • 注意：每个设备的特征码具有唯一性，不可跨设备使用

  2. 申请授权文件

    1. 访问金蝶KBC授权系统（此操作由金蝶天燕销售、实施或研发人员操作）
    2. 使用获取的特征码申请授权
    3. 下载生成的 license.lic 文件

  3. 配置授权文件

    1. 将 license.lic 文件放置在AMDC安装目录下

# 金蝶统一授权中心

适用场景：多租户环境、云平台部署、集中式授权管理

配置步骤：

  1. 创建 acls.properties 配置文件

  2. 配置授权中心连接信息：

    # 是否开启统一授权中心
apusic_acls_enable=true

# 授权中心地址（多个地址用逗号分隔）
apusic_acls_authUrls=10.0.1.100:8080,10.0.1.101:8080（示例IP，请替换为实际IP）

# 命名空间
apusic_acls_ns=public

# 租户名称（如不确定可填写为public）
apusic_acls_tenant=public
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11

  3. 将 acls.properties 文件放置在AMDC安装目录下

# 授权文件管理

# 授权文件位置

所有授权文件均需放置在AMDC安装目录下，与 amdc-server 可执行文件同级目录。

# 授权热更新

AMDC支持授权文件热更新，无需重启服务：

  • 直接替换现有的授权文件内容
  • 系统会自动检测并加载新的授权信息
  • 注意：确保新授权文件格式正确，避免授权失效
# 授权验证优先级

当多种授权文件同时存在时，AMDC按照以下优先级进行验证：

  1. acls.properties env（统一授权中心环境变量）
  2. acls.properties（统一授权中心）
  3. license.lic（KBC授权）
  4. license.xml（本地授权）

# 故障排查

# 常见错误信息

  • "No valid license file found"：未找到有效的授权文件
  • "Local license verification failed"：授权文件无效或已过期
  • "Authorization code mismatch"：特征码与设备不匹配

# 处理方案

  1. 确认授权文件放置在正确目录
  2. 验证授权文件格式和内容是否正确
  3. 检查设备特征码是否与授权文件匹配
  4. 确认授权文件是否在有效期内

# 缓存核心服务相关参数说明

# 网络配置参数

# 监听地址配置

参数名称 默认值 说明 使用方式
bind 127.0.0.1 -::1 监听的网络地址，指定客户端访问缓存的IP地址，除绑定地址外无法连接 可绑定多个地址，如：bind:
- "127.0.0.1"
- "192.168.x.x"（示例IP，请替换为实际IP）

# 端口配置

参数名称 默认值 说明 使用方式
port 6359 监听的TCP端口，设为0则不监听TCP套接字 port: 6359

# 保护模式

参数名称 默认值 说明
protected-mode yes 保护模式，当未指定bind且无密码时，仅允许本地回环地址和Unix域套接字连接

# 后台运行配置

# 守护进程模式

参数名称 默认值 说明 使用方式
daemonize no 是否以守护进程模式运行，yes则后台运行并生成pid文件 daemonize: yes, 注：logfile参数需要填写，以便查看日志

# PID文件配置

参数名称 默认值 说明 使用方式
pidfile /var/run/amdc-sentinel.pid pid文件路径，守护进程模式下默认生成 pidfile: "/var/run/amdc-server.pid"

# 安全认证配置

# 密码认证

参数名称 说明 使用方式
requirepass 设置密码，可以为空。从节点密码建议与主节点密码保持一致 requirepass: "123456"
注：在users.acl存在的情况下，server优先使用users.acl中的密码
masterauth 主节点的密码，若主节点无密码则不需要填，若有密码，不分主从所有节点都需要填写该参数 masterauth: "123456"

# 集群配置

# 集群模式

参数名称 默认值 说明 使用方式
cluster-enabled - 是否开启集群模式 cluster-enabled: "yes"

# 集群配置文件

参数名称 默认值 说明
cluster-config-file - 集群配置文件路径，由节点自动维护

# 集群端口

参数名称 默认值 说明 使用方式
port 6359 监听的TCP端口，设为0则不监听TCP套接字 port: 6359
集群总线 16359 集群节点间Gossip通信端口（=缓存端口+10000）

# 哨兵配置

# 哨兵端口

参数名称 默认值 说明
port 26359 哨兵进程监听的TCP端口

# 哨兵监控配置

参数名称 说明 使用方式
sentinel monitor 监控的主节点配置 sentinel monitor: mymaster 127.0.0.1 6379 1
sentinel auth-pass 主节点密码校验 sentinel auth-pass: mymaster 123456

# 主从模式

# 主从配置

参数名称 说明 使用方式
replicaof 指定主节点地址和端口 replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"

# 存储配置

# 数据文件配置

参数名称 默认值 说明
dbfilename "dump.rdb" RDB文件名，不包括路径
dir "./" RDB文件、AOF文件夹、license文件、apusic-acls文件、aclfile文件、cluster-config-file文件等其他相对路径文件均受dir参数影响

# AOF持久化配置

参数名称 默认值 说明 使用方式
appendonly no 是否启用AOF持久化 appendonly: yes
appendfilename "appendonly.aof" AOF文件名称 appendfilename: "amdc.aof"
appendfsync everysec AOF刷盘策略：
no（依赖系统）
always（每次写入）
everysec（每秒一次）		 appendfsync: everysec
no-appendfsync-on-rewrite no AOF重写期间是否禁用主进程的fsync no-appendfsync-on-rewrite: yes
auto-aof-rewrite-percentage 100 AOF自动重写的触发百分比 auto-aof-rewrite-percentage: 100
auto-aof-rewrite-min-size 64mb AOF自动重写的最小文件大小 auto-aof-rewrite-min-size: 64mb
aof-load-truncated yes 启动时是否加载被截断的AOF文件 aof-load-truncated: yes
aof-use-rdb-preamble yes AOF重写时是否使用RDB前缀 aof-use-rdb-preamble: yes

# 重要配置示例

# 单机模式配置示例

NETWORK:
  bind:
    - "0.0.0.0"  # 允许所有IP访问
  port: 6359
  protected-mode: yes

GENERAL:
  daemonize: yes  # 后台运行
  pidfile: "/var/run/amdc-server.pid"

SECURITY:
  requirepass: "your_password"  # 设置访问密码
1
2
3
4
5
6
7
8
9
10
11
12

# 主从模式配置示例

# 主节点配置
NETWORK:
  bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 主节点IP
  port: 6359

GENERAL:
  daemonize: yes

SECURITY:
  requirepass: "master_password"  # 主节点密码

# 从节点配置
NETWORK:
  bind:
    - "10.0.1.66（示例IP，请替换为实际IP）"  # 从节点IP
  port: 6359

GENERAL:
  daemonize: yes

REPLICATION:
  replicaof: "10.0.1.46（示例IP，请替换为实际IP） 6359"  # 指定主节点

SECURITY:
  requirepass: "master_password"  # 从节点密码需与主节点一致
  masterauth: "master_password"   # 主节点密码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 哨兵模式配置示例

NETWORK:
  bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 哨兵节点IP
  port: 26359

GENERAL:
  daemonize: yes

SENTINEL:
  sentinel monitor: mymaster 10.0.1.46（示例IP，请替换为实际IP） 6359 2  # 监控主节点
  sentinel auth-pass: mymaster master_password    # 主节点密码
1
2
3
4
5
6
7
8
9
10
11

# 集群模式配置示例

NETWORK:
  bind:
    - "10.0.1.46（示例IP，请替换为实际IP）"  # 集群节点IP
  port: 6359

GENERAL:
  daemonize: yes

CLUSTER:
  cluster-enabled: yes  # 启用集群模式
  cluster-config-file: "nodes.conf"  # 集群配置文件

SECURITY:
  requirepass: "cluster_password"  # 集群密码
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# Web管控台安装

# 安装包介绍

  • 安装包：AMDC-Console-【版本】-【日期】-【硬件架构】.tar.gz

# 安装步骤

安装步骤如下：

  1. 上传AMDC控制台安装包至目标服务器的安装目录下（如：/opt目录下）
  2. 解压安装包：tar -zxf AMDC-Console-【版本】-【日期】-【硬件架构】.tar.gz
  3. 进入解压后的文件夹：cd amdc-console
  4. 执行启动命令（后台启动）：nohup ./amdc-console > nohup.out 2>&1 &
  5. 启动完成后即可通过浏览器访问AMDC控制台：http://ip:port（其中 ip 表示部署AMDC控制台服务器的IP，port 为控制台端口），如：192.168.x.x:9001（示例IP，请替换为实际IP）

# 验证安装

打开浏览器，访问 http://ip:port（如：http://192.168.x.x:9001），若能正常加载AMDC管控台登录页面，即表示Web管控台安装成功。

# 停止Web管控台

停止AMDC Web控制台的服务，需要强制结束AMDC控制台服务进程。

步骤：

  1. 通过查看端口进程命令找到控制台进程PID：netstat -nltp | grep 9001 或者 netstat -nltp | grep amdc-console
  2. 执行kill -9命令，强制杀死进程：kill -9 进程ID
编辑页面 (opens new window)
#快速开始

← 快速使用手册→