1. DP Agent のインストール

KABATA_Kimikazu · ‎04-03-2024

本ブログシリーズでは、SAP S/4HANA(以下、「S/4」) とSAP Datasphere (以下、「Datasphere」) とのデータ連携の設定について解説します。

今回はDP Agent のインストールから設定までを解説します。

1. DP Agent のインストール

Datasphereのライセンスをお持ちのお客様はSAP サポートポータルから、検証環境 (SAP BTPのFree Tierを利用)で試したい方はSAP Development ToolsのダウンロードサイトからDP Agentのソフトウェアをダウンロードしてください。どちらもソフトウェアは無償で利用可能です。

※ 正確には、DP AgentのソフトウェアのライセンスはDatasphereを購入しているお客様であれば追加費用は発生しません。
※ DP Agent 用サーバーの最小必要スペックは下記の通りです。

16GBメモリー、30GBのディスク容量、4 CPU Core

※ 最新の動作環境 / サイジング情報については PAM(Product Availability Matrix)をご確認ください。

■SAP サポートポータル

ダウンロードファイルの辿り方:

Support Packages & Patches > By Alphabetical Index (A-Z) > H > SAP HANA SDI > SAP HANA SDI<version_number> > Comprised Software Component Versions > HANA DP AGENT <version_number>

■SAP Development Tools のサイト

ダウンロードしたファイルを任意のフォルダ(ディレクトリ)に展開(解凍)し、展開先のフォルダの直下のhdbsetup.exeを選択し、管理者として実行してインストールを開始します。

インストール先のフォルダを指定します。デフォルトのままでも良いのですが、1台のサーバーに複数のDP Agent をインストールすることが可能なので、フォルダに枝番を付加しても良いでしょう。今回の例では「C:\user\sap\dataprovagent01」としています。

次にDP Agent 名をつけますが、システム内で名前が重ならないようにしてください。「ホスト名+枝番」のような命名が良いかと思います。

DP AgentをインストールするOSのユーザ/パスワードを指定します。Windows環境の場合は、OSユーザー名は Domain\User を入力します。Domainに参加していない場合は、Hostname\User を入力します。あとは、ウィザードのガイド通りに進んでインストールは完了です。

2. IP許可リストの設定

DP Agent の設定を行う前に、DP Agent がDatasphereにアクセスできるように、DatasphereでIPアドレスの許可リストを設定します。

また、多くの企業はProxy サーバ経由で外部ネットワークのシステムに接続するので、その場合はProxy サーバ (ゲートウェイサーバ)の公開IPアドレスを設定してください。
※ 詳しくは社内のネットワーク管理者にご確認ください。

メニューの「システム」 > 「設定」を選択し、上のメニューから「IP許可リスト」 > 「信頼されたIP」を選択します。

「追加」のボタンをクリックし、DatasphereにアクセスするDP Agent のIPアドレスを指定します。

IPアドレスの指定の仕方については、こちらのマニュアルを参考にしてください。設定が終わったら「保存」ボタンをクリックしてください。

※ 更新の反映には若干の時間が掛かりますので、少し時間をおいてから次のステップに進んでください。

3. DatasphereでのDP Agentの登録

下記のマニュアルを確認しながら作業を進めてください。
データプロビジョニングエージェントの接続および設定

メニューの「システム」 > 「設定」を選択し、上のメニューから「データ統合」を選択し、「プラスマークのタイル」をクリックします。

まず、DP Agent 名を指定しますが、DP Agentのインストールの時に指定したエージェント名と同じ名前か、関連のある名前にすると管理がラクチンかと思います。

次の画面ではDatasphereの内部のSAP HANA Cloud データベースのホスト名やポート番号、そしてエージェントのメッセージング用のSAP HANA Cloudのユーザとパスワードが表示されますので、これらの情報をコピーしておいてください。

※ Screenshotだけでは後で入力間違いをする可能性があるので、コピーがお薦めです。

一旦、「閉じる」ボタンをクリックして、この画面を閉じます (この設定は保存されます) 。

4. DP Agent から Datasphere への接続設定

DP AgentからDatasphereへの接続設定を行います。

DP Agent がインストールされているサーバにログインし、管理者権限でコマンドプロンプトを起動します。Windowsの場合はウインドウズメニューボタンをクリックした後、「cmd」と入力し、コマンドプロンプトを「管理者として実行」してください。

DP Agent の設定ツールを利用して接続設定を行います。

ここでの注意ポイントは、先ほどDatasphereの画面で表示されたDatasphereへの情報を正確に入力することです。

特にホスト名やパスワードに関しては、複雑な文字列なのでコピーした文字列を正確にペーストしてください。画面上にはペーストしたパスワードは表示されません。自分の指先のクリックの感覚を信じて慎重に作業を進めてください。設定が終わったら、DP Agentを再起動します。

※ 注意: DP Agentのバージョンによって選択するメニュー番号が違う場合があります。選択する項目を確認して、該当するメニュー番号を指定してください。

※ 下記は設定のサンプルです。実際の環境に合わせてPoxy Server の設定など、適切なオプションを選択してください。

<フォルダを移動>
C:\Users\Administrator>cd C:\usr\sap\dataprovagent01\bin
<DP Agentを起動>
C:\usr\sap\dataprovagent01\bin>dpagent_servicedaemon_start.bat
<DP Agentの設定ツールを起動>
C:\usr\sap\dataprovagent01\bin>agentcli.bat --configAgent
Configuring the Agent at the following location:
C:\usr\sap\dataprovagent01

