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 添加流程。

  1. 收集机器信息和已部署数据库的部分信息。

    $ mxinitstandby init --host <standby_hostname> > /tmp/mxinitstandby.init

    注意!
    请将 <host> 替换为对应的主机名。

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

    $ mxinitstandby plan --init-file /tmp/mxinitstandby.init > /tmp/mxinitstandby.plan
  3. 执行部署。

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

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

另见:mxaddmirrorsmxdeletesystem