zCloud 中 Oracle 实例状态未知问题记录

大家好，这里是 Lucifer三思而后行，专注于提升数据库运维效率。

前言

本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟

使用 zCloud 纳管 Oracle 数据库后，发现是 <实例可连接状态> 一直都是未知状态：

首先排除数据库本身问题，使用本地使用客户端连接：

Bash

1## 可以正常连接，没有问题
2[oracle@rhel8:/home/oracle]$ sqlplus system/oracle@192.168.6.220/lucifer
3
4SQL*Plus: Release 19.0.0.0.0 - Production on Tue Aug 20 10:24:23 2024
5Version 19.24.0.0.0
6
7Copyright (c) 1982, 2024, Oracle.  All rights reserved.
8
9
10Connected to:
11Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production
12With the Partitioning, OLAP, Data Mining and Real Application Testing options
13
14system@LUCIFER 2024-08-20 10:24:24>

出于好奇在群里寻找官方咨询后，得出答案是因为 zCloud 容器内部缺少依赖包：libaio，以下记录一下问题分析过程，如有遇到相同问题的可以参照以下方式进行解决。

问题分析

首先，查看 Prometheus：在浏览器输入，IP:8093：

image.png

查看 oracle-hr：

本来是想通过 http://172.18.0.2:8203/metrics-hr2 查看日志，但是由于是容器内部的网络，Proxy 里面的oracle-exporter 没有放开，所以无法在外部打开，所以需要进入容器内部，去查看 oracle-exporter 的日志，看看是什么原因导致数据库确实链接不上。

进入 zCloud 容器内部：

Bash

1## 查看容器
2[root@zcloud ~]# docker ps -a
3CONTAINER ID   IMAGE                     COMMAND                  CREATED        STATUS                  PORTS                                                                                                                                                                                                                                                                                                                                                 NAMES
479d21622a6c6   zcloud_with_mysql:6.2.1   "/bin/sh -c $HOME/in…"   21 hours ago   Up 21 hours (healthy)   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 0.0.0.0:8093->8093/tcp, :::8093->8093/tcp, 0.0.0.0:8100-8101->8100-8101/tcp, :::8100-8101->8100-8101/tcp, 0.0.0.0:8200-8201->8200-8201/tcp, :::8200-8201->8200-8201/tcp, 0.0.0.0:8215->8215/tcp, :::8215->8215/tcp, 0.0.0.0:8500->8500/tcp, :::8500->8500/tcp, 0.0.0.0:8761->8761/tcp, :::8761->8761/tcp   zcloud
5b1064b92f817   mysql_for_z:5.7.44        "/home/mysql/init.sh"    21 hours ago   Up 21 hours (healthy)   0.0.0.0:3306->3306/tcp, :::3306->3306/tcp                                                                                                                                                                                                                                                                                                             mysql_for_zcloud
6## 进入 zCloud 容器内部
7[root@zcloud soft]# docker exec -it zcloud bash
8[zcloud@79d21622a6c6 ~]$

找到 oracle-exporter 日志：

Bash

