# 安裝 SAP Java 連接器

若要使用 SAP Extractor 連接器，您需要將 SAP Java Connector 安裝到 Qlik Talend Data Integration 伺服器。

資訊備註

只有在您選擇使用 資料移動閘道 時，才需要設定驅動程式。如需關於 資料移動閘道 福利以及何時需要的資訊，請參閱 [Qlik Data Gateway - Data Movement](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。

## SAP Java 連接器設定

您可以使用驅動程式安裝公用程式 (建議) 或手動安裝 SAP Java Connector。只能在不太可能發生的事件 (您在使用驅動程式安裝公用程式時遇到問題) 中嘗試手動安裝。

### 使用驅動程式安裝公用程式來安裝 SAP Java 連接器

此區段描述如何安裝所需的 SAP Java 連接器。該流程涉及下載 SAP Java 連接器、複製到所需的資料夾 (見下文)，以及執行將會自動安裝並設定該驅動程式的指令碼。您也可以執行指令碼，以根據需求更新並解除安裝 SAP Java 連接器。

### 準備安裝

* 確認 Python 3.6 或更高版本安裝於 資料移動 閘道伺服器。

  Python 會預先安裝在大部分的 Linux 發行版。您可以執行下列命令，以查看哪個 Python 版本安裝在您的系統上：

  python3 --version

* 從 SAP 支援入口網站下載 SAP Java 連接器 <version>「sapjco<version>.zip」。您可以在 /opt/qlik/gateway/movement/drivers/manifests/sapextractor.yaml 的 binary-artifacts 之下找到支援的版本。下載完成後，將檔案複製到：

  /opt/qlik/gateway/movement/drivers/sapextractor

### 安裝 SAP Java 連接器

若要安裝 SAP Java 連接器：

1. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

4. 執行下列命令：

   語法：

   ./install sapextractor

   將會安裝 SAP Java 連接器。

5. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

   sudo systemctl start repagent

6. 可自行選擇確認服務已開始：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

### 更新 SAP Java 連接器

若您想要在安裝提供的 SAP Java 連接器 之前解除安裝先前的 SAP Java 連接器 版本，請執行更新命令。

若要更新 SAP Java 連接器：

1. 停止 Data Movement gateway 服務：

   sudo systemctl stop repagent

2. 可自選，確認服務已停止：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: inactive (dead) since <timestamp> ago

3. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

4. 執行下列命令：

   語法：

   ./update sapextractor

   將會解除安裝舊版 SAP Java 連接器，並安裝新版 SAP Java 連接器。

5. 等待安裝完成 (以「完成！」指示)，然後開始 Data Movement gateway 服務：

   sudo systemctl start repagent

6. 可自行選擇確認服務已開始：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

### 解除安裝 SAP Java 連接器

若您想要解除安裝 SAP Java 連接器，請執行解除安裝命令。

若要解除安裝 SAP Java 連接器：

1. 停止設定為使用此連接器的所有任務。

2. 在 資料移動 閘道機器上，將工作目錄變更為：

   opt/qlik/gateway/movement/drivers/bin

3. 執行下列命令：

   語法：

   ./uninstall sapextractor

   將會解除安裝 SAP Java 連接器。

### 手動安裝 SAP Java 連接器

只有在自動驅動程式安裝無法成功完成時，才能嘗試手動安裝 SAP Java Connector。

從 https://support.sap.com/en/product/connectors/jco.html 下載適用於 Linux 的 SAP Java Connector 3.x (64 位元)。

接著，開啟 shell prompt 並進行以下項目：

1. 停止 Data Movement gateway 服務：

   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. 將這些檔案複製到 Data Movement gateway 安裝目錄底下的如下位置：

   <Data Movement gateway\_Install\_Dir>/endpoint\_srv/endpoints/SAP。

6. 開始 Data Movement gateway 服務：

   sudo systemctl start repagent

7. 可自行選擇確認服務已開始：

   sudo systemctl status repagent

   狀態應如下所示：

   Active: active (running) since <timestamp> ago

資訊備註

必須等到 Java 連接器物件庫安裝完成，重新啟動 Data Movement gateway 服務之後，SAP Extractor 連接器才可供選取。