gpstart

启动一个Greenplum数据库系统。

概要

gpstart [-d master_data_directory] [-B parallel_processes] [-R]
                [-m] [-y] [-a] [-t timeout_seconds] [-l logfile_directory] 
                [--skip-heap-checksum-validation]
                [-v | -q]
                gpstart -? | -h | --help 
                gpstart --version

描述

gpstart工具用于启动Greenplum数据库服务器进程。当用户启动一个Greenplum 数据库系统时，用户实际上是同时启动了几个postgres数据库服务器监听器进程 （Master和所有的Segment实例）。gpstart工具处理各个实例的启动。每个实例 都是并行启动的。

管理员第一次运行gpstart时，该工具将在用户的主目录中创建一个名为 .gphostcache的主缓存文件。随后，该工具使用此主机列表更有效地启动系统。 如果将新主机添加到系统中，则必须手动从gpadmin用户的主目录中删除此文件。 该工具将在下次启动时创建一个新的主机缓存文件。

作为启动过程的一部分，该工具会检查堆表checksum设置是否在集群上启用。如果堆表checksum启用情况 在各个实例之间不同，Greenplum数据库不会启动，会返回一个错误信息。该验证选项可以通过指定选项 --skip-heap-checksum-validation来停用。更多关于堆表checksum的情况， 请见Greenplum数据库管理员指南中的启用高可用和数据一致性特性部分。

Note: 在启动Greenplum数据库系统之前，用户必须首先使用gpinitsystem初始化系统。 堆表checksum特性在系统初始化时配置启用和禁用，系统初始化后不能修改。

选项

-a

不要提示用户确认。

-B parallel_processes

并行启动的Segment数。如果未指定，则该工具将启动最多64个并行进程，具体取决于需要启动 多少个Segment实例。

-d master_data_directory

可选。Master主机的数据目录。如果未指定，则使用为$MASTER_DATA_DIRECTORY 设置的值。

-l logfile_directory

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

-m

可选。仅启动Master实例，这可能对维护任务有用。该模式只允许连接到utility 模式下的Master。例如：

PGOPTIONS='-c gp_session_role=utility' psql

此模式下不检查Master和Segment实例的堆表checksum设置一致性。

-q

以静默模式运行。命令输出不显示在屏幕上，但仍然写入日志文件。

-R

以受限模式启动Greenplum数据库（只允许数据库超级用户连接）。

--skip-heap-checksum-validation

启动时指定该选项，该工具不检查Master和Segment之间的堆表checksum一致性。 默认情况下该设置在所有实例上是一样的，或者启用或者禁用。

Warning: 不进行该项验证启动Greenplum数据库会导致数据丢失。 只有在必须要忽略堆表checksum验证错误以恢复数据或进行错误调试时，才能 使用该选项。

-t timeout_seconds

指定等待Segment实例启动的超时时间（秒）。如果某个Segment实例异常关闭 （例如由于电源故障或终止其postgres数据库监听器进程）， 由于数据库恢复和验证过程，启动可能需要较长的时间。如果未指定，则默认超时 时间为60秒。

-v

显示工具输出的详细状态，进度和错误消息。

-y

可选。不启动后备Master主机。默认是启动后备Master主机和同步过程。

-? | -h | —help

显示在线帮助。

--version

显示工具的版本。

示例

启动Greenplum数据库系统：

gpstart

以受限模式启动Greenplum数据库系统（仅允许超级用户连接）：

gpstart -R

仅启动Greenplum主实例并以utility模式连接：

gpstart -m PGOPTIONS='-c gp_session_role=utility' psql

另见

gpstop、gpinitsystem