#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");