gs_ctl

-D, --pgdata=DATADIR

指定数据目录的位置。若指定目录中包含配置文件postgresql.conf，且配置文件内data_directory值与-D指定目录不同，将优先按data_directory目录执行。

DATADIR的取值必须为有效的数据目录。

-s, --silent

对reload，restart，stop命令仅打印部分提示信息，对其他命令不生效。

打印信息如“gstl stopped ,xxx”等信息。不打印如“waiting for server to shut down，server stopped”等提示信息。

-

-t, --timeout=SECS

这个参数同时控制如下两个功能：

等待数据库启动或者关闭完成的最大秒数。

取值范围：整型（秒）。

默认值：

等待数据库启动或者停止完成：60秒。

-V , --version

打印gs_ctl的版本信息然后退出。

-

-w

用户执行启动或者关闭数据库的操作后，会等待事务操作的完成后再执行。

默认值：省略此参数时，默认会等待事务操作完成。

-W

用户执行启动或者关闭数据库的操作后，会强制完成启动或者关闭，不等待事务操作完成。

-

-M

-M后面需要跟SERVERMODE参数，表示在启动时指定数据库的启动模式。

SERVERMODE的取值范围：

• primary：本端以主机模式启动。
• standby：本端以备机模式启动。
• pending：本端处于等待状态，等待提升为主机或者备机。

-T

-T 后面跟term，升主命令时会用此term作为主机term，build时会连接大于等于此term的主机进行build。

term的取值范围，无符号整型。

-q

build完成后不自动启动，需要调用者启动。

-

-d

打印更多的debug信息。

-

-L

查询lsn:XX/XX有效性并显示max_lsn。

-

-P PASSWORD

与-U参数配合使用，指定连接本地数据库的用户密码。

-

-U USERNAME

指定连接数据库的用户。此参数只能与notify、query和querybuild参数配合使用。

对于域用户，使用DOMAIN\username格式。

取值范围：openGauss中存在的用户。

默认值：省略此参数则使用与当前操作系统用户同名的用户。

-?, -h, --help

显示关于gs_ctl命令行参数的帮助信息。

-

-c, --core-file

允许gaussdb进程产生内核文件。

-

-l, --log=FILENAME

把服务器日志输出附加在FILENAME文件上。

FILENAME的取值为启动数据库服务的用户有权限的文件。

例如，data目录下的某文件。

-o OPTIONS

声明要直接传递给由openGauss执行的gaussdb的命令行选项。

参数通常都用单或者双引号包围以保证它们作为一个整体传递。

gaussdb支持的参数。

-p PATH-TO-POSTGRES

声明gaussdb可执行文件的位置。

缺省位于gs_ctl自身所在目录，一般不需要此选项。

-m, --mode=MODE

声明关闭模式。

mode的取值：

• fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被关闭。
• immediate：强行关闭，在下次重新启动的时候将导致故障恢复。

默认值：fast

-f

不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被切换，且不做checkpoint。

无参数

-m SWITCHOVER-MODE

声明双机主备实例正常时切换的切换模式。

mode的取值：

• smart：等待所有客户端中断连接后才切换。如果服务器处于紧迫等待，一旦所有的客户断开连接，恢复和复制流将会中断。

  备注：由于在集群环境中，集群管理连接、客户业务连接会导致smart模式几乎很难执行成功，因此在本版本中，该模式已经被废弃。

• fast：不等待客户端中断连接，所有活跃事务都被回滚并且客户端都被强制断开，然后服务器将被切换。

默认值：fast

-b, --mode=MODE

指定重建DN备机的模式。

mode的取值：

• full：通过全量镜像的方式重新同步DN主机的数据目录。
• incremental：通过解析Xlog日志获取主备DN差异的数据进行增量修复备DN。
  警告：

  • 增量重建适用于主备双主等因日志造成的不一致场景。
  • 备机数据文件损坏、数据目录丢失等故障通过增量重建的方式无法修复，此时可通过全量重建的方式重新修复备机。
• auto(不指定)：先增量，根据失败后是否可以再增量选择继续增量或者全量，三次增量失败后进行全量。
• standby_full：使用备机重建备机或容灾场景下的首备重建灾备数据库实例内故障的备机
• copy_secure_files：在流式容灾场景下，获取指定节点数据目录下gs_secure_files目录对应内容。
• copy_upgrade_file：在dorado容灾场景下，获取指定节点下升级所需指定文件。
• cross_cluster_full：基于共享存储的同城双中心场景下的跨集群全量build
• cross_cluster_incremental：基于共享存储的同城双中心场景下的跨集群增量build

默认值：auto

-r, --recvtimeout=INTERVAL

指定重建过程中备机日志接收等待主机响应的超时时间。

取值范围：整型（秒）。

默认值：120秒

-d

打印更多build过程信息。

-

-C CONNECTOR

到源端DN的连接串，通过连接源端DN进行本节点上DN的重建。只支持备机到备机的连接。

连接串包含本节点待重建DN的IP和端口和源端DN的IP和端口，格式如下：

'localhost=Local DN IP localport=Local DN Port+1 remotehost=DN IP remoteport=DN Port+1'

-Q

指定xlog日志拷贝方向。

• copy_from_local：从本地往共享存储上拷贝。
• copy_from_share：从共享存储往本地存储上拷贝。
• force_copy_from_local：强制从本地往共享存储上拷贝。

-I

用于指定需要获取调用栈的线程的lwtid。

正整数。