#OCI驱动安装（Linux）

本文以使用Centos 7.3.1、OCI软件包yashandb-oci-xx.xx-linux-x86_64.tar.gz和YashanDB客户端安装包yashandb-client-xx.xx-linux-x86_64.tar.gz为例，介绍YashanDB OCI驱动在该环境下的安装配置过程。

# 步骤1：下载C驱动安装包

参考YashanDB软件包清单获取YashanDB客户端安装包。
将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。

安装包解压后可得到C驱动所需文件：
- C驱动的头文件：位于include文件夹中。
- C驱动的库文件：位于lib文件夹中。

# 步骤2：下载OCI驱动安装包

参考YashanDB软件包清单获取YashanDB OCI驱动安装包。
将OCI驱动安装包下载并解压到本地路径/home/yasdb-driver-c/lib。

解压后的libyas_oci.so为oci动态库，libyas_oci.so依赖libyascli.so，libyascli.so依赖libyas_infra.so。
- 如果使用cmake工程，只需依赖libyas_oci.so即可。
- 如果使用gdb链接，需要依赖libyas_oci.so、libyascli.so和libyas_infra.so。

# 步骤3：设置动态库依赖路径和数据源环境变量

将/home/yasdb-driver-c/lib设置到Linux LD_LIBRARY_PATH中，具体操作为：

编辑bashrc文件：
```
vi ~/.bashrc
```
新起一行增加LD_LIBRARY_PATH搜索路径，指向C驱动的库文件所在文件夹：
```
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib
```
（可选）当客户端与服务端不在同一台服务器时，还需要将数据源信息的路径配置为全局变量，变量名称必须为YASDB_HOME：
```
export YASDB_HOME=/home/yasdb-driver-c/lib
```
保存并退出。
刷新系统变量配置。
```
source ~/.bashrc
```

# 步骤4：配置数据源

创建数据源信息文件目录：
```
cd $YASDB_HOME
mkdir client
cd client
```
在数据源yasc_service.ini文件中配置数据源信息，配置参数为数据库服务端IP地址:端口号，默认端口为1688，例如：
```
vi yasc_service.ini

CITEST = 192.168.1.10:1688
```
本示例中，数据源名称为CITEST。当配置了多个数据库服务信息时，应用连接时可通过该名称连接对应的服务端。

# 步骤5：测试连接

yasociconntest为测试可执行文件，执行该文件测试OCI连接是否成立。

./yasociconntest

# 步骤6：（可选）开启日志

日志开启前需确保系统中存在YASDB_HOME系统路径以及YASDB_HOME系统路径下存在client目录。

日志所处路径

$YASDB_HOME/client/yasoci.log

日志开启方式

方法1：环境上设置系统变量。

export YASOCI_LOG = ON

方法2：代码中设置进程级系统变量。

(void)putenv("YASOCI_LOG=ON");