# 先决条件

以下部分介绍使用 SAP ODP 源 连接器 的先决条件。

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

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

  信息注释

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

* 授予数据源所需的权限

* 配置数据源连接器

## ODP API

SAP ODP 端点使用 ODP API 2.0，其可从以下 SAP 基础级别及以上级别获得：

* PI\_BASIS 730 SP 14（SAP NetWeaver 7.30 SP 14 的一部分）

* PI\_BASIS 731 SP 16（SAP NetWeaver 7.03 SP 16 和 7.31 SP 16 的一部分）

* PI\_BASIS 740 SP 11（SAP NetWeaver 7.40 SP 11 的一部分）

* SAP\_BW 750 SP 0（包括之前的 PI\_BASIS 程序包）

信息注释SAP\_BASIS 和 PI\_BASIS 是可互换的。在较新的系统中，组件名称为 SAP\_BASIS。

有关更多信息请参阅 SAP 注释 1931427。

关于如何释放提取器以使其可用于 ODP API 的信息，请参见 SAP 注释 2232584。

## 驱动程序设置

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

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

本部分介绍如何安装所需的 SAP Java Connector。这个过程包括运行一个脚本，该脚本将自动下载、安装和配置所需的 SAP Java Connector。您还可以根据需要运行脚本来更新和卸载 SAP Java Connector。

### 准备安装

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

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

  python3 --version

* 从 SAP 支持门户下载 SAP Java 连接器 <版本> "sapjco<版本>.zip"。您可以在此路径中的 binary-artifacts 下面找到受支持版本：/opt/qlik/gateway/movement/drivers/manifests/sapodp.yaml。下载完成后，将文件复制到：

  /opt/qlik/gateway/movement/drivers/sapodp

### 安装 SAP Java Connector

下载并安装 SAP Java Connector ：

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

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

4. 然后运行以下命令：

   语法：

   ./install sapodp

   如果无法下载 SAP Java Connector（由于访问限制或技术问题），将显示一条消息，为您指示在 数据移动 网关机器上下载 SAP Java Connector 的位置和复制驱动程序的位置。完成此操作后，请再次运行 install sapodp 命令。

   否则，将显示 SAP Java Connector 的 EULA。

5. 执行以下选项之一：

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

6. 执行以下选项之一：

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

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

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

   将会安装 SAP Java Connector。

7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 更新 SAP Java Connector

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

下载并更新 SAP Java Connector：

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

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

4. 然后运行以下命令：

   语法：

   ./update sapodp

   如果无法下载 SAP Java Connector（由于访问限制或技术问题），将显示一条消息，为您指示在 数据移动 网关机器上下载 SAP Java Connector 的位置和复制驱动程序的位置。完成此操作后，请再次运行 update sapodp 命令。

   否则，将显示 SAP Java Connector 的 EULA。

5. 执行以下选项之一：

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

6. 执行以下选项之一：

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

   将卸载旧的 SAP Java Connector，并安装新的 SAP Java Connector。

7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

### 卸载 SAP Java Connector

如果要卸载 SAP Java Connector，请运行 uninstall 命令。

卸载 SAP Java Connector：

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

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

   opt/qlik/gateway/movement/drivers/bin

3. 然后运行以下命令：

   语法：

   ./uninstall sapodp

   将卸载 SAP Java Connector。

### 手动安装驱动程序

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

从以下位置下载 Linux 版本 SAP Java Connector 3.x （64位）https://support.sap.com/en/product/connectors/jco.html。

然后，打开 shell 提示符并执行以下操作：

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

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 将工作目录更改为opt/qlik/gateway/movement/bin 并运行以下命令：

   source arep\_login.sh

   这样将设置 数据移动 网关安装路径。

4. 将下载的文件解压缩到您选择的文件夹中。

   该文件夹应包含 Sapjco3.jar 和 libsapjco3.so 文件。

5. 将这些文件复制到 数据移动网关 安装目录下的以下位置：

   <数据移动网关\_Install\_Dir>/endpoint\_srv/endpoints/SAP。

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

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   状态应如下所示：

   Active: active (running) since <timestamp> ago

信息注释

在安装 Java 连接器库并重新启动 数据移动网关 服务之前，SAP ODP 连接器 将无法供选择。

## STXL 表支持

要使用 SAP ODP 端点公开表 STXL 以进行提取，需要在 SAP GUI 中的事务 RSO2 中创建一个自定义提取器。然后，SAP ODP 端点可以调用该提取器。

## 在 SAP 上设置 SLT

为了复制数据，您必须首先定义参数，这些参数由 SAP Landscape Transformation Replication Server 用于将数据从源系统复制到目标系统。您可以在配置中指定此信息。配置包含有关源系统、目标系统和相关连接的信息。

您可以在 SAP Landscape Transformation Replication Server 系统中创建配置。要创建配置，请打开 SAP LT Replication Server Cockpit（事务 LTRC），然后选择创建配置。

配置的创建包括以下步骤：

1. 在指定常规数据选项卡中，提供以下信息：

   * 配置名称：您必须为配置指定一个名称。此名称用于在目标系统中自动创建的架构。

   * 描述（可选）：可选择是否指定配置的说明。

2. 在指定源系统选项卡中，选择 RFC 连接选项并提供以下信息：

   * RFC 目的地：输入无。
   * 允许多次使用：选择此选项。

3. 在指定目标系统选项卡中，选择其他选项并提供以下信息：

   * 场景：从下拉列表中选择操作数据配置 (ODP)。
   * 队列别名：指定名称。

4. 在指定传输设置选项卡中，指定适合您的环境的传输设置。在作业选项下，我们建议至少设置五个数据传输、初始加载和计算作业。

5. 在查看和创建选项卡中，查看您的设置并创建配置。

6. 向 [所需的权限](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-ODP/sap-odp-permissions.htm) 授权。

创建配置后，可以继续配置相关的连接器设置。