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命令处理和负载管理。
Important: 如果gpinitstandby工具之前初始化后备Master失败, 则必须显示删除后备Master数据目录中的文件,然后再次运行gpinitstandby。 后备Master数据目录在初始化失败后不会被清理,因为它包含可帮助确定失败原因的日志文件。
如果发生初始化失败,则会在后备主机目录/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
Note: 不要在同一命令指定-n和-s选项。
指定一个不同的端口向Greenplum数据库系统添加一台后备Master主机:
gpinitstandby -s myhost -P 2222
如果指定的主机名与Greenplum数据库的活动Master相同,则用作后备Master的Greenplum数据库软件必须 用-P参数指定 与Greenplum数据库的活动Master的软件位于不同位置。 另外,后备Master使用的文件空间位置必须与 Greenplum数据库的活动Master不同。
从Greenplum系统配置中删除现有的后备Master:
gpinitstandby -r