1[zcloud@79d21622a6c6 ~]$ ls
2check.sh  config.properties  data  dbaas  init  init.sh  libs  proxy  rpms  sqls
3[zcloud@79d21622a6c6 ~]$ cd proxy/
4[zcloud@79d21622a6c6 proxy]$ ls
5chisel  common  exporters        insight         log   notRootMonitor          notRoot.sh  proxy            rceEngine    root.sh       winrm              zcloud_proxy_nginx        zcloud_zdbmon_collector
6chitu   config  firewallPort.sh  java-io-tmpdir  logs  notRootProxyOperate.sh  obClient    proxyOperate.sh  redisClient  updateEnv.sh  zcloud_mysql_soar  zcloud_slowmon_collector  zcloud_zoramon
7[zcloud@79d21622a6c6 proxy]$ cd log
8[zcloud@79d21622a6c6 log]$ ls
9chisel.log            proxy_info.log                        zcloud_custom_sql_exporter_info_2024-08-19.0.log.zip  zcloud_db2_exporter.log      zcloud_mysql_exporter.log                  zcloud_oracle_exporter.log        zcloud_redis_exporter.log     zcloud_zoramon_collector.log
10monitor.log           zcloud_commondb_exporter.log          zcloud_custom_sql_exporter_info.log                   zcloud_mongodb_exporter.log  zcloud_node_exporter_2024-08-19.0.log.zip  zcloud_postgres_exporter.log      zcloud_slowmon_collector.log
11proxy_info.1.log.zip  zcloud_custom_sql_exporter_error.log  zcloud_custom_sql_exporter_warn.log                   zcloud_mssql_exporter.log    zcloud_node_exporter.log                   zcloud_rce_engine_20240819_1.log  zcloud_zdbmon_collector.log

打开 oracle-exporter 日志，发现是 Docker 里面缺少一个依赖（BUG）：

Bash

1## 报错消息，提示：libclntsh.so: cannot open shared object file: No such file or directory
2time=2024-08-20 10:33:20 level=info  file=oracle_common.go:584    msg=97189ea4-17b7-412a-a6a7-a51b0d7959a2->6876,query connection count failed
3time=2024-08-20 10:33:20 level=error file=oracle_exporter.go:696  id=97189ea4-17b7-412a-a6a7-a51b0d7959a2 instance=lucifer type=exporter_hr2 msg=97189ea4-17b7-412a-a6a7-a51b0d7959a2->6876,collect connectCount error:ORA-00000: DPI-1047: Cannot locate a 64-bit Oracle Client library: "/home/zcloud/proxy/common/instantclient_12_1/lib/libclntsh.so: cannot open shared object file: No such file or directory". See https://oracle.github.io/odpi/doc/installation.html#linux for help

需要在 zCloud 容器内部安装缺少的依赖包 libaio 进行修复。

解决方案

上传并安装 libaio 依赖包：

libaio 依赖包下载地址：libaio-0.3.109-13.el7.x86_64.rpm

Bash

1## 上传 libaio 依赖包
2[root@zcloud ~]# cd /soft/
3[root@zcloud soft]# ll libaio-0.3.109-13.el7.x86_64.rpm
4-r--r--r--. 1 root root      24744 Aug 20 10:32 libaio-0.3.109-13.el7.x86_64.rpm
5drwxr-xr-x. 3 root root        180 Aug 19 13:35 zCloud_6.2.1.1_For_Personal_mysql_X86_20240809_1504
6-rw-r--r--. 1 root root 4133808651 Aug 18 23:05 zCloud_6.2.1.1_For_Personal_mysql_X86_20240809_1504.tar.gz
7drwxr-xr-x. 3 root root        180 Aug  5 09:33 zCloud_6.2.1_For_Personal_mysql_X86_20240730_1657
8-rwxr-xr-x. 1 root root 4123537621 Aug  5 09:30 zCloud_6.2.1_For_Personal_mysql_X86_20240730_1657.tar.gz
9## 拷贝到 zCloud 容器内部
10[root@zcloud soft]# docker cp /soft/libaio-0.3.109-13.el7.x86_64.rpm zcloud:/tmp/libaio-0.3.109-13.el7.x86_64.rpm
11Successfully copied 26.6kB to zcloud:/tmp/libaio-0.3.109-13.el7.x86_64.rpm
12## 执行安装
13[root@zcloud soft]# docker exec -u root -it zcloud rpm -ivh /tmp/libaio-0.3.109-13.el7.x86_64.rpm
14warning: /tmp/libaio-0.3.109-13.el7.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID f4a80eb5: NOKEY
15Preparing...                          ################################# [100%]
16Updating / installing...
17   1:libaio-0.3.109-13.el7            ################################# [100%]

安装完成后，再次查看实例状态（已恢复正常，显示可连接）：

