MarkLogic集群向另一主机添加forest副本及管理控制台配置问题咨询

为已存在的Forest添加副本的REST API操作 #

可以使用/manage/v2/forests/{id|name}/properties PUT接口完成已有forest的副本添加操作，具体请求语法如下：

curl --anyauth --user admin:admin -X PUT \
-d '{"forest-replicas": {"forest-replica":[{"replica-name": "Documents-R", "host": "host-3.marklogic.com"}]}}' \
-i -H "Content-type: application/json" \
http://localhost:8002/manage/v2/forests/[你的目标Forest名称]/properties

注意事项 #

• 副本所在主机必须和源Forest所属主机处于同一集群
• 副本名称不能和集群内已有Forest重名
• 可在forest-replica数组中添加多个对象，一次性为同一个Forest创建多个副本
• 操作完成后可发送GET请求到同一地址，验证副本配置是否生效

管理控制台副本配置区域为空的解决方法 #

该问题通常是前置配置不满足导致的，按照以下顺序排查即可：

• 首先确认你的集群至少包含2台在线主机，单节点集群不支持Forest副本功能，对应配置区域默认隐藏
• 确认你登录管理控制台的账号持有admin或forest-admin角色权限，权限不足时会隐藏高阶配置项
• 进入集群全局配置页，确认故障转移功能未被禁用，Forest副本依赖故障转移框架实现
• 确认你要操作的不是系统内置的受保护Forest（如Security、Schemas数据库的默认Forest），这类Forest默认不允许自定义副本配置

以上配置都符合要求后，副本配置区域会正常显示，你可以直接在页面对副本进行增删管理，无需调用API。

内容的提问来源于stack exchange，提问作者Tim Meagher