先决条件
在登陆或复制数据之前,请确保达成以下先决条件:
-
在 数据移动网关 服务器上安装所需的 driver
信息注释只有当您选择使用 数据移动网关 时,才需要这样。有关 数据移动网关 的优势和何时需要它的信息,请参阅 Qlik 数据网关 - 数据移动。
-
授予数据源所需的权限
-
配置数据源连接器
驱动程序设置
您可以使用驱动程序安装实用程序(推荐)安装 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 :
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./install db2iseries
否则,将显示 driver 的 EULA。
-
执行以下选项之一:
- 重复按 [Enter] 可在 EULA 中缓慢滚动。
- 重复按空格键可快速滚动 EULA。
- 按 q 退出许可证文本并显示 EULA 接受选项。
-
执行以下操作之一:
- 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
- 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
-
键入“v”并按 [Enter] 以再次查看 EULA。
将会安装 driver。
更新 driver
如果要在安装提供的 driver 之前卸载以前版本的 driver,请运行 update 命令。
更新 driver:
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./update db2iseries
否则,将显示 driver 的 EULA。
-
执行以下选项之一:
- 重复按 [Enter] 可在 EULA 中缓慢滚动。
- 重复按空格键可快速滚动 EULA。
- 按 q 退出许可证文本并显示 EULA 接受选项。
-
执行以下操作之一:
- 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
- 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
- 键入“v”并按 [Enter] 可从头开始查看 EULA。
将卸载旧的 driver,并安装新的 driver。
卸载 driver
如果要卸载 driver,请运行 uninstall 命令。
卸载 driver:
-
停止所有配置为使用此连接器的任务。
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./uninstall db2iseries
将卸载 driver。
手动驱动程序设置
只有在自动驱动程序安装未成功完成的情况下,才应尝试手动安装 driver。
从 IBM 网站下载 IBM i Access Client Solutions Linux 应用程序包。
不支持 iAccess ODBC 驱动程序 7.1.0.。
有关更多信息,请参阅 https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package
然后,在 数据移动网关 机器上,打开 shell 提示符并执行以下操作:
-
停止 数据移动网关 服务:
sudo systemctl stop repagent
-
可选择确认服务已停止:
sudo systemctl status repagent
状态应如下所示:
Active: inactive (dead) since <timestamp> ago
-
安装下载的包中包含的 RPM。
示例:
rpm -i ibm-iaccess-1.1.0.26-1.0.x86_64
信息注释数据移动网关 日志中显示的驱动程序版本将有所不同。例如,假设驱动程序版本与上例相同,它将在 数据移动网关 日志中显示为 ODBC 驱动程序版本: '07.01.026'。
有关查看日志的信息,请参阅数据任务故障排除。
-
将工作目录更改为 <数据移动网关_Install_Dir>/bin.
-
将 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
-
可选择确认已将驱动程序位置复制:
cat site_arep_login.sh
-
安装完成后,打开 /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 -
启动 数据移动网关 服务:
sudo systemctl start repagent
-
可选择确认服务已启动:
sudo systemctl status repagent
状态应如下所示:
Active: active (running) since <timestamp> ago
CDC 先决条件
日志先决条件
给定 移动 任务的所有源表都需要记录到同一日志中。必须在 连接器 设置中指定日志的名称及其所在的库。在任务期间,数据移动网关 轮询此日志以查看源表的更改。
开始记录源表时,可以将 Record images 参数设置为 *BOTH(用于图像前后捕获)或 *AFTER。
当 Record images 参数设置为 *AFTER 时,删除的记录的数据字段中将包含 NULL 值。要将已删除记录的副本保存到已删除记录日志,必须将 Record images 参数集设置为 *BOTH。
如果您需要运行多个 移动 任务(来自 IBMDB2foriSeries 的 移动 数据),为每个任务创建一个单独的日志会更有效(虽然不是必需的)。由于每个 连接器 只能指定一个日志,因此您还需要为每个任务定义一个单独的 连接器。
MINENTDTA 参数
MINENTDTA 参数必须设置为 *NONE,因为不支持 *FILE(最小日志记录)。