Greenplum 实用工具-gpinitstandby

注：本文翻译自https://docs.vmware.com/en/VMware-Greenplum/7/greenplum-database/utility_guide-ref-gpinitstandby.html

gpinitstandby工具用于为Greenplum Database系统添加和/或初始化备用协调器主机。

语法

gpinitstandby { -s <standby_hostname> [-P port] | -r | -n } [-a] [-q] 
    [-D] [-S <standby_data_directory>] [-l <logfile_directory>] 
    [--hba-hostnames <boolean>] 

gpinitstandby -v 

gpinitstandby -?

描述

gpinitstandby实用程序将一个备用协调器实例添加到Greenplum数据库系统中。如果您的系统配置了一个现有的备用协调器实例，请在添加新的备用协调器实例之前使用-r选项删除它。

在运行此实用程序之前，请确保在备用协调器主机上安装了Greenplum Database软件，并且已在主机之间交换了SSH密钥。建议将协调器端口号与备用协调器端口号设置为一致。

这个实用程序应该在当前活动的主协调器主机上运行。请参阅Greenplum数据库安装指南。

该实用程序执行以下步骤:

1. 更新Greenplum Database系统编目，以删除现有的备用协调器信息(如果提供了-r选项)
2. 更新Greenplum Database系统编目，以添加新的备用协调器实例信息
3. 编辑Greenplum数据库协调器的pg_hba.conf文件，以允许来自新添加的备用协调器的访问
4. 在备用协调器主机上设置备用协调器实例
5. 启动同步进程

备用协调器实例在主协调器无法运行时充当“热备用”。备用协调器由事务日志复制进程(walsender和walreceiver)保持最新状态，它们运行在主协调器和备用协调器主机上，并保持主和备用协调器实例之间的数据同步。如果主协调器发生故障，则关闭日志复制进程，并且可以通过使用gpactivatstandby实用程序激活备用协调器。激活备用协调器后，复制的日志用于重建协调器实例在最后一次成功提交事务时的状态。

激活的备用协调器有效地成为Greenplum Database协调器，在协调器端口上接受客户端连接，并执行正常的协调器操作，如SQL命令处理和资源管理。

如果初始化失败，则在备主机目录/tmp下生成汇总报告文件。报告文件列出了备用主机上需要清理的目录。

注：如果gpinitstandby实用程序先前无法初始化备用协调器，则必须在再次运行gpinitstandby之前删除备用协调器数据目录中的文件。初始化失败后，备用协调器数据目录不会被清理，因为它包含可以帮助确定失败原因的日志文件。

选项

-a(不提示)
不提示用户确认。

-d(调试)
将日志级别设置为debug。

–hba-hostnames boolean
可选的。控制此实用程序在使用可以连接到Greenplum Database的地址更新此文件时，是否使用pg_hba.conf文件中的IP地址或主机名。当设置为0(默认值)时，此实用程序在更新此文件时使用IP地址。当设置为1时，此实用程序在更新此文件时使用主机名。为了保持一致性，请使用初始化Greenplum Database系统时为hba_hostname指定的相同值。有关Greenplum Database如何在pg_hba.conf文件中解析主机名的信息，请参见配置客户端身份验证。

-l logfile_directory
写入日志文件的目录。默认为~/gpAdminLogs。

-n(重启备用协调器)
指定此选项以启动已配置但由于某种原因已停止的Greenplum Database备用协调器。

-p port
该选项指定Greenplum Database备用协调器使用的端口。默认端口与活动Greenplum Database协调器使用的端口相同。
如果Greenplum Database备用协调器与主协调器在同一主机上，则端口必须不同。如果活动协调器和备用协调器的端口相同，并且主机相同，则实用程序返回错误。

-q(无屏幕输出)
在安静模式下运行。命令输出信息不显示在屏幕上，但仍被写入日志文件。

-r(删除备用协调器)
从Greenplum Database系统中删除当前配置的备用协调器实例。

-s standby_hostname
备用协调器主机的主机名。

-S standby_data_directory
要用于新备用协调器的数据目录。默认是活动协调器使用的同一目录。
如果备用协调器与活动协调器位于同一主机上，则必须使用此选项指定不同的目录。

-v(显示实用程序版本)
显示此实用程序的版本、状态、上次更新日期和校验和。

-?(帮助)
显示联机帮助。

举例

添加一个备用协调器实例到你的Greenplum数据库系统，并启动同步进程:

gpinitstandby -s host09

启动一个现有的备用协调器实例，并与当前的主协调器实例同步数据:

gpinitstandby -n

添加一个备用协调器实例到您的Greenplum数据库系统，指定一个不同的端口:

gpinitstandby -s myhost -P 2222

如果指定与活动Greenplum Database协调器相同的主机名，还必须使用-P选项指定不同的端口号，并使用-S选项指定备用数据目录。
从您的Greenplum系统配置中删除现有的备用协调器:

gpinitstandby -r