暂无图片
暂无图片
1
暂无图片
暂无图片
暂无图片

华为GaussDB T 单机管理工具zctl.py

原创 章芋文 2019-10-03
1086

zctl.py必须在安装数据库用户运行。

zctl.py日志生成在每个实例log目录,文件名格式为zctl-YYYY-MM-DD_xxxxxx.log,其中YYYY为年份,MM为月份,DD为日期,xxxxxx为随机生成的六位数字。例如:zctl-2018-10-01_055246.log。

zctl.py日志支持转储,每个日志文件最大为10M,最大支持10个文件。

zctl.py日志会记录用户登录名和主机信息,如果zctl.py日志中用户名或主机信息为NULL,请排查用户登录是否为非SSH方式(如VNC或其它登录方式),或者排查执行zctl.py的方式。

语法格式

显示帮助页面

python zctl.py --help

查看数据库版本信息

python zctl.py -v

启动数据库

python zctl.py -t start [-D DATADIR]  [-m START-MODE]

停止数据库

python zctl.py -t stop [-D DATADIR]  [-m SHUTDOWN-MODE] [-P]

强制停止数据库

python zctl.py -t kill [-D DATADIR]

查看数据库状态

python zctl.py -t status [-D DATADIR] [-P]

数据库主备切换

python zctl.py -t switchover [-D DATADIR] [-P]

备数据库升为主数据库

python zctl.py -t failover [-D DATADIR] [-P]

重建数据库基线

python zctl.py -t build [-D DATADIR]  [-m BUILD-MODE] [-c] [-a ALGORITHM] [-l LEVEL] [-P]

主数据库降为备数据库

python zctl.py -t demote [-D DATADIR]  [-m DEMOTE-MODE] [-P]

 

参数说明

参数

说明

--help

显示帮助页面。

-v

查看数据库版本。

-t

指定zctl.py的工作方式:start(启)、stop(停)、status(查看状态)、switchover(主备角色倒换)、failover(备机升主)、build(重建基线)、demote(主机降备)、kill(强制停止)。

在线修改端口或地址,会导致停机失败,因此不建议在线修改当前的连接信息。如果在连接异常或者连接信息被在线修改情况下,可使用kill方式停止特定数据目录的实例。

-m

启停数据库模式、重建数据库基线模式、主数据库降为备数据库的模式。

启动数据库时,模式可以是nomount、mount、open,不输入-m,默认是open模式。

停止数据库时,模式可以是immediate、abort、normal,不输入-m,默认是normal模式。

重建数据库基线时,模式可以是standby、cascaded。standby:重建为备机;cascaded:重建为级联备机。不输入-m,由连接的对端数据库决定,对端是备机,则重建为级联备;对端是主机,则重建为备机。

主数据库降为备数据库时,模式可以是standby、cascaded。standby:主机降级为备机;cascaded:主机或者备机降级为级联备机。不输入-m,默认是降级为备机。

-c

build时指定压缩。该选项只对build有效。

-a

build进行压缩时,指定压缩算法。当前支持ZSTD、ZLIB和LZ4,默认是ZSTD。

-l

build进行压缩时,指定压缩级别。有效取值范围[1,9],默认值是1。

-D

指定单机数据文件路径,即GSDB_DATA路径。

-P

指定工具通过用户名和密码连接数据库。命令行执行过程中,会提示输入连接数据库的用户名和密码,用户名是SYS,密码是SYS用户的出厂密码Changeme_123。

该参数可缺省,若缺省,则通过免密登录连接数据库。

命令

应用场景

switchover

在备机上执行,主备都正常运行时进行角色倒换。

failover

在备机上执行,当主机出现异常后,选择某一个备机升主。

build

在备机上执行,当备机的状态是need repair时执行此命令以重建基线。

在主机上执行,将该主机降备,使用新主机重建基线。

如果在主机上执行,请确保该主机及能够连接上新主机,否则重建失败且数据无法恢复。

demote

在主机上执行,典型应用如下:主机A故障后,选择一个备机failover升主,然后将原主机A降备。

「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论