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](gpstop.html#topic1)
、[gpinitsystem](gpinitsystem.html#topic1)