mxinitstandby

本文档介绍了备用节点(Standby)添加和删除工具 mxinitstandby。

注意!
mxinitstandby 需要在主节点(Master)拥有 sudo 权限的用户上(除 mxadmin 外,需使用绝对路径 /opt/ymatrix/matrixdb6/bin/mxinitstandby)执行。

1 描述

为 YMatrix 数据库系统初始化、初始化或移除 Standby 节点。

2 命令行参数信息

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

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

3 使用流程示例

3.1 添加或初始化

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

我们在此给出 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

    注意!
    如误在无 sudo 权限的用户上执行了 mxinitstandby init 命令,则会在该用户下生成 mxinitstandby.init 文件,其他用户只可读不可写。需要删除该生成文件,再在拥有 sudo 权限的用户上重新执行命令,以重新生成文件。

3.2 删除或移除

注意!
你需执行以下完整的 Standby 删除流程。

我们在此给出 Standby 节点删除流程示例,具体如下:

  1. 收集删除信息和已部署数据库的部分信息.
    $ mxinitstandby -r init > /tmp/mxinitstandby_remove.init
  2. 根据收集的信息生成删除计划,即具体删除步骤.
    $ mxinitstandby -r plan --init-file /tmp/mxinitstandby_remove.init > /tmp/mxinitstandby_remove.plan
  3. 执行删除.
    $ mxinitstandby -r setup --plan-file /tmp/mxinitstandby_remove.plan 

    注意!
    删除 Standby 节点会自动清理相关配置和数据文件。
    删除操作会停止 Standby 节点服务并从集群配置中移除该节点。


注意!
YMatrix 5.X 开始部署了全新的数据库架构,启用 mxinitstandby 工具来管理 Standby,与 gpinitstandby 不兼容。之前版本可使用 gpinitstandby 工具进行。

另见:mxaddmirrorsmxdeletesystem