原文链接：https://www.gbase.cn/community/post/4295
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。
南大通用GBase 8c数据库是一款具有多模多态特性的高性能企业级分布式数据库，支持行存、列存、内存等多种存储模式以及单机、主备、分布式部署形态。GBase 8c数据库安装包从南大通用官网获取，地址为https://www.gbase.cn/download/gbase-8c?category=INSTALL_PACKAGE
GBase 8c 作为一款高性能的分布式数据库管理系统，广泛应用于大数据处理和实时分析领域。然而，在实际应用过程中，由于各种原因可能会出现各种故障。本文将对GBase 8c分布式场景下安装和运行过程中常见的故障进行分析，并提供相应的处理方法，以期为使用GBase 8c的用户提供参考。
一、安装过程中的常见故障及处理
1.1 安装报错：Failed to start instance
问题描述：在安装GBase 8c时，可能会出现“Failed to start instance. Error: Please check the gs_ctl log for failure details.”的错误。
解决方法：
检查系统配置：检查/etc/sysctl.conf中的kernel.shmmax配置是否过小。若过小，需添加或修改该行为kernel.shmmax = 18446744073692774399，并执行sysctl -p使其生效。
解决端口占用：如果集群卸载后进程还在占用端口，可以考虑重启机器或使用相关命令如kill来杀掉相关进程。
1.2 Failed to initialize instance
问题描述：初始化实例失败。
解决方法：
检查配置文件：仔细检查gbase.yml文件，确保文件格式正确，两个空格为一个缩进。可以使用在线YML编辑器进行校验。
检查互信操作：确保各节点间的互信操作配置成功，可以使用ssh命令进行测试。
配置互信时，可提前修改机器主机名称，以免在互信配置时出现异常。
1.3 端口被占用
问题描述：安装过程中提示端口被占用。
解决方法：使用lsof -i:端口号命令查看哪个进程占用了该端口，并关闭相应的进程或使用其他端口。
1.4 配置文件错误
问题描述：在预检查或安装过程中，因配置文件错误导致失败。
解决方法：
检查cluster_config.xml配置文件是否完整，特别是是否缺失了<ROOT>标签。确保/etc/hosts文件中的IP和hostname与配置文件中的一致，特别是双网卡环境或集群配置变更后。
1.5、ubantu安装数据库时报错
报错信息：如下方实际操作场景，报错：
解决方法：
更换 bash，使用以下命令：
sudo dpkg-reconfigure dash
并在过程中，选择 No 并回车。退出后即可自动切换为 bash。
二、运行过程中的常见故障及处理
2.1 Rpc request failed
问题描述：在运行过程中，可能出现Rpc请求失败的错误，如“Rpc request failed:Coordinator cnl start failed”。
解决方法：
检查内存和磁盘空间：使用free -m查看内存是否足够，并检查磁盘空间是否充足。若不足，需清理空间或增加内存。
查看数据库日志：详细查看数据库运行日志，寻找错误原因，可能是磁盘空间不足或其他资源限制。
2.2 权限不足
问题描述：在切换用户或执行特定命令时，因权限不足导致失败。
解决方法：
确保目录和文件的权限设置正确。例如，如果gbase用户无法访问/var/log/gbase目录，可以使用chown gbase:gbase -R /var/log/gbase/命令修改权限。
切换用户时，尽量使用su - gbase而不是su gbase，以加载gbase用户的环境变量。
2.3 集群已安装
问题描述：执行安装命令时提示集群已安装。
解决方法：
清理环境变量。检查每个节点的~/.bashrc文件，确认GAUSS_ENV环境变量是否设置错误，将其重置或删除后重新执行安装命令。
env|grep GAUSS_ENV
卸载已安装的集群，可以使用gha_ctl uninstall和gha_ctl destroy dcs命令。
2.4 current transaction is aborted
报错信息：实际环境报错信息如下：
这个错误的意思，是前面的事务失败了，需要先回滚，然后才能执行新的语句。
解决办法：
有两种可能的原因：
前面使用begin手动开启了事务，此时需要手动执行rollback命令关闭事务。
前面会话中设置autocommit 为 off，导致数据库隐式开始了事务，此时也需要手动rollback。
三、总结
GBase 8c在安装和运行过程中可能会遇到多种故障，但通过详细的问题分析和适当的处理方法，大多数问题都可以得到解决。本文从安装过程中的常见错误和运行中的常见问题两个方面进行了详细的故障分析和处理方法的介绍，希望对使用GBase 8c的用户有所帮助。
在处理故障时，务必遵循以下原则：
1）仔细查看错误信息：错误信息往往能提供解决问题的关键线索。
2）检查系统配置和依赖：确保系统配置和依赖库正确无误。
3）查看日志文件：详细查看相关日志文件，以便更准确地定位问题。
4）使用正确的命令和工具：在解决权限问题时，注意使用正确的命令和工具。
原文链接：https://www.gbase.cn/community/post/4295
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。
