KingbaseES 缺少库文件问题

在工作中大家经常会遇到找不到某个so 的问题，这类可能是so文件缺失，或者是由于LD_LIBRARY_PATH 环境变量设置不当的原因。

1、库文件

我们通常把一些公用函数制作成函数库，供其它程序使用。函数库分为静态库和动态库两种。两者对比：

	动态库(.so)	静态库(.a)
编译时	不连接到目标代码	连接到目标代码
运行时	动态加载	不再需要(已经在目标代码内)

 2、常见问题

[kingbase@dbhost03 lib]$ ksql
ksql: error while loading shared libraries: libpq.so.5: cannot open shared object file: No such file or directory

[kingbase@dbhost03 lib]$ ldd /opt/Kingbase/ES/V8/Server/bin/ksql
        linux-vdso.so.1 =>  (0x00007ffe7d2be000)
        libpq.so.5 => not found                     --库缺失，或指向非kingbase的库
        libssl.so.10 => /opt/Kingbase/ES/V8/Server/lib/libssl.so.10 (0x00007fc24de15000)
        libcrypto.so.10 => /opt/Kingbase/ES/V8/Server/lib/libcrypto.so.10 (0x00007fc24d9b2000)
        libz.so.1 => /lib64/libz.so.1 (0x00007fc24d79c000)
        libreadline.so.5 => /opt/Kingbase/ES/V8/Server/lib/libreadline.so.5 (0x0000003c2bc00000)
        libtermcap.so.2 => /opt/Kingbase/ES/V8/Server/lib/libtermcap.so.2 (0x0000003c2d400000)
        librt.so.1 => /lib64/librt.so.1 (0x00007fc24d594000)
        libcrypt.so.1 => /lib64/libcrypt.so.1 (0x00007fc24d35d000)
        libdl.so.2 => /lib64/libdl.so.2 (0x00007fc24d159000)
        libm.so.6 => /lib64/libm.so.6 (0x00007fc24ce57000)
        libc.so.6 => /lib64/libc.so.6 (0x00007fc24ca89000)
        libgssapi_krb5.so.2 => /lib64/libgssapi_krb5.so.2 (0x00007fc24c83c000)
        libkrb5.so.3 => /lib64/libkrb5.so.3 (0x00007fc24c553000)
        libcom_err.so.2 => /lib64/libcom_err.so.2 (0x00007fc24c34f000)
        libk5crypto.so.3 => /lib64/libk5crypto.so.3 (0x00007fc24c11c000)
        libpthread.so.0 => /lib64/libpthread.so.0 (0x00007fc24bf00000)
        libfreebl3.so => /lib64/libfreebl3.so (0x00007fc24bcfd000)
        /lib64/ld-linux-x86-64.so.2 (0x00007fc24e087000)
        libkrb5support.so.0 => /lib64/libkrb5support.so.0 (0x00007fc24baed000)
        libkeyutils.so.1 => /lib64/libkeyutils.so.1 (0x00007fc24b8e9000)
        libresolv.so.2 => /lib64/libresolv.so.2 (0x00007fc24b6d0000)
        libselinux.so.1 => /lib64/libselinux.so.1 (0x00007fc24b4a9000)
        libpcre.so.1 => /lib64/libpcre.so.1 (0x00007fc24b247000)

以上的例子是由于so文件无法找到或缺失导致

3、KingbaseES 如何找 so 文件？

KingbaseES 在编译的时候，使用参数 -rpath 参数告诉编译器，在编译生成可执行文件的时候，记住库的位置，这样在运行的时候不需要再设置这个动态库的位置。但实际当中，还是经常会遇到找不到so文件的问题，还是需要设置 LD_LIBRARY_PATH 环境变量。

LD_LIBRARY_PATH: 动态库的查找路径
方法一： export LD_LIBRARY_PATH=LD_LIBRARY_PATH:/XXX 但是退出当前终端后就失效
方法二： 修改~/.bashrc或~/.bash_profile或系统级别的/etc/profile

1. 在其中添加例如export LD_LIBRARY_PATH=/opt/ActiveP/lib:$LD_LIBRARY_PATH
2.  source .bashrc (Source命令也称为“点命令”，也就是一个点符号(.)。source命令通常用于重新执行刚修改的初始化文件，使之立即生效，而不必注销并重新登录)

方法三：这个没有修改LD_LIBRARY_PATH，但是效果是一样的实现动态库的查找，

1. /etc/ld.so.conf下面加一行，如：/usr/local/mysql/lib
2. 保存后执行 ldconfig 生效。ldconfig 命令的用途，主要是在默认搜寻目录(/lib和/usr/lib)以及动态库配置文件/etc/ld.so.conf内所列的目录下，搜索出可共享的动态链接库(格式如前介绍,lib*.so*)，进而创建出动态装入程序(ld.so)所需的连接和缓存文件。缓存文件默认为/etc/ld.so.cache，此文件保存已排好序的动态链接库名字列表。

4、问题解决思路

1. 如果执行命令，如 ksql，报“error while loading shared libraries” ，可以先执行：ldd path/ksql ，确认丢失的库文件名。 
2. 先到 Server/lib 路径下寻找，如果有对应的库文件，那可能是 LD_LIBRARY_PATH 环境变量问题，需要设置该环境变量。
3. 如果Server/lib 路径下没有，再找 /lib64 , /lib 目录。注意：即使 /lib64 或  /lib 目录下有同样的库文件名，也未必可用，因为这些文件可能是PG的。

5、实际例子

 例子一：动态库版本不兼容

如以下例子，在initdb时，提示libstdc++ 版本不兼容。

 

确认kingbase所链接的库的位置：

 

验证操作系统 libstdc++.so.6 文件，确认确实不包含kingbase程序所需要的 CXXABI_1.3.8 版本。

 

问题原因分析：这种问题通常是由于软件在编译时，libc版本较高，而用户现场的版本较低，导致版本不兼容的情况。需要用户现场升级操作系统版本。

例子二：错误设置LD_LIBRARY_PATH

ksql 连接数据库时，报错如下：

 

从这个错误信息看，ksql 去连接5432端口，而5432 端口是PostgreSQL默认运行的端口，怀疑用户使用了错误lib库文件。

 

果然，ksql 使用了/lib64 下的libpq文件，而这个文件是操作系统安装时带入的PostgreSQL文件。修改LD_LIBRARY_PATH环境变量，指向/opt/kb86/ES/V8/Server/lib 目录。

 

确认已链接到正确的libpq文件。验证ksql 连接正常：

 

6、总结

对于数据库可执行程序启动时，缺少动态库的问题，一般可以按照以下步骤解决：

1. 首先通过ldd命令查看可执行程序需要加载的动态库。
2. 检查LD_LIBRARY_PATH变量配置是否正确。
3. 通过find命令查找缺失的so动态库文件。
4. 建立查找到的动态库文件到数据库系统lib目录下的软链接。
5. 重新启动应用程序。
6. 如果不能找到缺失的动态库，需要安装相应的软件包。