故障排查

错误码 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 标签哦）