v2.0
- 关于PTK
- 快速入门
- 使用指南
- 使用参考
- 配置文件示例
- 命令介绍
- ptk
- ptk completion
- ptk view-static-config
- ptk init-cluster
- ptk collect
- ptk rec-guc
- ptk cache
- ptk gen-ptkc
- ptk manage
- ptk demo
- ptk meta
- ptk version
- ptk self
- ptk gen-om-xml
- ptk env
- ptk gen-static-config
- ptk cluster
- ptk cluster createdb
- ptk cluster uninstall-compat-tools
- ptk cluster install-compat-tools
- ptk cluster install-mogila
- ptk cluster rename
- ptk cluster throwout
- ptk cluster takeover
- ptk cluster uninstall-cm
- ptk cluster install-cm
- ptk cluster gen-cert-files
- ptk cluster load-cm-vip
- ptk cluster del-kerberos-auth
- ptk cluster add-kerberos-auth
- ptk cluster uninstall-kerberos-server
- ptk cluster install-kerberos-server
- ptk cluster is-in-upgrade
- ptk cluster upgrade-rollback
- ptk cluster upgrade-commit
- ptk cluster upgrade
- ptk cluster demote
- ptk cluster promote
- ptk cluster refresh
- ptk cluster shell
- ptk cluster modify-comment
- ptk cluster show-config
- ptk cluster set-guc
- ptk cluster show-guc
- ptk cluster set-hba
- ptk cluster show-hba
- ptk cluster scale-out
- ptk cluster scale-in
- ptk cluster uninstall-mogha
- ptk cluster install-mogha
- ptk cluster list-plugins
- ptk cluster install-plugin
- ptk cluster inspect
- ptk cluster failover
- ptk cluster switchover
- ptk cluster build
- ptk cluster status
- ptk cluster restart
- ptk cluster stop
- ptk cluster start
- ptk uninstall
- ptk ls
- ptk install
- ptk exec
- ptk template
- ptk encrypt
- ptk checkos
- ptk download
- ptk candidate
- 故障排查
- FAQ
- 发布记录
- 社区
- 附录:YAML语法
角色管理
对集群内数据库节点的角色进行管理的操作。
目的
为了方便用户对数据库节点的角色进行更灵活的管理,以满足期望。
注意事项
PTK 的角色管理赋予管理人员更灵活的操作,因此可能出现如下的一些情况:
- 角色变更后集群无主情况。
- 角色变更后集群多主情况。
管理人员需保证对这些情况的了解且其符合预期。
提升角色
提升线路:
cascade_standby -> standby -> primary
说明:提升一个数据库节点的角色时,会按提升线路中的正向路径逐步提升角色。
提升角色命令
命令如下:
ptk cluster -n <CLUSTER_NAME> promote [-H|--host HOST] [-i|--id ID]
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
-H|--host | String | 待提升角色的数据库节点所在 IP |
-i|--id | Integer | 待提升角色的数据库节点 ID |
特别说明:若 -H
,-i
均指定值,仅使用 -i
的值执行操作。
降级角色
降级线路:
primary -> standby -> cascade_standby
说明:降级一个数据库节点的角色时,会按降级线路中的正向路径逐步降级角色。
降级角色命令
命令如下:
ptk cluster -n <CLUSTER_NAME> demote [-H|--host HOST] [-i|--id ID] [--upstream UPSTREAM_HOST]
参数说明:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
-H|--host | String | 待降级角色的数据库节点所在 IP |
-i|--id | Integer | 待降级角色的数据库节点 ID |
--upstream | String | 待降级角色的数据库节点降级后,其上游节点的 IP |
特别说明:若 -H
,-i
均指定值,仅使用 -i
的值执行操作。若降级一个 standby
节点时,需指定参数 --upstream
。
QA
为什么会出现无主情况?怎样恢复至有主?
无主原因:对一个集群的主节点进行 demote
操作后,会出现无主情况。
如何恢复:选定一个 standby
节点,进行 promote
操作可将其提升为主。
为什么会出现多主情况?怎样恢复至单主?
多主原因:对一个集群的非主节点进行多次 promote
之后,会出现多主情况。
如何恢复:选定不期望的主节点进行 demote
操作,直至剩余一个主节点时停止操作。
经过角色操作后,会出现一主零备多级联的情况吗?
不会。PTK 对于 standby
节点的提升或降级操作时,均进行了判断,以防止该情况发生。