Initializing DPAgent Configuration Tool
************************************************************
                 DPAgent Configuration Tool
************************************************************
           :
7. SAP HANA Connection
           :
************************************************************
Enter Option:7
************************************************************
                    SAP HANA Connection
************************************************************
            :
2. Connect to SAP Datasphere via JDBC
            :
************************************************************
Enter Option:2
************************************************************
             Connect to SAP Datasphere via JDBC
************************************************************
Press "Enter" button to keep default or skip an optional setting.
If a setting cannot be skipped, that means it is required.
************************************************************
Enter Agent Name:
DPA_SAPJ001
Enter Use encrypted JDBC connection[true]: Valid options: true|false
true
Enter Host Name:
23b3fd16xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.hanacloud.ondemand.com
Enter Port Number:
443
Enter Use Proxy Server[false]: Valid options: true|false
false
Enter Use X509 Client Certificate for Agent Messaging User[false]: Valid options: true|false
false
Enter HANA User Name for Agent Messaging:
DWC_DP_MSG_DPA_SAPJ001
Enter HANA User Password for Agent Messaging:
<パスワードは表示されません>
Enter HANA User Password for Agent Messaging:  (confirm)
<パスワードは表示されません>
Do you want to save these connection settings? Any existing settings will be overwritten.
Enter [false] if you do not want to save or [true] to save.
true
Agent connection settings for SAP Datasphere have been saved. Restart the agent for the changes to take effect.

Press Enter to continue...

<この後、DP Agentの再起動をします>

************************************************************
                    SAP HANA Connection
************************************************************
    :
b. Back
************************************************************
Enter Option:b
Initializing DPAgent Configuration Tool
************************************************************
                 DPAgent Configuration Tool
************************************************************
       :
2. Start or Stop Agent
       :
************************************************************
Enter Option:2
************************************************************
                    Start or Stop Agent
************************************************************
       :
2. Stop Agent Using Service
       :
************************************************************
Enter Option:2
Stopping agent service. Command: sc stop SAP_HANA_SDI_Agent_Service_Daemon_SAPJ01
Stop Service return code: 0
Agent was shutdown gracefully

Press Enter to continue...

************************************************************
                    Start or Stop Agent
************************************************************
1. Start Agent Using Service
              :
************************************************************
Enter Option:1
Agent service daemon location: C:\usr\sap\dataprovagent01\bin\DPAgentServiceDaemon.exe
Starting agent service. Command: sc start SAP_HANA_SDI_Agent_Service_Daemon_SAPJ001
Start Service return code: 0
Cannot connect to agent. Trying again after 3 seconds
Agent was started successfully

Press Enter to continue...
************************************************************
                    Start or Stop Agent
************************************************************
   :
b. Back
************************************************************
Enter Option:b

Initializing DPAgent Configuration Tool

<DP Agentのステータスを確認します>

************************************************************
                 DPAgent Configuration Tool
************************************************************
1. Agent Status
        :
************************************************************
Enter Option:1
************************************************************
Agent                    Status: Running
                         Listener port: 5050
                         Admin port: 5051
                         Agent Name: DPA_SAPJ001
HANA Connection          Server: 23b3fd16xxxxxxxxxxx.hanacloud.ondemand.com
                         Port: 443
                         Protocol: JDBC
                         Agent Admin HANA user:
************************************************************

Press Enter to continue...

************************************************************
                 DPAgent Configuration Tool
************************************************************
    :
q. Quit
    :
************************************************************
Enter Option:q
0

C:\usr\sap\dataprovagent01\bin>

5. Datasphere でのDP Agent の追加設定

DP AgentがDatasphereに接続しているかステータスを確認します。

ステータスが「CONNECTED」になったことを確認したら、「・・・」 > 「編集」を選択し、ABAP AdapterとHANA Adapterをチェックします。

これでDP Agentの設定は完了です。

※ 参考 : S/4とDatasphereのデータ連携は、ABAP Adapterを利用することを前提にしていますが、ケースによっては、直接、S/4配下のSAP HANAデータベースにアクセスすることもありますので、ここではHANA Adapterにもチェックを入れています。

6. DP Agentのトラブルシューティング

DP Agentのトラブルシューティングは下記のマニュアルを参照してください。
データプロビジョニングエージェントのトラブルシューティング

圧倒的に多い接続トラブルは、Proxyサーバやファイアウォールの設定です。
ファイアウォールでアクセス可能な外部ネットワークのサーバ情報として、SAP HANAデータベースの IPアドレスやドメインを下記の情報を参考に設定してください。社内のネットワーク管理者に相談して設定を進めることをお薦めします。
SAP HANA Cloud : ドメインおよび IP 範囲
※ 最新情報は上記のマニュアルをご確認ください。

SAP S/4HANAとSAP Datasphereのデータ連携 : DP Agentの設定

1. DP Agent のインストール

2. IP許可リストの設定

3. DatasphereでのDP Agentの登録

4. DP Agent から Datasphere への接続設定

5. Datasphere でのDP Agent の追加設定

6. DP Agentのトラブルシューティング

Get Your SAP HANA Idea Incubator Badge Today!

SCN Mission - SAP HANA Quiz Challenge is now retired

Share your #HANAStory and Win