# 前提条件

次のセクションでは、SAP ODP ソース コネクタ を使用するための前提条件について説明します。

データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。

* Data Movement gateway サーバーに、必要な SAP Java Connector をインストールする

  情報メモ

  これは、Data Movement gateway を使用することを選択した場合のみ必要です。Data Movement gateway の利点と必要なタイミングについては、[Qlik データ ゲートウェイ - データ移動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm) を参照してください。

* データ ソースに必要な権限を付与する

* データ ソースのコネクタを構成する

## ODP API

SAP ODP エンドポイントは、次の SAP ベース レベル以上で利用できる ODP API 2.0 を使用します。

* 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 Note 1931427」を参照してください。

ODP API で利用できるように抽出子をリリースする方法の情報については、「SAP Note 2232584」を参照してください。

## ドライバーのセットアップ

driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。

### ドライバー インストール ユーティリティを使用したドライバーのインストール

このセクションでは、必要な SAP Java Connector のインストール方法を説明しました。このプロセスでは、必要な SAP Java Connector を自動的にダウンロード、インストール、設定するスクリプトを実行します。また、必要に応じて SAP Java Connector の更新やアンインストールを行うスクリプトを実行することもできます。

### インストールの準備

* データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。

  Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。

  python3 --version

* SAP Support Portal から、SAP Java Connector &lt;version&gt; 「sapjco&lt;version&gt;.zip」をダウンロードします。サポートされているバージョンは、/opt/qlik/gateway/movement/drivers/manifests/sapodp.yaml の binary-artifacts にあります。ダウンロードが完了したら、ファイルを次の場所にコピーします。

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

### SAP Java Connector のインストール

SAP Java Connector をダウンロードしてインストールするには:

1. Data Movement gateway サービスを停止します。

   sudo systemctl stop repagent

2. 必要に応じて、サービスが停止されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: inactive (dead) since &lt;timestamp&gt; 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. インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。

   sudo systemctl start repagent

8. 必要に応じて、サービスが開始されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: active (running) since &lt;timestamp&gt; ago

### SAP Java Connector の更新

提供された SAP Java Connector をインストールする前に前のバージョンの SAP Java Connector をアンインストールしたい場合は、更新コマンドを実行します。

SAP Java Connector をダウンロードして更新するには:

1. Data Movement gateway サービスを停止します。

   sudo systemctl stop repagent

2. 必要に応じて、サービスが停止されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: inactive (dead) since &lt;timestamp&gt; 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. インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。

   sudo systemctl start repagent

8. 必要に応じて、サービスが開始されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: active (running) since &lt;timestamp&gt; ago

### SAP Java Connector のアンインストール

SAP Java Connector をアンインストールする場合は、アンインストール コマンドを実行します。

SAP Java Connector をアンインストールするには:

1. このコネクタを使用するように構成されているすべてのタスクを停止します。

2. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

   opt/qlik/gateway/movement/drivers/bin

3. 次のコマンドを実行します:

   構文:

   ./uninstall sapodp

   SAP Java Connector がアンインストールされます。

### ドライバーの手動インストール

自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。

SAP Java Connector 3.x (64-bit) for Linux を https://support.sap.com/en/product/connectors/jco.html からダウンロードします。

次に、シェル プロンプトを開き、次の手順を実行します。

1. Data Movement gateway サービスを停止します。

   sudo systemctl stop repagent

2. 必要に応じて、サービスが停止されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. 作業ディレクトリを opt/qlik/gateway/movement/bin に変更してから、次のコマンドを実行します。

   source arep\_login.sh

   これにより、データ移動 ゲートウェイ インストール パスが設定されます。

4. ダウンロードしたファイルを任意のフォルダーに解凍します。

   フォルダーには、Sapjco3.jar および libsapjco3.so ファイルが含まれている必要があります。

5. これらのファイルを Data Movement gateway インストール ディレクトリの下の次の場所にコピーします。

   &lt;Data Movement gateway\_Install\_Dir&gt;/endpoint\_srv/endpoints/SAP。

6. Data Movement gateway サービスを起動します。

   sudo systemctl start repagent

7. 必要に応じて、サービスが開始されたことを確認します。

   sudo systemctl status repagent

   ステータスは次のようになっているはずです。

   Active: active (running) since &lt;timestamp&gt; ago

情報メモ

Java コネクタ ライブラリがインストールされ、Data Movement gateway サービスが再起動されるまで、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) を開き、 [Create Configuration] (構成を作成) を選択します。

構成の作成には次の手順が含まれます。

1. [Specify General Data] (一般データを指定) タブで、次の情報を入力します。

   * 構成名: 構成の名前を指定する必要があります。この名前は、ターゲット システムで自動的に作成されるスキーマに使用されます。

   * 説明 (任意): 必要に応じて、構成の説明を指定します。

2. [Specify Source System] (ソース システムを指定) タブで、 [RFC Connection] (RFC 接続) オプションを選択し、次の情報を入力します。

   * RFC 宛先: [NONE] (なし) と入力します。
   * Allow Multiple Usage (複数の使用を許可): このオプションを選択します。

3. [Specify Target System] (ターゲット システムを指定) タブで、 [その他] オプションを選択し、次の情報を入力します。

   * シナリオ: ドロップダウン リストから [Operational Data Provisioning (ODP)] を選択します。
   * キュー エイリアス: 名前を指定します。

4. [ Specify Transfer Settings] (転送設定を指定) タブで、使用中の環境に適した転送設定を指定します。[Job Options] (ジョブ オプション) で、少なくとも 5 つのデータ転送、初期ロード、計算ジョブを設定することをお勧めします。

5. [Review and Create] (確認と作成) タブで設定を確認し、構成を作成します。

6. [必要な権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-ODP/sap-odp-permissions.htm) を取得します。

構成を作成したら、関連するコネクタ設定の構成に進むことができます。