查看 oracle-exporter 日志：

Bash

1## 没有报错日志出现
2time=2024-08-20 10:46:14 level=info  file=oracle_common.go:323    msg=97189ea4-17b7-412a-a6a7-a51b0d7959a2->99183,period:lr2,instance:[97189ea4-17b7-412a-a6a7-a51b0d7959a2],permit to create long connection
3time=2024-08-20 10:46:14 level=info  file=oracle_common.go:340    msg=97189ea4-17b7-412a-a6a7-a51b0d7959a2->99183,period:lr2,instanceUUID:97189ea4-17b7-412a-a6a7-a51b0d7959a2,isHr2:[false],create connection , start...

至此，问题已解决，该 BUG 暂时可以按以上方式进行临时处理，会在下个 zCloud 更新版本中完全修复。

往期精彩文章推荐

一篇文章让你彻底掌握 Python 🔥
一篇文章让你彻底掌握 Shell 🔥
Oracle 监控 EMCC 13.5 安装部署超详细教程 🔥
Oracle 一键巡检自动生成 Word 报告 🔥
Oracle一键安装脚本的 21 个疑问与解答 🔥
Oracle一键巡检脚本的 21 个疑问与解答 🔥
全网首发：Oracle 23ai 一键安装脚本 🔥
Oracle 19C 最新 RU 补丁 19.24 ，一键安装！ 🔥
Oracle Linux 6 一键安装 Oracle 11GR2 RAC
Oracle Linux 7.9 一键安装 Oracle 19C
Oracle Linux 8.9 一键安装 Oracle 19C RAC
Oracle Linux 9.4(aarch64) 一键安装 Oracle 19C 🔥
openEuler 20.03 LTS SP4 一键安装 Oracle 19C 🔥
openEuler 22.03 LTS SP4 一键安装 Oracle 19C RAC
RHEL 7.9 一键安装 Oracle 19C 19.23 RAC
Redhat 8.4 一键安装 Oracle 11GR2
RedHat 9.4(aarch64) 一键安装 Oracle 19C
龙蜥 Anolis 7.9 一键安装 Oracle 19C 19.23
龙蜥 Anolis OS 8.8 一键安装 Oracle 19C
SUSE 15 SP5 一键安装 Oracle 19C
统信 UOS V20 1070(a) 一键安装 Oracle 11GR2
Ubuntu 22.04 一键安装 Oracle 19C
Ubuntu 14.04 一键安装 Oracle 19C
银河麒麟 Kylin V10 SP3 一键安装 Oracle 19C 🔥
银河麒麟 Kylin V10 SP3 一键安装 Oracle 11GR2 RAC
Oracle DataGuard GAP 修复手册 🔥
优化 Oracle：最佳实践与开发规范
 DBA 必备：Linux 软件源配置全攻略 🔥
Linux 一键配置时钟同步全攻略 🔥
Starwind 配置 ISCSI 共享存储
 SUSE 15 SP3 安装 Oracle 19C RAC 数据库
 达梦 8 数据库安装手册 🔥
Oracle 12CR2 RAC 安装避坑宝典
 Linux7 安装 Oracle 19C RAC 详细图文教程 🔥
Oracle ADG 搭建 RAC to Single 详细教程
 Oracle DataGuard GAP 修复手册 🔥
Oracle 分区表之在线重定义
 AutoUpgrade 快速升级 Oracle 数据库
 Oracle 数据库巡检命令手册 🔥
Oracle 数据坏块的 N 种修复方式 🔥
数据库 SQL 开发入门教程
 超全 Linux 基础命令总结 🔥
VMware 虚拟机安装 Linux 系统
 Linux 安装 MySQL 详细教程
 教你玩转 SQLPLUS，工作效率提升 200%

感谢您的阅读，这里是 Lucifer三思而后行，欢迎 点赞+关注，我会持续分享数据库知识、运维技巧。