# gds_ctl #### 背景信息 gds_ctl是一个批量控制GDS启停的脚本工具，一次执行可以在多个节点上启动/停止相同端口的GDS服务进程，并在启动时为每一个进程设置看护程序，用于看护GDS进程。 #### 注意事项 - 执行脚本前需切换到GDS用户，必须在普通用户下执行脚本gds_ctl。 - 脚本需要在Python 3环境下运行。 - gds_ctl继承了GDS主要命令行参数，除-p以及-h外，其他参数意义不变。在gds_ctl中，-p只需指定端口即可。 - 使用gds_ctl批量操作的节点必须是此前使用gds_install安装部署的节点。 #### 语法 - 启动命令 ``` gds_ctl start --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT -d DATADIR -H ALLOW_IPs [gds other original options] ``` - 停止命令 ``` gds_ctl stop --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT ``` - 重启命令 ``` gds_ctl restart --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT ``` #### 参数说明 - --host 待运行GDS节点的IP列表，支持文件和字符串两种形式： - 文件形式：每一行一个IP地址，如： 192.168.2.200 192.168.2.201 - 字符串形式：半角逗号分隔，如： 192.168.2.200,192.168.2.201 - -p 监听端口。 取值范围：1024\~65535，正整数。 默认值：8098 - --help 显示帮助信息。 - -V 显示版本信息。 #### 兼容GDS原参数 - -d dir 设置待导入数据文件的目录。在GDS进程权限允许的条件下，-d指定的目录会自动被创建。 - -l log_file 设置日志文件。 与-R参数一起使用，可支持日志自动切分。当设置-R参数后，GDS会根据设置的值重新生成新的文件，以此来避免单个日志文件过大。 生成规则：GDS默认只识别后缀是log的文件重新生成日志文件。 例如，当-l参数指定为 gds.log，-R指定为20MB时，当gds.log达到20MB后就会新创建一个 "gds-2020-01-17_115425.log"文件。 当-l指定的日志文件没有以log为后缀，例如：" gds.log.txt"， 则新创建的日志文件名为" gds.log-2020-01-19_122739.txt"。 GDS启动时会检测-l参数设置的日志文件是否存在，如果存在则根据当前日期时间新生成一个日志文件，不会覆盖之前的日志文件。 - -H address_string 设置允许哪些主机连接到GDS，参数需为CIDR格式，仅支持Linux系统。需要配置多个不同网段时，使用","分隔。例如：-H 10.10.0.0/24,10.10.5.0/24。 - -e dir 设置导入时产生的错误日志存放路径。 默认值：数据文件目录。 - -E size 设置导入产生的错误日志的上限值。 取值范围：0\