Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
データ接続と統合SAPSAP アドオンConnector のインストール

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Palantir Foundry Connector 2.0 for SAP Applications をインストールする

Palantir Foundry Connector 2.0 for SAP Applications（「コネクター」）は、SAINT（SAP Add-On Installation Tool）を使用してインストールする SAP アドオンとして提供されます。このアドオンは、次のファイル名パターンを持つ SAR 形式で提供されます: FOUNDRY-SAPCONN-INST-SP00SPXX.SAR

SP00SPXX は、SP00 から SPXX までのインストールファイルを表し、XX はサポートパッケージレベルです。

BW/4HANA または S/4HANA にコネクターをインストールする場合は、Attribute Change Packages をインストールに含めてください。SP22 以降では、これらのパッケージはインストールファイルに含まれています。

コネクターのセットアップに必要な手順の概要は次のとおりです。

  1. インストールパッケージをダウンロードします。
  2. SAINT を使用してコネクターアドオンをインストールします。
  3. SU01 で Foundry 用のシステムタイプ（タイプ B）の技術ユーザーを作成します。このユーザーは、システム間の呼び出しのために Foundry エージェントが使用するもので、SAP GUI へのログインには使用しません。後で OAuth 2.0 によるユーザーに紐づくライトバックを有効にする予定がある場合、ユーザータイプは必ずシステムにしてください。
  4. インストール後ウィザードを実行します。

インストールには、異なる2種類の SAP ユーザーが関わります。このページでは、それぞれを次のように呼びます。

