插件安装

操作场景

云数据库GaussDB集中式形态（Oracle兼容模式）支持通过DBLink连接到Oracle数据库。DBLink通过调用Oracle提供的OCI(Oracle Call Interface )接口与Oracle通信，使用前需要用户完成OCI的安装配置。

本章节将为您介绍安装Oracle OCI插件的操作。

前提条件

安装插件前需要先将OCI插件包（例如：instantclient-basic-linux.x64-19.24.0.0.0dbru.zip）上传至最终租户OBS中。插件包上传请参考上传对象章节。

注意事项

• 插件安装过程中会重启实例，将导致数据库业务短暂中断。
• 用户需要提前自行从Oracle官网下载OCI(Oracle Call Interface ) 插件，支持的版本见表1。
• 插件包文件名不可以修改。

约束限制

• 仅V2.0-10.0.0及以上版本集中式实例主节点支持DBLink能力。
• 实例状态或节点状态异常，则不允许进行插件安装。
• 确保数据库实例节点与Oracle数据库网络互通。
• 支持连接的Oracle版本及使用的驱动版本：
  • x86环境：支持连接19c、21c、11g，驱动仅支持19c、21c的版本；
  • ARM环境：支持连接19c，驱动仅支持19c的版本；
• 只支持集中式Oracle兼容模式。
• 备份恢复新实例后，新实例如果需要使用DBLink能力，需要在新实例中先删除原有DBLink后重新创建。

计费说明

插件安装前需要将Oracle OCI插件包上传至OBS，会产生相应费用，OBS(对象存储服务)的详细收费标准请参考对象存储服务价格详情。

操作步骤

1. 登录云数据库GaussDB控制台。
2. 在“实例管理”页面，选择指定的实例，单击实例名称，进入实例的“基本信息”页签。
3. 在左侧导航栏单击“插件管理”。
4. 单击OracleOCI插件对应的“安装”。
   图1 安装OracleOCI插件
   

5. 输入下载链接、目标服务IP ，单击“确定”。

   表2 参数说明

   参数	描述
   插件名称	安装的插件名称，固定为OracleOCI。
   下载链接	Oracle OCI插件包在OBS中的分享链接。 获取方式请参考通过URL访问对象。
   目标服务IP	Oracle数据库实例监听的IP，其值为Oracle数据库listener.ora配置文件中ADDRESS属性中HOST的值。页面最多支持配置10个目标服务IP，会在GaussDB数据库添加到目标服务IP的策略路由。 如果需要添加多个目标服务IP，可以单击“添加”增加。 插件安装完成后，如需添加或删除目标服务IP，可单独进行配置。具体操作请参考配置目标IP。

6. 查看安装结果。插件安装过程中，实例状态为“安装插件中”。插件安装完成后，实例状态为“正常”。在“插件管理”模块，OracleOCI插件“是否安装”列为“是”，则本次插件安装成功。
   图2 查看安装结果