先决条件
在登陆或复制数据之前,请确保达成以下先决条件:
-
在 数据移动网关 服务器上安装所需的 driver
信息注释只有当您选择使用 数据移动网关 时,才需要这样。有关 数据移动网关 的优势和何时需要它的信息,请参阅 Qlik 数据网关 - 数据移动。
-
授予数据源所需的权限
-
配置数据源连接器
在 z/OS 上安装 R4Z 产品
在使用 IBM DB2 for z/OS 源代码之前,必须首先在 z/OS 上安装和配置 R4Z 产品。
-
转到 产品下载。
-
选择 Qlik Data Integration。
-
向下滚动产品列表并选择Qlik Talend Data Integration。
-
在下载链接列中,单击 QlikReplicate_2023.5.0.191_r4z.zip 链接开始下载。
-
下载 R4Z 并将其安装在 z/OS 数据源上。
有关安装和配置说明,请参阅安装和配置 R4Z。
安装和设置驱动程序
您可以使用驱动程序安装实用程序(推荐)安装 driver 或手动安装。只有在您遇到驱动程序安装实用程序发生问题的少见情况下,才应尝试手动安装。
使用驱动程序安装实用程序安装驱动程序
本部分介绍如何安装所需的 driver。这个过程包括下载 driver,将其复制到所需的文件夹(见下文),并运行一个脚本来自动安装和配置它。您还可以根据需要运行脚本来更新和卸载 driver。
准备安装
-
请确保在 数据移动 网关服务器上安装了 Python 3.6 或更高版本。
Python 预装在大多数 Linux 发行版上。您可以通过运行以下命令来检查系统上安装了哪个 Python 版本。
python3 --version
-
从 IBM 网站下载 IBM Data Server Client "<版本>_linuxx64_client.tar.gz"。您可以在此路径中的 binary-artifacts 下面找到受支持版本:/opt/qlik/gateway/movement/drivers/manifests/db2.yaml。下载完成后,将文件复制到:
/opt/qlik/gateway/movement/drivers/db2
安装 driver
安装 driver :
-
停止 数据移动网关 服务:
sudo systemctl stop repagent
-
可选择确认服务已停止:
sudo systemctl status repagent
状态应如下所示:
Active: inactive (dead) since <timestamp> ago
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./install db2
否则,将显示 driver 的 EULA。
-
执行以下选项之一:
- 重复按 [Enter] 可在 EULA 中缓慢滚动。
- 重复按空格键可快速滚动 EULA。
- 按 q 退出许可证文本并显示 EULA 接受选项。
-
执行以下操作之一:
- 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
- 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
-
键入“v”并按 [Enter] 以再次查看 EULA。
-
等待安装完成(以“完成!”指示),然后启动 数据移动网关 服务:
sudo systemctl start repagent
-
可选择确认服务已启动:
sudo systemctl status repagent
状态应如下所示:
Active: active (running) since <timestamp> ago
将会安装 driver。
更新 driver
如果要在安装提供的 driver 之前卸载以前版本的 driver,请运行 update 命令。
更新 driver:
-
停止 数据移动网关 服务:
sudo systemctl stop repagent
-
可选择确认服务已停止:
sudo systemctl status repagent
状态应如下所示:
Active: inactive (dead) since <timestamp> ago
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./update db2
否则,将显示 driver 的 EULA。
-
执行以下选项之一:
- 重复按 [Enter] 可在 EULA 中缓慢滚动。
- 重复按空格键可快速滚动 EULA。
- 按 q 退出许可证文本并显示 EULA 接受选项。
-
执行以下操作之一:
- 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
- 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
- 键入“v”并按 [Enter] 可从头开始查看 EULA。
-
等待安装完成(以“完成!”指示),然后启动 数据移动网关 服务:
sudo systemctl start repagent
-
可选择确认服务已启动:
sudo systemctl status repagent
状态应如下所示:
Active: active (running) since <timestamp> ago
将卸载旧的 driver,并安装新的 driver。
卸载 driver
如果要卸载 driver,请运行 uninstall 命令。
卸载 driver:
-
停止所有配置为使用此连接器的任务。
-
在 数据移动 网关计算机上,将工作目录更改为:
opt/qlik/gateway/movement/drivers/bin
-
然后运行以下命令:
语法:
./uninstall db2
将卸载 driver。
手动安装驱动程序
只有在自动驱动程序安装未成功完成的情况下,才应尝试手动安装 driver。
Linux ODBC 客户端程序包
您可以选择安装完整的 ODBC 客户端软件包还是只安装数据服务器客户端,如 Linux 数据服务器客户端 中所述。
不支持“enableWLB”驱动程序选项。要强制连接自动切换到并行 sysplex 中的另一个 LPAR(即“故障切换”),请在驱动程序配置中将“enableACR”设置为“true”,将“enableWLB”设置为为“false”。
在 数据移动网关 机器上,打开 shell 提示符并执行以下操作:
-
停止 数据移动网关 服务:
sudo systemctl stop repagent
-
可选择确认服务已停止:
sudo systemctl status repagent
状态应如下所示:
Active: inactive (dead) since <timestamp> ago
- 安装l v11.5.8_linuxx64_server_dec.tar.gz 并选择“CLIENT” 选项。
-
如果 数据移动网关 计算机没有 DB2 实例,请运行以下命令创建 DB2 实例:
adduser <db2_instance_name>
/opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>
-
将工作目录更改为 <数据移动网关_Install_Dir>/bin.
-
将 DB2 驱动程序位置添加到 Linux 库路径。
为此,请将以下行添加到 site_ arep_login.sh 文件,具体如下:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib
其中 path 为驱动程序的 CLIENT 路径。
示例(以 db2clnt1 作为实例名):
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit
export DB2INSTANCE=db2clnt1
-
可选择确认已将驱动程序位置复制:
cat site_arep_login.sh
-
将以下条目添加到 /etc 下的 odbcinst.ini 文件:
[IBM DB2 ODBC DRIVER]
Driver = /home/db2clnt1/sqllib/lib/libdb2o.so
fileusage=1
dontdlclose=1
-
启动 数据移动网关 服务:
sudo systemctl start repagent
-
可选择确认服务已启动:
sudo systemctl status repagent
状态应如下所示:
Active: active (running) since <timestamp> ago
Linux 数据服务器客户端
-
从IBM Fix Central 下载 v11.5.8_linuxx64_client.tar.gz 并提取文件。
停止 数据移动网关 服务:
sudo service repagent stop
可选择确认服务已停止:
sudo service repagent status
状态应如下所示:
Active: inactive (dead) since <timestamp> ago
- 将工作目录更改为 /opt/client 并运行 db2_install。
创建一个 RSP 文件(请参阅下面的示例 RSP 文件),然后运行以下命令(从 /opt/client):
./db2setup -r /file-path/client.rsp
将以下条目添加到 /etc 下的 odbcinst.ini 文件:
[IBM DB2 ODBC DRIVER]
Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so
fileusage=1
dontdlclose=1
启动 数据移动网关 服务:
sudo service repagent start
可选择确认服务已启动:
sudo service repagent status
状态应如下所示:
Active: active (running) since <timestamp> ago
示例 RSP 文件
*----------------------------------------------------- * Generated response file used by the DB2 Setup wizard * generation time: 2/18/22 4:10 PM *----------------------------------------------------- * Product Installation LIC_AGREEMENT = ACCEPT PROD = CLIENT FILE = /opt/ibm/db2/V11.5 INSTALL_TYPE = TYPICAL * ---------------------------------------------- * Instance properties * ---------------------------------------------- INSTANCE = inst1 inst1.TYPE = client * Instance-owning user inst1.NAME = qlik inst1.UID = 1000 inst1.GROUP_NAME = qlik inst1.HOME_DIRECTORY = /home/qlik inst1.AUTOSTART = NO *----------------------------------------------- * Installed Languages *----------------------------------------------- LANG = EN
服务器端 ODBC 设置
按照 ODBC 初始化文件中 PLANNAME= 值中的指定,绑定要用于 ODBC 的计划。默认名称为 DSNACLI。BIND 作业可以在 DSNTIJCL 成员中找到,该成员位于源 DB2 安装的 SDSNSAMP 库中。
使用 DB2CLI bind 命令将 ODBC 提供的包绑定到预期的源 z/OS DB2 子系统。IBM 网站上的配置开发人员和运行时环境中描述了此操作。有关 DB2CLI 实用程序的信息,包括绑定实用程序的示例,请参阅 IBM 网站上的 DB2CLI-DB2 交互式 CLI 命令。
所需的权限
要使 数据移动网关 能从源表中提取数据(满负载和更改数据捕获),必须向在 IBM DB2 for z/OS 连接器设置中指定的IBM DB2 for z/OS 设置中指定的用户授予以下权限:
- IFI 读取 UDTF 的 EXECUTE(仅更改数据捕获需要)
- 在源表和以下系统目录表上的 SELECT:
- SYSIBM.SYSDUMMY1
- SYSIBM.SYSTABLES
- SYSIBM.SYSTABLESPACE
- SYSIBM.SYSPARMS
- SYSIBM.SYSROUTINES
- SYSIBM.SYSCOLUMNS
- SYSIBM.SYSLGRNX
- SYSIBM.SYSTABLEPART
- MONITOR2 能够启动 IFI 会话(仅更改数据捕获需要)
捕获数据更改
为了捕获 IBMDB2forz/OS 的更改,数据移动网关 使用一个特殊程序(作为外部例程调用),它是一个用户定义的表函数 (UDTF)。在捕获更改之前,需要在 z/OS 系统上安装和配置此程序(加载模块)以及 UDTF。安装和配置 R4Z中描述了应由 DBA 执行的安装过程。
此外,必须为要捕获其更改的每个表设置 DATA CAPTURE CHANGES 属性。您可以手动执行此操作,也可以通过在 连接器 设置中启用自动启用 DATA CAPTURE CHANGES(需要管理员权限)选项(默认设置)来允许 数据移动网关 执行此操作。