用語定義
実行ユーザー（ベーシス管理者）対話的にログインして SAINT、インストール後ウィザード、および PFCG を実行する、人間の SAP 管理者（ダイアログユーザー）です。SAINT / PFCG / SU01 の権限が必要です。
Foundry 技術ユーザー対話型ログオンを行わず、Foundry エージェントが RFC/HTTPS 呼び出しに使用するシステムタイプ（タイプ B）のユーザーです。インストール後ウィザードによって割り当てられる /PALANTIR/* ロールを付与されます。

前提条件

  • SAP_BASIS（SAP NetWeaver と SAP S/4HANA の両方のシステムに適用される技術コンポーネントのバージョン）7.4 SP5 以降

または

  • SAP_BASIS 7.5（最小 SP レベルの制限なし）

これらは最小バージョンです。コネクターは、SAP_BASIS 8.x（たとえば SAP_BASIS 816）に基づく SAP S/4HANA リリースを含め、これより上位のすべての SAP_BASIS バージョンをサポートします。

次の SAP ノートを読み、該当する場合は関連する手順に従ってください。

  • SAP OSS ノート 2645739 - ABAP アドオンの OCS パッケージにデジタル署名がありません

コネクターアドオンをインストールする

  1. SAINT を使用する権限を持つユーザーで、SAP システムのクライアント 000 にログインします。
  2. SAINT トランザクションを実行します。
  3. FOUNDRY-SAPCONN-INST-SP00SPXX.SAR を SAP サーバーにインポートします。インストールパッケージ > パッケージを読み込む > フロントエンドからを選択します。

一部の SAINT/SPAM バージョンでは、SPAM または SAINT の設定がインストールプロセスに影響することがあります。インポート中のチェックセクションの署名チェックを実行できません。SAP ノート2520826が実装されていませんという項目を無効にしてください。一部の SPAM バージョンでは、この項目に説明がありませんが、その場合も無効にしてください。

  1. 開始を選択してインストールを開始します。
  2. 利用可能なパッケージが一覧表示されます。表示されない場合は、フィルターアイコンをクリックしてフィルターを無効にします。
  3. 続行を選択して次のステップに進みます。
  4. コネクターのインストールでは、PALANTIR と PALCONN を選択します。
  5. 続行を選択してサポートパッケージの選択に進みます。
  6. 一覧から利用可能な最も高いレベルのサポートパッケージを選択し、両方のコンポーネントで同じ SP レベルが選択されていることを確認してください。
  7. インストールキューを確認し、続行をクリックします。
  8. 準備フェーズではダイアログモードで続行を、その他のフェーズではバックグラウンドで直ちに続行を選択し、インストールを開始します。

インストール中に警告が表示された場合は、警告メッセージに記載された手順に従って解決してください。ほとんどの場合、コネクターおよび Remote Agent のインストールでは警告メッセージを無視できます。特に、「未完了のデータ抽出リクエスト」という見出しの警告メッセージは無視できます。インストールでは DDIC 構造を変更しないため、未完了のデータ抽出リクエストが終了することはありません。

  1. 完了を選択してインストールを完了します。

インストール後ウィザードを実行する

コネクターのインストール後ウィザードは、コネクターアドオンのインストール後のセットアップ作業を簡素化します。インストール後の作業と設定を行うには、ベーシス管理者（作業を行うユーザーであり、Foundry テクニカルユーザーではありません）が SAP GUI 経由でメインクライアント（000 ではありません）にログインします。インストール後ウィザードはその管理者のセッションで実行され、Foundry テクニカルユーザーを設定します。Foundry テクニカルユーザー自体が対話的にログインすることはありません。インストール後ウィザードには、トランザクションコード /n/PALANTIR/POST_INST またはコネクターメニュー（トランザクションコード: /n/PALANTIR/）からアクセスできます。

ウィザードのステップ

10個のステップがあり、まとめて実行することも、個別に実行することもできます。インストールを完了するには、すべてのステップを有効にする必要があります。SLT のインストールでない場合は、SLT 設定を作成を無効にします。SLT 設定については、ステップ7で詳しく説明します。

作業を行うユーザー（ウィザードを実行するベーシス管理者）には、Foundry テクニカルユーザーに必要な権限ロールを割り当てるための十分な権限が必要です。このプロセスは、トランザクションコード SU01 によるユーザーの管理と同様です。ユーザーへの割り当てを別途行う場合は、Foundry ユーザーにロールを割り当てとヘルスチェックを実行を無効にします。

1. アンインストール補正を実行する

このステップでは、コネクターのオブジェクトディレクトリ内の SAP パッケージを修正するバックグラウンドプログラムを実行します。この補正プログラムは、悪影響を及ぼすことなく、いつでも実行できます。

2. SICF サービスを有効化する

このステップでは、データ転送に必要な2個のコネクターサービスを有効化します。必要に応じて、トランザクションコード SICF を使用して手動で行うこともできます。対象の2個のサービスは次のとおりです。

  • /default_host/sap/palantir
  • /default_host/sap/opu/odata/palantir

3. ロールを生成する

コネクターには、インストール時にインポートされる独自のロールがあります。これらのロールは、インストール後も未生成のステータスのままです。必要に応じて、トランザクションコード PFCG のユーティリティ > 一括生成を使用して、これらのロールを手動で一括生成できます。

  • /PALANTIR/CONTENT_BEX_ALL
  • /PALANTIR/CONTENT_CDS_ALL
  • /PALANTIR/CONTENT_HANA_ALL
  • /PALANTIR/CONTENT_DM_ALL
  • /PALANTIR/CONTENT_EXT_ALL
  • /PALANTIR/CONTENT_FUNCTION_ALL
  • /PALANTIR/CONTENT_INFOPROV_ALL
  • /PALANTIR/CONTENT_SLT_ALL
  • /PALANTIR/CONTENT_TABLE_ALL
  • /PALANTIR/CONTENT_TCODE_ALL
  • /PALANTIR/DEBUG_USER
  • /PALANTIR/MONITORING
  • /PALANTIR/OAUTH_CLIENT
  • /PALANTIR/SERVICE_SLT
  • /PALANTIR/SERVICE_SLT_740
  • /PALANTIR/SERVICE_USER

4. Foundry テクニカルユーザーにロールを割り当てる

ステップ3のすべての Palantir ロールが、選択画面で定義された SAP ユーザーに割り当てられます。このユーザーは、作業を行うユーザーではなく、上記の概要手順のステップ3で作成したシステムタイプの Foundry テクニカルユーザーである必要があります。

このステップで、ロールの割り当て、ユーザー詳細を取得できないこと、または権限不足に関するエラーメッセージが表示される場合、作業を行うユーザーに十分な権限がないことが示唆されます。この場合は、エラーメッセージの案内に従って作業を行うユーザーの権限を修正し、プログラムを再度実行します。

このステップで Foundry テクニカルユーザーがロックされていることを示すエラーメッセージが表示される場合は、ロックの所有者に連絡してロックを解除してもらってから、プログラムを再度実行してください。

5. デフォルトパラメーターを管理する

これらの選択項目を使用して、リソースチェックおよび継続的なリソースチェックのパラメーターを設定できます。選択画面にはデフォルト値が表示され、要件に応じて変更できます。この項目を選択してプログラムを実行すると、選択したパラメーターに従ってコネクターのパラメーターが変更されます。これらのパラメーターは、トランザクションコード /n/PALANTIR/PARAM を使用して管理することもできます。

パフォーマンスパラメーターについて詳しく説明します。

6. ICM 設定を確認する

このステップでは、ICM 設定、ホスト名、ポート（HTTP および HTTPS 用）を確認し、接続のテストに使用できる URL を作成します。

7. SLT 設定を作成する

このステップは、SAP SLT Replication Server 経由で接続する場合にのみ該当します。

コネクターが SAP SLT インスタンス上にインストールされている場合、インストール後ウィザードで新しい SLT 設定（ODP）を作成できます。トランザクションコード LTRC を使用して SLT 設定を作成することもできます。

SLT 設定のパラメーターは次のとおりです。

パラメーター説明
コンテキスト名一意の設定名。
コンテキストの説明SAP トランザクション LTRC および Foundry でユーザーに表示されるコンテキストの説明。
データ転送ジョブデータ転送ジョブの数。
初期読み込みジョブ初期読み込み用のジョブの数。
計算ジョブ初期読み込みの範囲計算用の計算ジョブの数。
権限グループデフォルトでは権限グループはありません。
レプリケーションモード1 - リアルタイム（デフォルト）、2 - 時間間隔、3 - 時間スケジュール、4 - オンデマンド。
ソース RFC 宛先論理宛先 - ソースシステムの RFC 宛先名。
単一クライアントから読み取り単一のクライアントからデータを読み取る場合に有効にします。
複数使用を許可複数使用を許可する場合に有効にします。

8. ヘルスチェックを実行する

コネクターには、インストール先の SAP システムの正常性を測定するためのさまざまなメトリクスがあります。コネクターは、次のカテゴリーでヘルスチェックを実行します。

  • AGENT: RFC 接続とソースシステムの権限を確認します。ゲートウェイ経由のリモート接続の場合にのみ該当します。
  • AUTHORIZATION: SM53 で Foundry ユーザーに不足している権限がないかを確認します。
  • CONNECTOR: コネクターのハウスキーピングジョブがシステムでスケジュールされているかを確認します。
  • ROLE: Foundry ユーザーのロールと権限プロファイルを確認します。
  • SLT: SLT 設定が正しく正常であるかを確認します。たとえば、BADI_Implementation がアクティブか、コンテキストがアクティブか、SLT ハウスキーピングジョブがスケジュールされているか、ソースシステムへの接続が機能しているかを確認します。

9. ブラウザーのテスト URL

インストール後は、Web ブラウザーで接続テストを実施して、コネクターが正常に動作しているかを確認することが重要です。必要な URL は、インストール後ウィザードによって生成されます。

いくつかの異なるテストを利用できます。1番目と2番目のテストはコネクターサービスへの同期呼び出しで、3番目と4番目のテストはバッチ抽出用です。

  • 基本情報： コネクターの基本情報ページ。
  • T000 テーブル：table オブジェクトタイプによる T000 テーブルの直接抽出。
  • T000 のページング初期化：table オブジェクトタイプによる T000 テーブルのバックグラウンド抽出の初期化。
  • T000 のページング読み取り、ページ1： 直前の URL で初期化されたプロセスの最初のページが取得されます。

10. Foundry 用ソース定義テンプレート

「Foundry のソース定義」を選択してプログラムを実行すると、新規タブ「ソース定義」が表示され、Foundry のソース設定の詳細を確認できます。

セキュリティと権限ロール

詳細については、権限ロールを参照してください。

パフォーマンスパラメーター

コネクターには、Foundry に対応するためのシステムリソースが不足しているときに、不要なシステム負荷を回避するための次のパフォーマンスパラメーターがあります。これらの設定は ST06 の値と比較されます。以下のデフォルトのパラメーター値は、最新バージョンのコネクターを新規インストールした場合の値です。

  • MEMORY_FREE： 空きメモリーの割合です。この割合がシステムのデフォルト値またはユーザー定義値を下回ると、抽出が停止します。コネクターのデフォルト値は 5% です。
  • CPU_IDLE： CPU のアイドル状態の割合です。コネクターのデフォルト値は 5% です。
  • CPU_USER： ユーザートランザクションによる CPU 使用率です。コネクターのデフォルト値は 80% です。
  • CPU_LOAD： CPU の合計使用率です。コネクターのデフォルト値は 80% です。

ST06 の主要指標は、SAP からコネクターに提供されます。仮想化の拡張監視が有効になっている場合、オペレーティングシステム固有の情報に仮想化固有の情報が追加されます。これにより ST06 の数値が影響を受け、コネクターが誤った判断をする可能性があります。詳細については、SAP OSS 記事2266266を参照してください。

初期のシステムデフォルト値は、意図的に保守的に設定されています。これらをオーバーライドして制限を緩和する場合は、/n/PALANTIR/PARAM トランザクションで設定を管理します。

次のパラメーターは、リソースチェックを有効または無効にするために使用します。

パラメーターIDパラメーター名パラメーター値デフォルト説明
SYSTEMCPU_CHECKTRUE / FALSETRUECPU チェックを有効または無効にします。
SYSTEMMEMORY_CHECKTRUE / FALSETRUEMEMORY チェックを有効または無効にします。
SYSTEMRESOURCE_CHECKTRUE / FALSETRUERESOURCE チェックを有効または無効にします。FALSE の場合、_すべて_のチェックが無効になります。TRUE の場合、ほかのパラメーター（CPU_CHECK と MEMORY_CHECK）がチェックされます。
SYSTEMCONTINUOUS_RESOURCE_CHECKTRUE / FALSETRUEすべてのリクエスト（初期化リクエストとすべてのページングリクエスト）に対してリソースチェックを有効にします。FALSE の場合、リソースチェックは初期化リクエストに対してのみ実行されます。
SYSTEMPROCESS_CHECKTRUE / FALSETRUE許可されるワークプロセスの最小数のチェックを有効にします。PROCESS_MIN_BG および PROCESS_MIN_DIA と連動します。
SYSTEM_THRESHOLDPROCESS_MIN_BG数値1SAP アプリケーションサーバーで利用可能である必要があるバックグラウンドプロセスの最小数です。
SYSTEM_THRESHOLDPROCESS_MIN_DIA数値1SAP アプリケーションサーバーで利用可能である必要があるダイアログプロセスの最小数です。

実際の値とパラメーター値を確認するには、ブラウザーからシステムオブジェクトとリソース関数を使用できます。

https://<sap-server>:<port>/sap/palantir/system?obj=resource

この URL は SAP システムの URL です。このリソースにアクセスできることを確認してください。

出力は次の形式になります。

MSGTYP	MSGTXT
S	Current CPU_LOAD value : 0,01 | system threshold value : 95,00
S	Current CPU_USER value : 1,00 | system threshold value : 0,01
S	Current CPU_IDLE value : 99,00 | system threshold value : 5,00
S	Current free memory percentage : 24,22 | system threshold value : 11,00
S	Current PROCESS_MIN_BG value : 5 | system threshold value : 2
S	Current PROCESS_MIN_DIA value : 9 | system threshold value : 2
S	Resource check is Active
S	CPU Load check is Active
S	Memory consumption check is Active
S	Process availability check is Active