- 关于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语法
故障排查
错误码 4xxx
PTK-4001
该错误码代表配置文件中对应服务器的用户和用户组配置不能设置为 root，请修改为普通用户即可
PTK-4002
该错误码代表配置文件中使用了不合理的端口号，PTK 对于端口的配置仅接受 [1024, 65534] 区间内的端口号
PTK-4003
该错误码代表错误提示的 IP 为一个无效的 IP 字符串
PTK-4004
该错误码代表在配置文件中，数据目录 (data_dir) 配置的目录不能为应用目录 (app_dir) 的子目录，请修改数据目录即可。
PTK-4005
该错误码代表提示的目录路径是一个相对路径，PTK 的运行是通过远程操作的，相对路径是不可靠的路径配置，所以请将相对路径修改为绝对路径即可
PTK-4006
该错误码代表目录路径中包含非法的字符，请检查配置文件中对应的字段
PTK-4007
该错误码代表配置文件中指定了一个无效的数据库角色，数据库角色需要确保为 primary/standby/cascade_standby 之一
PTK-4008
该错误码代表 PTK 接收到了一个无效的 URL 字符串
PTK-4010
该错误码代表目标系统缺少必要的工具，无法进行系统检查，请在目标系统上安装提示的必要依赖工具即可
PTK-4011
该错误码代表执行的命令缺少了必要的参数，请通过运行命令的参数 --help 来查看使用说明
PTK-4012
该错误码代表指定的集群名称已经被其他集群使用，请修改一个新的集群名称即可
PTK-4013
该错误码代表指定的端口已经被占用，可以通过关闭占用端口的进程或者修改配置使用其他新的端口解决
PTK-4014
该错误码代表在同一个集群中不同的服务器上操作系统的发行版信息不一致，PTK 强烈建议在部署数据库集群时，集群内的所有服务器的操作系统需保持一致
PTK-4015
该错误码代表 PTK 无法识别提示的 CPU 架构
PTK-4017
该错误码代表提示的名称字符串中包含非法的字符，名称在定义时仅允许包含字母、数字、短横线(-)、下划线(_)和点(.)
PTK-4018
该错误码代表集群的名称不能为空
PTK-4019
该错误码代表集群名称是 PTK 的内部保留关键词，请更换为其他名字即可
PTK-4020
该错误码代表安装时配置文件中没有配置任何 db_server
PTK-4021
该错误码代表执行 checkos 命令时指定了无效的检查项编号
PTK-4022
该错误码代表在安装数据库时，指定了跳过检查操作系统发行版，但没有指定安装包的路径，此时 PTK 无法自动判断应该使用何种安装包。所以在安装时的命令中，通过 -p 或 --pkg 指定安装包路径即可
PTK-4023
该错误码代表命令行没有指定配置文件，通过 -f 指定即可
PTK-4024
该错误码代表在配置文件中，数据库实例的上游实例不能设置为自己，需指定另一个实例的 IP
PTK-4025
该错误码代表在配置文件中设置了某个数据库实例的上游实例 IP，但是上游实例的 IP 没有在当前集中找到，这种一般是上游 IP 配置错误导致
PTK-4026
该错误码代表在配置文件中没有找到角色为 primary 的数据库实例
PTK-4027
该错误码代表在配置文件中级联备的上游 IP 设置上了主库的地址，级联备的上游须为备库的 IP
PTK-4028
该错误码代表在配置文件中存在多个角色为 primary 的数据库实例配置，请确保一个集群配置中仅存在一个主库配置
PTK-4029
该错误码代表配置文件中级联备库的上游实例 IP 没有配置，当角色为 cascade_standby 使，上游实例字段 upstream_host 就变为了必填字段
PTK-4030
该错误码代表指定的集群名不存在
PTK-4031
该错误码代表数据库密码长度需为8~16个字符
PTK-4032
该错误码代表交互输入密码的场景时，前后两次输入的密码不一致
PTK-4033
该错误码代表配置文件中数据库实例的个数太多，超过了9个，由于数据库本身的限制，一个集群内实例的数量最多只能为9个
PTK-4034
该错误码代表配置文件中 xlog 的目录不能为数据库目录 (data_dir) 的子目录
PTK-4035
该错误码代表在配置文件中非本机IP的服务器（远程服务器）均必须设置 ssh_option 字段（global 中也没有设置），错误会列出没有配置的服务器列表
PTK-4036
该错误码代表在配置文件中密码类型的字段没有使用 PTK encrypt 加密，出于安全考虑，密码类型的字段不允许明文提交
PTK-4037
该错误码代表在 MogDB 2.1.0 版本之前，并不支持插件的安装（没有发布过对应的插件）
PTK-4038
该错误码代表交互确认场景时，用户选择了取消确认
PTK-4039
该错误码代表在安装 CM 集群时至少需要配置 2 个服务器
PTK-4040
该错误码代表在配置文件中基础目录(base_dir) 被用于同一个服务器的不同实例
PTK-4041
该错误码代表在安装两节点 CM 集群时，不允许设置数据库参数 enable_dcf=on
PTK-4042
该错误码代表提示的服务器上的用户已经被 PTK 管理的其他的集群使用了，一个服务器上的一个用户不允许安装多个数据库实例。
PTK-4043
该错误码代表在配置文件的 global.cm_option.cm_server_conf 中需配置 third_party_gateway_ip 参数来指定网关IP， 这个错误出现于在安装两节点 CM 集群的场景，且安装时指定了 -y，两节点CM时，该参数是必填参数， 所以可以手动在配置文件中配置，或者去掉 -y 参数通过和 PTK 交互形式进行实时填写。
PTK-4044
该错误码代表提示的数据节点没有处于运行当中，可以通过 ptk cluster status 来确认实例状态
PTK-4045
该错误码代表在交互时场景下，超过了指定的重试次数导致退出
PTK-4046
该错误码代表配置文件中服务器的 host 字段不能为空
错误码 5xxxx
PTK-50000
该错误码代表 PTK 在调用系统执行指令时的运行时错误，需根据实际错误信息判断错误原因
PTK-50001
该错误码代表 bash 脚本在目标服务器上执行失败
PTK-50101
该错误码代表序列化配置文件失败
PTK-50102
该错误码代表反序列化配置文件失败
PTK-50103
该错误码代表保存配置文件到本地失败
PTK-50105
该错误码代表指定的数据目录已经被一个正在运行的数据库实例在使用中
PTK-50106
该错误码代表在当前集群中没有找到用户指定 IP 的实例
PTK-50107
该错误码代表配置文件异常为空
PTK-50108
该错误码代表在当前集群中没有找到用户指的 ID 的实例
PTK-50201
该错误码代表提示的服务器上的目录已经存在
PTK-50202
该错误码代表创建目录失败
PTK-50203
该错误码代表创建文件失败
PTK-50204
该错误码代表读取本地元数据文件失败
PTK-50205
该错误码代表提示的文件已经存在
PTK-50206
该错误码代表路径中存在非法的字符
PTK-50207
该错误码代表提示的目录中不为空
PTK-50208
该错误码代表创建临时目录失败
PTK-50209
该错误码代表没有找到指定的集群
PTK-50210
该错误码代表提示的目录不存在
PTK-50211
该错误码代表提示的文件已经存在
PTK-50301
该错误码代表提示的用户已经存在
PTK-50302
该错误码代表提示的用户不存在
PTK-50303
该错误码代表用户组不匹配
PTK-50304
该错误码代表提示的文件或目录不属于指定用户，也就是文件的属主权限不对
PTK-50305
该错误码代表提示的用户没有 sudo 权限，一般是出现于依赖超级用户权限的场景
PTK-50601
该错误码代表请求指定的 URL 失败
PTK-50602
该错误码代表读取 HTTP 响应失败
PTK-50603
该错误码代表获取网卡的 bonding 信息失败
PTK-50604
该错误码代表探测网卡信息失败
PTK-50801
该错误码代表目标系统没有找到提示的 CPU 指令集，缺少某些必要的指令集可能导致数据库进程无法启动
PTK-50802
该错误码代表提示的命令未找到
PTK-50803
该错误码代表无效的 sysctl 配置
PTK-50804
该错误码代表 RemoveIPC 的配置必须为 no
PTK-50805
该错误码代表未找到指定的依赖，需要先手动安装
其他错误
PTK 对于内部固定的错误类型设置了错误码，但也存在运行时依赖的库或系统抛出的其他错误，
这些错误需用户根据错误提示，查看对应的系统或运行参数来进行修复，我们也会收集一些场景的错误来列举到 FAQ 页面。
但我们可能收集的不全面，如果您在使用过程中不能够自己解决的话，可以通过墨天轮的问答频道进行提问，我们的开发者也会及时关注并回复。（注意在提问是添加 ptk 标签哦）