#YASOCI安装说明(Linux)
本文将介绍YashanDB的OCI驱动安装方式。
操作系统
本文将以Centos 7.3.1为例,介绍YashanDB OCI驱动在该环境下的安装配置过程。
依赖项
使用YashanDB OCI驱动需要先安装和配置YashanDB C驱动库。
# 1、下载C驱动安装包
1.依据运维手册安装部署YashanDB软件包清单获取对应的软件包,本文以yashandb-client-xx.xx-linux-x86_64.tar.gz为例。
2.将tar.gz文件下载并解压到本地路径,例如/home/yasdb-driver-c/
。
3.安装包解压后包括三个文件夹:bin、include以及lib:
bin
:C驱动的可执行文件(目前包括yasql)。
include
:C驱动的头文件。
lib
:C驱动的库文件。
# 2、下载OCI安装包
1.获取OCI软件包,本文以yashandb-oci-xx.xx-linux-x86_64.tar.gz为例。
2.将tar.gz文件下载并解压到本地路径/home/yasdb-driver-c/lib
。(tar.gz文件解压后的libyas_oci.so为oci动态库,cmake工程只需要依赖libyas_oci.so即可,此外libyas_oci.so依赖libyascli.so,libyascli.so依赖libyas_infra.so,如果使用gdb链接,需要将此三个库都依赖上)
# 3、设置动态库依赖路径
将/home/yasdb-driver-c/lib
设置到Linux LD_LIBRARY_PATH中,具体操作为:
1.编辑bashrc文件:
vim ~/.bashrc
2.增加LD_LIBRARY_PATH搜索路径,新增一行:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib
3.保存并退出。
4.刷新系统变量配置。
source ~/.bashrc
# 4、配置数据源
# 数据源所处路径:
$YASDB_HOME/client/yasc_service.ini
确保连接前系统中存在YASDB_HOME系统路径,并且在yasc_service.ini文件中配置了数据源。
# 数据源配置方式:
yasc_service.ini中配置,例如:
vim yasc_service.ini
CITEST = 127.0.0.1:1688
# 5、测试连接
./yasociconntest
yasociconntest为测试可执行文件,执行该文件测试OCI连接是否成立。
# 6、日志开启(可选)
# 日志所处路径:
$YASDB_HOME/client/yasoci.log
确保日志开启前系统中存在YASDB_HOME系统路径,以及YASDB_HOME系统路径下存在client目录。
# 日志开启方式:
1、方法1:环境上设置系统变量。
export YASOCI_LOG = ON
2、方法2:代码中设置进程级系统变量。
(void)putenv("YASOCI_LOG=ON");