# 插件安装
#### 操作场景
云数据库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中。插件包上传请参考[上传对象](https://support.huaweicloud.com/usermanual-obs/obs_03_1002.html)章节。
#### 注意事项
- 插件安装过程中会重启实例，将导致数据库业务短暂中断。
- 用户需要提前自行从Oracle官网下载OCI(Oracle Call Interface ) 插件，支持的版本见[表1]。
- 插件包文件名不可以修改。
 表1OCI插件 
| 系统架构                                                     | OCI插件包名                                             | SHA 256                                                          |
|:---|:---|:---|
| x86  | instantclient-basic-linux.x64-19.26.0.0.0dbru.zip   | f5f5f7e8eb8e1f057a33a8b8f5aef096544535365dedd31324f5f411abab339e |
| x86  | instantclient-basic-linux.x64-21.17.0.0.0dbru.zip   | 70e3a0107a4847e2644a97df5102065c9ca133db36d81b3f3429f6e3426ff10f |
| x86  | instantclient-basic-linux.x64-11.2.0.4.0.zip        | 77efd0021c3e122075bf994786646e123063af843475395eb95b139501387160 |
| ARM                                                      | instantclient-basic-linux.arm64-19.26.0.0.0dbru.zip | f8bd362bde8834c458493c14a654c97f6a9f8d1dcbbb38e1b67f8d3102851964 |
   
#### 约束限制
- 仅V2.0-10.0.0及以上版本集中式实例主节点支持DBLink能力。
- 实例状态或节点状态异常，则不允许进行插件安装。
- 确保数据库实例节点与Oracle数据库网络互通。
- 支持连接的Oracle版本及使用的驱动版本：
  - x86环境：支持连接19c、21c、11g，驱动仅支持19c、21c的版本；
  
  - ARM环境：支持连接19c，驱动仅支持19c的版本；
   
- 只支持集中式Oracle兼容模式。
- 备份恢复新实例后，新实例如果需要使用DBLink能力，需要在新实例中先删除原有DBLink后重新创建。
 
#### 计费说明
插件安装前需要将Oracle OCI插件包上传至OBS，会产生相应费用，OBS(对象存储服务)的详细收费标准请参考[对象存储服务价格详情](https://www.huaweicloud.com/pricing/calculator.html#/obs)。
#### 操作步骤
1. [登录云数据库GaussDB控制台](https://console.huaweicloud.com/gaussdb/?locale=zh-cn#/gaussdb/management/list)。
2. 在"实例管理"页面，选择指定的实例，单击实例名称，进入实例的"基本信息"页签。
3. 在左侧导航栏单击"插件管理"。
4. 单击OracleOCI插件对应的"安装"。 
   
   图1安装OracleOCI插件   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002679854141.png "点击放大")
   
   
   
5. 输入下载链接、目标服务IP ，单击"确定"。 
   表2参数说明 
   | 参数     | 描述                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|
   | 插件名称   | 安装的插件名称，固定为OracleOCI。                                                                                                                                                                                                                                                                                                                                       |
   | 下载链接   | Oracle OCI插件包在OBS中的分享链接。 获取方式请参考[通过URL访问对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0319.html)。                                                                                                                                                                                                |
   | 目标服务IP | Oracle数据库实例监听的IP，其值为Oracle数据库listener.ora配置文件中ADDRESS属性中HOST的值。页面最多支持配置10个目标服务IP，会在GaussDB数据库添加到目标服务IP的策略路由。 如果需要添加多个目标服务IP，可以单击"添加"增加。 插件安装完成后，如需添加或删除目标服务IP，可单独进行配置。具体操作请参考[配置目标IP](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_714.html)。 |
      
   
   
6. 查看安装结果。插件安装过程中，实例状态为"安装插件中"。插件安装完成后，实例状态为"正常"。在"插件管理"模块，OracleOCI插件"是否安装"列为"是"，则本次插件安装成功。 
   
   图2查看安装结果   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002649774406.png "点击放大")