gpstart

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

另见

gpstopgpinitsystem