通信矩阵
| 原设备 | 源IP地址 | 源端口 | 目的设备 | 目的IP地址 | 目的端口（侦听） | 协议 | 端口说明 | 侦听端口是否可更改 | 认证方式 |
|---|---|---|---|---|---|---|---|---|---|
| Local/Client客户端 | 客户端通信IP地址 | 随机端口（由操作系统自动分配） | meta service | meta_service_url中的<ip> | meta_service_url中的<port> , 默认值5000, 可配范围[1025, 65535] | TCP | 用于元数据对象管理 | 是 | TLS |
| memory fabric实例 | 客户端通信IP地址 | 随机端口（由操作系统自动分配） | memory fabric实例 | config_store_url中的<ip> | config_store_url中的<port> , 默认值6000, 可配范围[1025, 65535] | TCP | 用于memory fabric中BM信息交换同步 | 是 | TLS |
| 参与hcom通信的实例 | 客户端通信IP地址 | 随机端口（由操作系统自动分配） | 参与hcom通信的实例 | hcom_url中的<ip> | hcom_url中的<port> , 默认值7000, 可配范围[1024, 65535] | TCP/RDMA/SDMA | 用于hcom通信 | 是 | TLS |
说明：
支持通过配置文件配置TLS私钥、证书、口令等，进行TLS安全连接。
建议用户开启TLS配置开关，并使用加密的方式保存私钥，保证通信安全。
系统启动后，建议删除本地秘钥证书等信息敏感文件。
支持通过环境变量 ACCLINK_CHECK_PERIOD_HOURS和ACCLINK_CERT_CHECK_AHEAD_DAYS 配置证书检查周期与证书过期预警时间。
多local_service场景不同local_service之间会使用配置文件中的HCOM端口+local_rank作为实际使用的端口。
| 环境变量 | 说明 |
|---|---|
| ACCLINK_CHECK_PERIOD_HOURS | 指定证书检查周期（单位：小时），超出范围 [ 24, 24 * 30 ] 或不是整数，则设置默认值7 * 24 |
| ACCLINK_CERT_CHECK_AHEAD_DAYS | 指定证书预警时间（单位：天），超出范围 [ 7, 180 ] 或不是整数或换算成小时小于检查周期，则设置默认值30 |
运行用户建议
- 基于安全性考虑，建议您在执行任何命令时，不建议使用root等管理员类型账户执行，遵循权限最小化原则。
文件权限最大值建议
- 建议用户在主机（包括宿主机）及容器中设置运行系统umask值为0027及以上，保障新增文件夹默认最高权限为750，新增文件默认最高权限为640。
- 建议对使用当前项目已有和产生的文件、数据、目录，设置如下建议权限。
| 类型 | Linux权限参考最大值 |
|---|---|
| 用户主目录 | 750（rwxr-x---） |
| 程序文件(含脚本文件、库文件等) | 550（r-xr-x---） |
| 程序文件目录 | 550（r-xr-x---） |
| 配置文件 | 640（rw-r-----） |
| 配置文件目录 | 750（rwxr-x---） |
| 日志文件(记录完毕或者已经归档) | 440（r--r-----） |
| 日志文件(正在记录) | 640（rw-r-----） |
| 日志文件目录 | 750（rwxr-x---） |
| Debug文件 | 640（rw-r-----） |
| Debug文件目录 | 750（rwxr-x---） |
| 临时文件目录 | 750（rwxr-x---） |
| 维护升级文件目录 | 770（rwxrwx---） |
| 业务数据文件 | 640（rw-r-----） |
| 业务数据文件目录 | 750（rwxr-x---） |
| 密钥组件、私钥、证书、密文文件目录 | 700（rwx—----） |
| 密钥组件、私钥、证书、加密密文 | 600（rw-------） |
| 加解密接口、加解密脚本 | 500（r-x------） |
调用acc_links接口列表
TCP服务端模块
| 接口功能描述 | 接口声明 |
|---|---|
| 创建TCP服务端 | static AccTcpServerPtr Create(); |
| 启动服务端 | int32_t Start(const AccTcpServerOptions &opt); |
| TLS认证方式启动服务端 | int32_t Start(const AccTcpServerOptions &opt, const AccTlsOption &tlsOption); |
| 停止服务端 | void Stop(); |
| 连接其余服务端 | int32_t ConnectToPeerServer(const std::string &peerIp, uint16_t port, const AccConnReq &req, uint32_t maxRetryTimes, AccTcpLinkComplexPtr &newLink); |
| 注册处理新请求事件函数 | void RegisterNewRequestHandler(int16_t msgType, const AccNewReqHandler &h); |
| 注册处理断链事件函数 | void RegisterLinkBrokenHandler(const AccLinkBrokenHandler &h); |
| 注册处理新链接事件函数 | void RegisterNewLinkHandler(const AccNewLinkHandler &h); |
| 注册密码解密的函数 | void RegisterDecryptHandler(const AccDecryptHandler &h); |
| 加载安全认证所需动态库 | int32_t LoadDynamicLib(const std::string &dynLibPath); |
依赖软件声明
当前项目运行依赖 CANN 和 Ascend HDK，安装使用及注意事项参考CANN 和Ascend HDK并选择对应版本。
源码内公网地址
| 类型 | 开源代码地址 | 文件名 | 公网IP地址/公网URL地址/域名/邮箱地址 | 用途说明 |
|---|---|---|---|---|
| 依赖三方库 | https://github.com/google/googletest.git | .gitmodules | https://github.com/google/googletest.git | 单元测试框架依赖 |
| 依赖三方库 | https://github.com/sinojelly/mockcpp.git | .gitmodules | https://github.com/sinojelly/mockcpp.git | 单元测试框架依赖 |
| 依赖三方库 | https://github.com/gabime/spdlog.git | .gitmodules | https://github.com/gabime/spdlog.git | 日志框架依赖 |
| license 地址 | 不涉及 | LICENSE | http://www.apache.org/licenses/ | license文件 |
| license 地址 | 不涉及 | LICENSE | http://www.apache.org/licenses/LICENSE-2.0 | license文件 |
| 代码仓地址 | https://gitcode.com/Ascend/memcache | setup.py | https://gitcode.com/Ascend/memcache | whl 包仓库地址信息 |
| 代码仓地址 | https://gitcode.com/Ascend/memfabric_hybrid | performance_compare.sh | https://gitcode.com/Ascend/memfabric_hybrid | 工具脚本 |