# 先决条件

在登陆或复制数据之前，请确保达成以下先决条件：

* 在 数据移动网关 服务器上安装所需的 driver

  信息注释

  只有当您选择使用 数据移动网关 时，才需要这样。有关 数据移动网关 的优势和何时需要它的信息，请参阅 [Qlik 数据网关 - 数据移动](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。

* 授予数据源所需的权限

* 配置数据源连接器

## 驱动程序设置

您可以使用驱动程序安装实用程序（推荐）安装 driver 或手动安装。只有在您遇到驱动程序安装实用程序发生问题的少见情况下，才应尝试手动安装。

### 使用驱动程序安装实用程序安装驱动程序

本部分介绍如何安装所需的 driver。这个过程包括下载 driver，将其复制到所需的文件夹（见下文），并运行一个脚本来自动安装和配置它。您还可以根据需要运行脚本来更新和卸载 driver。

### 准备安装

* 请确保在 数据移动 网关服务器上安装了 Python 3.6 或更高版本。

  Python 预装在大多数 Linux 发行版上。您可以通过运行以下命令来检查系统上安装了哪个 Python 版本。

  python3 --version

* 从 IBM 网站下载 IBM i Access Client Solutions Linux Application Package "ibm-iaccess-<版本>.x86\_64.rpm"。您可以在此路径中的 binary-artifacts 下面找到受支持版本：/opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml。下载完成后，将文件复制到：

  /opt/qlik/gateway/movement/drivers/db2i

### 安装 driver

安装 driver ：

1. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

2. 然后运行以下命令：

   语法：

   ./install db2iseries

   否则，将显示 driver 的 EULA。

3. 执行以下选项之一：

   * 重复按 [Enter] 可在 EULA 中缓慢滚动。
   * 重复按空格键可快速滚动 EULA。
   * 按 q 退出许可证文本并显示 EULA 接受选项。

4. 执行以下选项之一：

   * 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。

   * 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。

   * 键入“v”并按 [Enter] 以再次查看 EULA。

   将会安装 driver。

### 更新 driver

如果要在安装提供的 driver 之前卸载以前版本的 driver，请运行 update 命令。

更新 driver：

1. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

2. 然后运行以下命令：

   语法：

   ./update db2iseries

   否则，将显示 driver 的 EULA。

3. 执行以下选项之一：

   * 重复按 [Enter] 可在 EULA 中缓慢滚动。
   * 重复按空格键可快速滚动 EULA。
   * 按 q 退出许可证文本并显示 EULA 接受选项。

4. 执行以下选项之一：

   * 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
   * 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
   * 键入“v”并按 [Enter] 可从头开始查看 EULA。

   将卸载旧的 driver，并安装新的 driver。

### 卸载 driver

如果要卸载 driver，请运行 uninstall 命令。

卸载 driver：

1. 停止所有配置为使用此连接器的任务。

2. 在 数据移动 网关计算机上，将工作目录更改为：

   opt/qlik/gateway/movement/drivers/bin

3. 然后运行以下命令：

   语法：

   ./uninstall db2iseries

   将卸载 driver。

### 手动驱动程序设置

只有在自动驱动程序安装未成功完成的情况下，才应尝试手动安装 driver。

从 IBM 网站下载 IBM i Access Client Solutions Linux 应用程序包。

信息注释

仅支持 iAccess ODBC 驱动程序版本 7.1.26 至 7.1.29。

有关更多信息，请参阅 https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package

然后，在 数据移动网关 机器上，打开 shell 提示符并执行以下操作：

1. 停止 数据移动网关 服务：

   sudo systemctl stop repagent

2. 可选择确认服务已停止：

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 安装下载的包中包含的 RPM。

   示例：

   rpm -i ibm-iaccess-1.1.0.26-1.0.x86\_64

   信息注释

   数据移动网关 日志中显示的驱动程序版本将有所不同。例如，假设驱动程序版本与上例相同，它将在 数据移动网关 日志中显示为 ODBC 驱动程序版本： '07.01.026'。

   有关查看日志的信息，请参阅[数据任务故障排除](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Deploying/Troubleshooting-data-assets.htm)。

4. 将工作目录更改为 <数据移动网关\_Install\_Dir>/bin.

5. 将 DB2 驱动程序位置添加到 Linux 库路径。

   为此，请将以下路径添加到 **site\_ arep\_login.sh** <install\_dir>/replicate/bin 中的文件：

   `export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib64`

   其中 `path` 为驱动程序的路径。

   **示例：**

   `echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/ibm/iaccess/lib64" >> site_arep_login.sh`

6. 可选择确认已将驱动程序位置复制：

   ```
   cat site_arep_login.sh
                           
   ```

7. 安装完成后，打开 /etc/odbcinst.ini 文件，并确保它包含以下部分：

   ```
   [IBM i Access ODBC Driver 64-bit]Description = IBM i Access for Linux 64-bit ODBC Driver
   Driver = /opt/ibm/iaccess/lib64/libcwbodbc.so
   Setup = /opt/ibm/iaccess/lib64/libcwbodbcs.so
   Threading = 0
   DontDLClose = 1
   UsageCount = 1
   ```

8. 启动 数据移动网关 服务：

   sudo systemctl start repagent

9. 可选择确认服务已启动：

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

## CDC 先决条件

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-iseries/prereq-idb2.htm)

### 日志先决条件

给定 移动 任务的所有源表都需要记录到同一日志中。必须在 连接器 设置中指定日志的名称及其所在的库。在任务期间*，*数据移动网关 轮询此日志以查看源表的更改。

开始记录源表时，可以将 `Record images` 参数设置为 `*BOTH`（用于图像前后捕获）或 `*AFTER`。

当 `Record images` 参数设置为 `*AFTER` 时，删除的记录的数据字段中将包含 NULL 值。要将已删除记录的副本保存到已删除记录日志，必须将 `Record images` 参数集设置为 `*BOTH`。

信息注释

如果您需要运行多个 移动 任务（来自 IBMDB2foriSeries 的 移动 数据），为每个任务创建一个单独的日志会更有效（虽然不是必需的）。由于每个 连接器 只能指定一个日志，因此您还需要为每个任务定义一个单独的 连接器。

### MINENTDTA 参数

MINENTDTA 参数必须设置为 \*NONE，因为不支持 \*FILE（最小日志记录）。