mxinitstandby

本文档介绍了主节点（Master）备用节点实例添加工具 mxinitstandby。

1 描述

为 YMatrix 数据库系统添加或初始化 Standby。

2 命令行参数信息

以下是详细的命令行参数信息介绍：

子命令	参数名	描述	可选
init		将收集到的信息转换为一份基本计划
	--db-cluster-id	数据库集群 ID。用以标识唯一的数据库集群	可选
	--host	添加 Standby 的主机	必选
	--port	从当前端口开始搜索一个空闲端口作为 Standby 监听的端口，默认从 `5432` 开始寻找	可选
plan		生成部署计划
	--init-file	`init` 命令输出的信息重定向文件的绝对路径	必选
setup		执行部署
	--plan-file	`plan` 命令输出的信息重定向文件的绝对路径	必选

3 使用流程示例

mxinitstandby 需要在主节点（Master）拥有 sudo 权限的用户上(除 mxadmin 外，需使用绝对路径 /opt/ymatrix/matrixdb5/bin/mxinitstandby)执行。如误在无 sudo 权限的用户上执行了 mxinitstandby init 命令，则会在该用户下生成 mxinitstandby.init 文件，其他用户只可读不可写。需要删除该生成文件，再在拥有 sudo 权限的用户上重新执行命令，以重新生成文件。
我们在此给出流程示例。具体如下：

注意！
你需执行以下完整的 Standby 添加流程。

收集机器信息和已部署数据库的部分信息。
```
$ mxinitstandby init --host <standby_hostname> > /tmp/mxinitstandby.init
```
注意！
请将 <host> 替换为对应的主机名。

根据收集的信息生成部署计划，即具体部署步骤。

$ mxinitstandby plan --init-file /tmp/mxinitstandby.init > /tmp/mxinitstandby.plan

执行部署。

$ mxinitstandby setup --plan-file /tmp/mxinitstandby.plan --mode cli

注意！ YMatrix 5 部署了全新的数据库架构，启用 mxinitstandby 工具来添加 Standby，与 gpinitstandby 不兼容。之前版本可使用 gpinitstandby 工具。

mxinitstandby

1 描述

2 命令行参数信息

3 使用流程示例

另见：mxaddmirrors，mxdeletesystem。