gpinitstandby
gpinitstandby
为Greenplum数据库系统添加或初始化后备Master主机。
概要
gpinitstandby { -s standby_hostname [-P port] | -r | -n } [-a] [-q]
[-D] [-S standby_data_directory] [-l logfile_directory]
gpinitstandby -v
gpinitstandby -?
描述
gpinitstandby工具为用户的Greenplum数据库系统添加一个备份的后备Master主机。 如果用户的系统已经配置了后备Master主机，请在添加新的后备Master主机之前使用-r 选项将其删除。
在运行此工具之前，请确保Greenplum数据库软件已安装在后备Master主机上，并且用户已在主机之间交换了 SSH密钥。推荐在Master主机和后备Master主机上将主端口设置为相同的端口号。
此工具应该在当前活动的主Master主机上运行。方法请参见Greenplum数据库安装指南。
该工具执行以下的步骤：
- 更新该Greenplum数据库系统目录来删除现有的后备Master主机信息 （如果指定了-r）
- 更新该Greenplum数据库系统 目录来添加新的后备Master主机信息
- 编辑Greenplum数据库Master的pg_hba.conf 来允许从新添加的后备Master主机进行访问。
- 在后补Master主机上设置后备Master实例。
- 开始同步进程。
如果主Master主机变为不可操作，后备Master主机将作为“热备用”。后备Master通过事务日志 复制进程（walsender和walreceiver）保持最新 状态，这些进程在主Master主机和后备Master主机上运行，并使两者的数据保持同步。如果主 Master失效，日志复制过程将关闭，后备Master可以使用gpactivatestandby 工具在其位置激活。一旦后备Master激活，复制日志将用于重建最后一次成功提交事务时Master 主机的状态。
激活的后备Master实际上成为Greenplum数据库的Master，在主端口上接受客户端连接并执行正常的 Master操作，例如SQL命令处理和负载管理。
如果发生初始化失败，则会在后备主机目录/tmp中生成摘要报告文件。 该报告列出了后备主机上需要清理的目录。
选项
- -a（不提示）
- 不要提示用户确认。
- -D（调试）
- 设置日志级别为debug。
- -l logfile_directory
- 写入日志的目录，默认为~/gpAdminLogs。
- -n（重启被主机）
- 指定此选项以启动已配置但由于某种原因已停止的Greenplum数据库的后备Master。
- -P port
- 此选项指定Greenplum数据库的后备Master使用的端口。默认值是Greenplum数据库的活动 Master使用的端口。
- 如果Greenplum数据库的后备Master和活动Master在同一台主机上，则端口必须不同。 如果活动Master和后备Master的端口相同，并且所在的主机也相同，则该工具将返回错误。
- -q（无屏幕输出）
- 以静默模式运行。命令输出不显示在屏幕上，但是仍然写入日志文件。
- -r（移除后备Master）
- 从Greenplum数据库系统中删除当前已配置的后备Master。
- -s standby_hostname
- 后备Master的主机名。
- -S standby_data_directory
- 新备用Master主机使用的数据目录。默认为和活动Master相同的路径。
- 如果备用Master和活动Master在同一台主机上，必须使用该选项定义一个不同的路径。
- -v（显示工具版本）
- 显示该工具的版本、状态、上次更新的日期和校验和。
- -?（帮助）
- 显示在线帮助。
示例
添加一个后备Master到用户的Greenplum数据库系统，并重启同步进程：
gpinitstandby -s host09
开启一个存在的后备Master主机，并且和当前的主Master主机同步：
gpinitstandby -n
指定一个不同的端口向Greenplum数据库系统添加一台后备Master主机：
gpinitstandby -s myhost -P 2222
如果指定的主机名与Greenplum数据库的活动Master相同，则用作后备Master的Greenplum数据库软件必须 用-P参数指定 与Greenplum数据库的活动Master的软件位于不同位置。 另外，后备Master使用的文件空间位置必须与 Greenplum数据库的活动Master不同。
从Greenplum系统配置中删除现有的后备Master：
gpinitstandby -r