2 環境を設定する
この章の内容は次のとおりです。
2.1 始める前に
始める前に、次のことに注意してください。
2.1.1 システム要件と動作要件
インストールを実行する前に、システム要件および動作要件のドキュメントを読んで、使用する環境がインストールする製品の最低インストール要件を満たすことを確認する必要があります。
Oracle Data Integratorの要件は、「Oracle Data Integratorのインストールと構成」に記載されています。
Oracle Data Integrator SAP ABAP - BWアダプタ固有の要件は次のとおりです。
-
Oracle Data Integrator 11.1.1.7.0以上
-
アダプタとの互換性があるJava Connector (JCo)バージョンを使用する必要があります。サポートされているJCoバージョンのリストは、My Oracle Supportで入手できる互換性マトリックスにあります。最低バージョンとしてJCo 3.0.2が必要です。
-
Oracle Data IntegratorおよびJCoの両方と互換性があるJVMバージョンを使用する必要があります。JCoの前提条件として、JVM 1.5以上のバージョンが必要です。
-
このコネクタは、SAPシステムからODIエージェントにデータを転送するための転送モードとして、共有ディレクトリを使用したデータ転送とFTPを経由するデータ転送の2つをサポートしています。詳細と制約については、『Oracle Data Integratorアプリケーション・アダプタ・ガイド』のファイル転送の考慮事項に関する項を参照してください。ファイル転送モードの選択に応じて、次の要件を満たす必要があります。
-
共有ディレクトリ経由のデータ転送(推奨される転送方法): LKM SAP BW to Oracle (SQLLDR)を使用するには、SAPシステムとODIエージェントとの間で共有されるフォルダが必要です。SAPアプリケーション・サーバーでは、SAPシステムとODIエージェント・マシンからアクセス可能なフォルダにデータを書き込むことでデータを転送します。これは通常、ODIエージェント・マシンのフォルダをSAPシステムと共有することで行われます。共有フォルダは、必ずしもODIエージェント・マシン上に置く必要はないことに注意してください。共有フォルダがODIエージェント・マシンとSAPシステムの両方からアクセス可能であるかぎりは、サード・マシン上に共有フォルダを置くこともできます。
ノート:
セキュリティ上の理由から、SAPフォルダをODIエージェントと共有することはできません。ODIエージェント・マシンのフォルダをSAPシステムと共有することのみ可能です。
共有フォルダは、SAPシステムにアクセスできる必要があります。基盤となるオペレーティング・システムのみへのアクセスでは不十分です。つまり、フォルダはSAPトランザクションAL11内で宣言される必要があり、その結果、フォルダはAL11内で正常に開かれます。
-
FTP経由のデータ転送: LKM SAP BW to Oracle (SQLLDR)を使用するには、データをSAP BWシステムからアップロードするためのFTPサーバーが必要です。このデータの読取りは、マッピングを実行するエージェントによって(このエージェントがFTPサーバー・マシン上で実行されている場合)ローカルで実行されるか、またはリモートで(このエージェントがFTPサーバーとは異なるマシン上にある場合)実行されます。このFTPサーバーは、SAP BWマシンとエージェント・マシンの両方からネットワーク経由でアクセスできる必要があります。
-
-
LKM SAP BW to Oracle (SQLLDR)のみ: エージェントを実行するマシン上にSQLLoaderが必要です。SQLLoaderは、SAP BWシステムから抽出されたデータをOracleステージング領域にロードするために使用されます。
2.1.2 SAPシステムへのODI SAPコンポーネントのインストールのリクエスト
ODI SAPアダプタは、いくつかのODI SAP RFCを使用してSAPシステムと通信します。これらのRFCは、SAP送信リクエストを使用してSAP Basisチームがインストールします。『Oracle Data Integratorアプリケーション・アダプタ・ガイド』のODI SAPコンポーネントのインストールに関する項に示す手順に従い、ODI SAPコンポーネントをインストールしてSAPユーザーに必要な認可を割り当てる場合は、SAP管理者に連絡してください。
2.1.3 FTPサーバー・アクセスの要求
この項は、FTPを使用したデータ転送を計画する場合にのみ適用されます。データ転送に共有ディレクトリを使用する場合、またはSAPシステムが次より古い場合は、この項をスキップできます。
-
SAP ECC6 EHP6以上
-
SAP BW/BI 7.4以上
次のステップは、このガイド内の後続のステップを実行する前に実行する必要があります。通常、これらのステップはSAP Basisチームによって実行されます。これらの設定手順を実行しないと、ODI SAP抽出ジョブの実行時にFTPが失敗します。
FTPサーバー・アクセスをリクエストするには:
- SAPサーバーにログインします。
- トランザクションSE16を実行します。
- 「表名」フィールドに「
SAPFTP_SERVERS
」と入力し、アイコンをクリックしてエントリを作成します。
- 「FTP_SERVER_NAME」フィールドにFTPサーバーのIPアドレスを入力します。
- 「FTP_Server_Port」フィールドにFTPサーバーのポートを入力します。
アイコンをクリックして保存します。
2.1.4 SAP接続情報の収集
SAP BWシステムに接続するには、SAP管理者に次の情報を要求する必要があります。
-
SAP BWシステムのIPアドレスまたはホスト名: IPアドレス/ホスト名は、SAPが実行されているホストに付与される技術的な名前です。
-
SAPユーザー: SAPユーザーとは、SAP BWシステムにログオンするためにユーザーに付与される、一意のユーザー名です。
-
SAPパスワード: ユーザーのログインに使用される、大文字と小文字を区別するパスワード。
-
SAP言語: 英語はEN、ドイツ語はDEなど、ログイン時に使用される言語コード。
-
SAPクライアント番号: SAPでクライアントと呼ばれる、自己完結型の単位に割り当てられた3桁の番号。クライアントは、トレーニング、開発、テスト、本番クライアントなどです。また、大企業の個々の部門を表す場合もあります。
-
SAPシステム番号: SAPインスタンスに割り当てられた2桁の番号。SAPインスタンスは、Web Application Server (WAS)とも呼ばれます。
-
SAPシステムID: 1つのランドスケープ内でのSAPシステムの一意の識別子(3文字)。
-
SAPトランスポート・レイヤー名: SAPランドスケープ内のトランスポート・レイヤーを一意に識別する文字列。これにより、ODIは、SAPでの後のデプロイメントでトランスポート・リクエストを作成できます。ここにデフォルト値がある場合でも、このトランスポート・レイヤー名は、SAP Basisチームからの提供を受ける必要があります。これを行わない場合、インストールの際、大幅な遅れにつながる可能性があります。
-
SAP BWバージョン: BW 3.5またはBI 7.0。
-
SAP文字セット: この文字セットが必要になるのは、SAPシステムがUNICODEシステムではない場合のみです。すべての文字セットのリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』のロケール・データに関する項を参照してください。たとえば、クロアチア語のデータの場合は
EE8ISO8859P2
です。UNICODEシステムの場合はUTF8
を使用します。 -
SAPルーター文字列: ルーター文字列値。これは、SAPシステムとODIネットワークの間にリモート接続がある場合にのみ必要です。
-
ロード・バランシングのためのSAPグループ・ログオン: ロード・バランシングには、SAPサーバー・ホスト、SAPサーバー・ポートおよびSAPサーバー・グループ情報が必要です。
-
SAP SNCログイン[X509証明書]: SNC X509証明書によるログインの場合に必要です。SNCログインには、パートナ名、クライアント名およびX509証明書値が必要です。
-
SAP SNCログイン[SSO]: SNC SSOがSAPユーザーでのみ使用されるログインである場合に必要です。このSAPユーザーは、SAPサーバーでSSO用に構成する必要があります。ここではパートナ名およびクライアント名の詳細が必要です。
ノート:
前述の接続データ(SAPルーター文字列、ロード・バランシングのためのSAPグループ・ログオン、SAP SNCログイン[X509証明書]およびSAP SNCログイン[SSO])はすべて必須であり、SAP管理者から要求されます。接続設定時には、SAP管理者にサポートを依頼することを検討することもできます。
2.2 共有フォルダ・セットアップの検証
共有フォルダの設定の検証は、共有ディレクトリを使用したデータ転送を計画する場合にのみ適用されます。FTP転送を使用する場合は、この項をスキップしてください。共有フォルダの設定の検証は、このガイド内の後続のステップを実行する前に実行する必要があります。通常、この検証はSAP Basisチームによって実行されます。
ステップ1: SAPアプリケーション・サーバーからのフォルダ・アクセスの検証
-
SAPGUIを起動します。
-
ODI SAPユーザーとパスワードを使用して、SAPシステムとクライアントに接続します。
-
トランザクションAL11に進みます。
-
共有フォルダを選択します。
-
共有フォルダをダブルクリックして、ディレクトリ宣言をテストします。
接続が正常である旨レポートされる必要があります。そうでない場合は、SAP basisチームに連絡してください。このテストに成功するまでは続行しないでください。
ノート:
SAPでは、OSユーザー<sid>admを使用して、AL11で宣言されたディレクトリに接続します。
-
画面を印刷します。
ステップ2: ODIエージェント・マシンからのフォルダ・アクセスの検証
2.3 FTPセットアップの検証
FTP設定の検証は、FTPを使用したデータ転送を計画する場合にのみ適用されます。データ転送に共有ディレクトリを使用する場合は、この項をスキップしてください。FTP設定の検証は、このガイド内の後続のステップを実行する前に実行する必要があります。通常、この検証はSAP Basisチームによって実行されます。
ステップ1: SAPFTPA接続先の検証
-
SAPGUIを起動します。
-
ODI SAPユーザーとパスワードを使用して、SAPシステムとクライアントに接続します。
-
トランザクションSM59に進みます。
-
TCP/IP接続を開きます。
-
SAPFTPA接続先を開きます。
-
「テスト接続」をクリックします。
接続が正常である旨レポートされる必要があります。そうでない場合は、SAP basisチームに連絡してください。このテストに成功するまでは続行しないでください。
-
画面を印刷します。
ステップ2: FTP接続のテスト
2.4 SAP権限の検証
この項では、主要なSAP権限の一部をテストする方法について説明します。必ずこれらのテストの検証に成功してから、このガイド内の後続のステップに進んでください。通常、この検証はSAP Basisチームによって実行されます。
次のステップを実行して、SAPユーザーに適切な開発者権限および開発者ライセンス・キーがあることを検証します。
- SAPGUIを起動します。
- ODI SAPユーザーとパスワードを使用して、SAPシステムとクライアントに接続します。
- トランザクションSE38に進みます。
- プログラム名のフィールドに、ZSAP_TESTなどの任意のサンプル・プログラム名を入力します。
- 「作成」をクリックします。
- トランザクションSE37およびSE11に対しても同様のテストを実行します。
トランザクションで、キーを要求されたりその他の認証メッセージが表示されたりすることなくプログラムの作成が許可された場合、SAPユーザーに適切な開発者権限およびライセンス・キーがあることが検証されます。それ以外の場合、SAP BasisチームがこのSAPユーザーをservice.sap.comに登録してライセンス・キーを取得するとともに、開発者権限の取得についても支援します。
2.5 SAPトランスポート・レイヤー名の検証
SAPコネクタでは、関数モジュールなどのSAPオブジェクトがSAP開発システムに作成されるため、開発が終了したら、これらの変更をQAおよび本番システムにトランスポートする必要があります。SAPの変更およびトランスポート・システムでは、SAPトランスポート・レイヤー名を使用して、変更のルートを特定します。トランスポート・レイヤーは、各開発クラスおよびそのクラス内のすべてのオブジェクトに割り当てられます。トランスポート・レイヤーによって次の点が決定されます。
-
どのSAPシステムで開発またはリポジトリ・オブジェクトへの変更が行われるか
-
開発作業の完了時に、グループ内の他のシステムにオブジェクトがトランスポートされるかどうか
統合ルートは、開発システムから品質保証システムまで、トランスポート・レイヤーZ<SID>
を介して作成されます。これは次に、顧客開発およびカスタマイズ用の標準トランスポート・レイヤーになります。
SAP標準オブジェクトのトランスポートの場合、統合ルートは、開発システムから品質保証システムまで、トランスポート・レイヤーSAP
を介して作成されます。
RKM SAP BWの初回実行前に正しいトランスポート・レイヤー名を指定することが重要です。次のステップを実行して、SAPランドスケープ内で定義されているトランスポート・レイヤーのリストを特定します。
- トランスポート・ドメイン・コントローラとして機能しているSAPシステム内のクライアント000に、トランザクションSTMSを経由してログインします。
- 「Overview」→「Transport Routes」を選択します。「Display Transport Routes」ダイアログが表示されます。
- 「Goto」→「Graphical Editor」を選択します。
- モードを切り替えるには、「Configuration」 > 「Display」 <-> 「Change」を選択します。
- SAPシステムの上にカーソルを置きます。
- 「Edit」→「System」→「Change」を選択します。「Change System Attriburtes」ダイアログが表示されます。
- 「StandardTransport Layer」タブを選択します。
- SAPシステムのトランスポート・レイヤーを変更します。
- 異なるトランスポート・レイヤーのリストが結果として表示されます。
デフォルトで、RKMオプションSAP_TRANSPORT_LAYER_NAMEはSAP
に設定されます。どのトランスポート・レイヤーを使用するかは、SAP Basis管理者に問い合せてください。このトランスポート・レイヤー名は、SAP_TRANSPORT_LAYER_NAME RKMオプションで設定する必要があります。不正なまたは無効なトランスポート・レイヤー名を使用すると、インストール・プロセス時に重大な遅れが生じます。
2.6 Oracle Data Integratorのインストール
このプロジェクトを開始する前に、Oracle Data Integratorをインストールおよび構成する必要があります。詳細は、Data Integratorスタート・ガイドおよびOracle Data Integratorのインストールと構成を参照してください。
2.7 Oracle DBターゲットのインストールと構成
このプロジェクトでは、マッピングのターゲットおよびステージング領域としてOracleデータベース・エンジンを使用します。例として、Oracle XEデータベースをOracle Technology Network (OTN)からダウンロードできます。このデータベースをインストールして構成します。
このプロジェクトのターゲットとなるOracle表は、次のスクリプトを使用して作成できます。
-- Create demo target schema CREATE USER ODI_SAP_DEMO IDENTIFIED BY ODI_SAP_DEMO DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP; GRANT CONNECT, RESOURCE TO ODI_SAP_DEMO; -- Create demo target tables -- For ODS/DSO CREATE TABLE ODI_SAP_DEMO.W_PURCH_DS ( PO_GUID VARCHAR2(100), ORDER_ITEM_GUID VARCHAR2(100), ACC_ASS_GUID VARCHAR2(100), GUIDE_CONTRCT VARCHAR2(100), ORDER_QUANT NUMBER, NET_PRICE NUMBER, PRICE_UNIT CHAR(5), NO_OF_PURCH_ODR NUMBER); ALTER TABLE ODI_SAP_DEMO.W_PURCH_DS ADD CONSTRAINT PK_W_PURCH_DS PRIMARY KEY (PO_GUID); -- For INFO OBJECT CREATE TABLE ODI_SAP_DEMO.W_ACCNT_VENDR_DS ( VENDOR CHAR(10), PCOMPANY CHAR(10), PHONE CHAR(20), PLANT CHAR(10), STREET VARCHAR(50), MED_DESC VARCHAR(100)); ALTER TABLE ODI_SAP_DEMO.W_ACCNT_VENDR_DS ADD CONSTRAINT PK_W_ACCNT_VENDR_DS PRIMARY KEY (VENDOR); -- For INFO OBJECT HIERARCHY CREATE TABLE ODI_SAP_DEMO.W_GL_ACCOUNT_HIER_DS ( HIER_NAME CHAR(50), NODEID NUMBER(20), INFOOBJECT_NAME CHAR(80), NODENAME CHAR(80), TLEVEL NUMBER(5), PARENTID NUMBER(20), CHILDID NUMBER(20),NEXTID NUMBER(20)); ALTER TABLE ODI_SAP_DEMO.W_GL_ACCOUNT_HIER_DS ADD CONSTRAINT PK_W_GL_ACCOUNT_HIER_DS PRIMARY KEY (HIER_NAME, NODEID); -- For INFO OBJECT INTERVAL HIERARCHY CREATE TABLE TARGET_INTERVAL_HIERARCHY ( RSHIENM VARCHAR2(30 BYTE), NODEID NUMBER(8), PARENTID NUMBER(8) INTERVL VARCHAR2(1 BYTE) LEAFFROM VARCHAR2(60 BYTE), LEAFTO VARCHAR2(60 BYTE), VERSION VARCHAR2(3 BYTE), CHRT_ACCTS VARCHAR2(4 BYTE), GL_ACCOUNT VARCHAR2(10 BYTE), BAL_FLAG VARCHAR2(1 BYTE), GLACCEXT VARCHAR2(18 BYTE), INCST_FLAG VARCHAR2(2 BYTE) ) -- For INFO CUBE CREATE TABLE ODI_SAP_DEMO.W_VENDR_BAL_DS ( OCOMP_CODE CHAR(6), OCREDITOR CHAR(10), ORC_ACCOUNT CHAR(10), TOT_DEBT_POST NUMBER, TOT_CR_POST NUMBER, CUMULATIVE_BAL NUMBER); ALTER TABLE ODI_SAP_DEMO.W_VENDR_BAL_DS ADD CONSTRAINT PK_W_VENDR_BAL_DS PRIMARY KEY (OCOMP_CODE); -- For INFO CUBE & INFO OBJECT Join CREATE TABLE ODI_SAP_DEMO.W_VENDER_CUBE_OBJ_DS ( COMP_CODE CHAR(10), VENDOR CHAR(10), GL_ACCOUNT CHAR(10), SALES_FOR_PERIOD NUMBER, CUM_BALANCE NUMBER, PLANT CHAR(10), MEDIUM_DESC VARCHAR2(100)); ALTER TABLE ODI_SAP_DEMO.W_VENDER_CUBE_OBJ_DS ADD CONSTRAINT PK_W_VENDER_CUBE_OBJ_DS PRIMARY KEY (COMP_CODE); CREATE TABLE "TARGET_NAVIGATIONAL_ATTRIBUTES" ( IOPK_CUSTOMER VARCHAR2(10 BYTE), IOPKCUST_GROUPVARCHAR2(2 BYTE), IOPKPK_CUSTOMERVARCHAR2(10 BYTE), IOPK_PK_PLANT VARCHAR2(4 BYTE), IOPKCALMONTH NUMBER(6), IOPK_CALWEEK NUMBER(6), IOPKTHIP_POINTVARCHAR2(4 BYTE), REQUIDVARCHAR2(30 BYTE), KF_ODEL_VOL NUMBER(17,3), KF_OSHIPDATE NUMBER(17), KF_OLOADDATEK NUMBER(17), KF_OACT_GI_DTKNUMBER(17), KF_OMATAV_DATKNUMBER(17), KF_OLATE_QTY NUMBER(17,3), CUSTOMERVARCHAR2(10 BYTE), PLANT VARCHAR2(4 BYTE), PHONE VARCHAR2(16 BYTE), PCOMPANYVARCHAR2(6 BYTE), OUTL_TYPEVARCHAR2(4 BYTE), NIELSEN_ID VARCHAR2(2 BYTE), LOGSYSVARCHAR2(10 BYTE), VISIT_RYTVARCHAR2(4 BYTE), USAGE_INDVARCHAR2(3 BYTE), SRCID VARCHAR2(4 BYTE), PRECISIDNUMBER(4), POSTCD_BOX VARCHAR2(10 BYTE), CUS_F_CONS VARCHAR2(1 BYTE), COUNTRYVARCHAR2(3 BYTE), BPARTNERVARCHAR2(10 BYTE), ACCNT_GRPVARCHAR2(4 BYTE), LANGU VARCHAR2(1 BYTE), KEYACCOUNT VARCHAR2(1 BYTE) ) -- For OPEN HUB DESTINATION CREATE TABLE ODI_SAP_DEMO.W_OPENHUB_SALES_DS ( OHREQUID NUMBER, DATA_PACKAGE NUMBER, DATA_RECORD NUMBER, CUSTOMER CHAR(1), MATERIAL CHAR(1), MATERIAL_PRICE NUMBER, CURRENCY NUMBER, QUANTITY NUMBER, TOTAL_REVENUE NUMBER); ALTER TABLE ODI_SAP_DEMO.W_OPENHUB_SALES_DS ADD CONSTRAINT PK_W_OPENHUB_SALES_DS PRIMARY KEY (OHREQUID);
2.8 JCoのインストールと構成
SAPアダプタでは、Java Connector (JCo)を使用してSAPシステムに接続します。プロジェクトを続行する前にJCoを構成する必要があります。
JCoをインストールおよび構成するには:
2.9 Oracle Data Integratorの構成
次のステップを実行してOracle Data Integratorを構成します。
2.9.1 オープン・ツールの追加
オープン・ツールをインストールしてODIに追加する手順の詳細は、『Oracle Data Integratorツール・リファレンス』を参照してください。この項では、SAP ABAP固有のステップについてのみ説明します。
-
デザイナに接続します。
-
「ODI」→「オープン・ツールの追加/削除」…を選択します。
-
「オープン・ツールの追加/削除」ウィンドウで、「オープン・ツール・クラス名」フィールドに次の名前を入力します:
oracle.odi.sap.km._OdiSapAbapExecuteStoppable.
-
「オープン・ツールの追加」をクリックします。
-
オープン・ツールが次のように表示されます。
-
「OK」をクリックします。