2 コネクタのデプロイ

コネクタをデプロイするには次の手順を実行します。

• 手順1: デプロイ要件の確認

• 手順2: コネクタ・ファイルおよび外部コード・ファイルのコピー

• 手順3: Oracle Identity Managerサーバーの構成

• 手順4: コネクタのXMLファイルのインポート

手順1: デプロイ要件の確認

次の表に、コネクタのデプロイ要件を示します。

項目	要件
Oracle Identity Manager	Oracle Identity Managerリリース8.5.3以上
ターゲット・システム	サポートされるPeopleToolsのバージョン: PeopleTools 8.22 PeopleTools 8.45、8.46、8.47 PeopleTools 8.48 前述のリストにあるPeopleToolsのいずれかのバージョンと互換性のあるPeopleSoftアプリケーションがサポートされます。 次のコンポーネントがインストールおよび構成されていることを確認します。 TuxedoおよびJolt（アプリケーション・サーバー） PeopleSoft Internet Architecture PeopleSoft Application Designer（2層モード）
ターゲット・システムのホスト・プラットフォーム	PeopleTools 8.22で実行されているアプリケーションは、Microsoft Windowsプラットフォームでのみサポートされます。それ以外のPeopleToolsのサポートされているバージョンで実行されているアプリケーションは、プラットフォームに依存しません。
外部コード	csv.jar このファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。 「手順2: コネクタ・ファイルおよび外部コード・ファイルのコピー」で、必要なPeopleSoftファイルの詳細を説明します。
ターゲット・システムのユーザー・アカウント	PSアカウント。 Oracle Identity Managerは、ターゲット・システムとの接続およびデータ交換にターゲット・システムのアカウントを使用します。ITリソースのパラメータ値を指定する際に、このユーザーの資格証明も指定します。

手順2: コネクタ・ファイルおよび外部コード・ファイルのコピー

コピーするコネクタのファイルと、コピーする必要があるディレクトリを次の表に示します。

注意: - この表の最初の列に示すディレクトリ・パスは、インストール・メディアの次のディレクトリでのコネクタ・ファイルの場所に対応しています。 Enterprise Applications/PeopleSoft Enterprise Applications/PeopleSoft User Management これらのファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。 - 特定のコピー先ディレクトリがOracle Identity Managerサーバーに存在しない場合は、ディレクトリを作成してください。

インストール・メディア・ディレクトリのファイル	コピー先ディレクトリ
configディレクトリにあるファイル	OIM_HOME/xellerate/XLIntegrations/PSFTBASE/config
lib/peopleSoftUserMgmt.war	OIM_HOME/cbrecon_webapp/lib
ext/csv.jar	OIM_HOME/xellerate/ThirdParty
lib/PSFTBaseProvisioning.jar	OIM_HOME/xellerate/JavaTasks
lib/PSFTBaseReconciliation.jar	OIM_HOME/xellerate/ScheduleTask
PeopleTools 8.22の場合、lib/ディレクトリからファイルをコピー。	OIM_HOME/xellerate/MsgPublisher
PeopleTools 8.22の場合、PeopleCode/PT822ディレクトリからファイルをコピー。 PeopleTools 8.45〜8.48の場合、PeopleCodeディレクトリからファイルをコピー。	OIM_HOME/xellerate/scripts 注意: PeopleTools 8.22とPeopleTools 8.45〜8.48のいずれか一方のファイルをコピーする必要があります。両方のファイルをコピーしないでください。
PeopleTools 8.22の場合、resources/PT822ディレクトリからファイルをコピー。 PeopleTools 8.45〜8.48の場合、resourcesディレクトリからファイルをコピー。	OIM_HOME/xellerate/connectorResources 注意: PeopleTools 8.22とPeopleTools 8.45〜8.48のいずれか一方のファイルをコピーする必要があります。両方のファイルをコピーしないでください。
PeopleTools 8.22の場合、test/cbrecon/PT822ディレクトリからファイルをコピー。 PeopleTools 8.45〜8.48の場合、test/cbreconディレクトリからファイルをコピー。	OIM_HOME/xellerate/XLIntegrations/PSFTBASE/cbrecon 注意: PeopleTools 8.22とPeopleTools 8.45〜8.48のいずれか一方のファイルをコピーする必要があります。両方のファイルをコピーしないでください。
test/scriptsディレクトリにあるファイル	OIM_HOME/xellerate/XLIntegrations/PSFTBASE/scripts
test/configディレクトリにあるファイル	OIM_HOME/xellerate/XLIntegrations/PSFTBASE/config
PeopleTools 8.22の場合: xml/PT822/PSFTBaseConnector.xml xml/PT822/PSFTBaseXellerateUser.xml PeopleTools 8.45〜8.48の場合: xml/PSFTBaseConnector.xml xml/PSFTBaseXellerateUser.xml	OIM_HOME/xlclient 注意: PeopleTools 8.22とPeopleTools 8.45〜8.48のいずれか一方のファイルをコピーする必要があります。両方のファイルをコピーしないでください。

コネクタ・ファイルをコピーしたら、ターゲット・システム・サーバー上のPEOLESOFT_HOME/PT8xx/web/PSJOAディレクトリからOIM_HOME/xellerate/ThirdPartyディレクトリに次のファイルをコピーします。

• psjoa.jar

  ターゲット・システムへのリモート接続のためにOracle Identity Managerに必要なコンパイル済のJavaクラスが含まれるPeopleSoft Javaオブジェクト・アダプタ・ファイルです。

• peoplesoft.jar

  このJARファイルには、USER_PROFILEコンポーネント・インタフェースのAPIが含まれます。

  使用している特定のPeopleToolsリリース（8.22または8.45〜8.48）におけるこのファイルの生成手順の詳細は、「プロビジョニングのためのターゲット・システムの構成」を参照してください。

pstools.propertiesファイルには、PeopleSoft Integration Brokerゲートウェイによって使用されるTuxedoパラメータ設定が含まれます。これをOIM_HOME/xellerate/binディレクトリにコピーする必要があります。

注意: Oracle Identity Managerをクラスタ環境にインストールするときは、インストール・ディレクトリの内容をクラスタの各ノードにコピーします。同様に、すべてのJARファイルとconnectorResourcesディレクトリの内容も、クラスタの各ノードの対応するディレクトリにコピーする必要があります。

手順3: Oracle Identity Managerサーバーの構成

Oracle Identity Managerサーバーの構成には、次の手順があります。

注意: クラスタ環境では、クラスタの各ノードでこれらの手順を実行する必要があります。

• 必要な入力ロケールへの変更

• サーバー・キャッシュからのコネクタ・リソース・バンドル関連コンテンツの消去

• ロギングの有効化

必要な入力ロケールへの変更

必要な入力ロケール（言語および国の設定）に変更するには、必要なフォントのインストールと必要な入力ロケールの設定を行います。

必要な入力ロケールに変更するため、システム管理者の支援が必要となる場合があります。

サーバー・キャッシュからのコネクタ・リソース・バンドル関連コンテンツの消去

「手順2: コネクタ・ファイルおよび外部コード・ファイルのコピー」の項で説明されている手順を実行する際には、インストール・メディアのresourcesディレクトリにあるファイルを、OIM_HOME/xellerate/connectorResourcesディレクトリにコピーします。connectorResourcesディレクトリ内に新しいリソース・バンドルを追加したり、既存のリソース・バンドルに変更を加えた場合は、コネクタ・リソース・バンドルに関連するコンテンツをその都度サーバー・キャッシュから消去する必要があります。

コネクタ・リソース・バンドルに関連するコンテンツをサーバー・キャッシュから消去するには、次のようにします。

1. コマンド・ウィンドウで、OIM_HOME/xellerate/binディレクトリに移動します。

   
   

   注意: ステップ1を実行してからステップ2を実行してください。ステップ2で次のようにコマンドを実行すると、例外がスローされます。 OIM_HOME/xellerate/bin/script_file_name

   
   

2. 次のいずれかのコマンドを入力します。

   • Microsoft Windowsの場合:

     PurgeCache.bat ConnectorResourceBundle
     

   • UNIXの場合:

     PurgeCache.sh ConnectorResourceBundle
     

   
   

   注意: ステップ2の実行時にスローされる例外は無視できます。この例外は、ステップ1に示された例外とは異なります。

   
   

   このコマンドのConnectorResourceBundleは、サーバー・キャッシュから削除できるコンテンツ・カテゴリの1つです。その他のコンテンツ・カテゴリの詳細は、次のファイルを参照してください。

   OIM_HOME/xellerate/config/xlconfig.xml
   

ロギングの有効化

ロギングを有効化すると、Oracle Identity Managerはプロビジョニングおよびリコンシリエーション操作の過程で発生するイベントについての情報をログ・ファイルに自動的に格納します。ロギングを行うイベントのタイプを指定するには、ログ・レベルを次のいずれかに設定します。

• ALL

  このレベルでは、すべてのイベントのロギングが有効化されます。

• DEBUG

  このレベルでは、デバッグに役立つ詳細なイベントに関する情報のロギングが有効化されます。

• INFO

  このレベルでは、アプリケーションの進行状況を大まかに示すメッセージのロギングが有効化されます。

• WARN

  このレベルでは、障害を引き起こす可能性のある状況に関する情報のロギングが有効化されます。

• ERROR

  このレベルでは、アプリケーションを続行できるエラー・イベントに関する情報のロギングが有効化されます。

• FATAL

  このレベルでは、アプリケーションの機能停止の原因となる可能性がある、非常に重大なエラー・イベントに関する情報のロギングが有効化されます。

• OFF

  このレベルでは、すべてのイベントのロギングが無効化されます。

ログ・レベルを設定するファイルは、使用するアプリケーション・サーバーによって異なります。

• BEA WebLogic

  ロギングを有効にするには、次のようにします。

  1. OIM_HOME/xellerate/config/log.propertiesファイルに次の行を追加します。

     log4j.logger.ADAPTER.PSFTBASE=log_level
     log4j.logger.com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction=log_level
     log4j.logger.com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation=log_level
     

  2. これらの行で、log_levelを、設定するログ・レベルに置換します。

     次に例を示します。

     log4j.logger.ADAPTER.PSFTBASE=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation=DEBUG
     

  ロギングを有効化すると、ログ情報が次のファイルに書き込まれます。

  WEBLOGIC_HOME/user_projects/domains/domain_name/server_name/server_name.log
  

• IBM WebSphere

  ロギングを有効にするには、次のようにします。

  1. OIM_HOME/xellerate/config/log.propertiesファイルに次の行を追加します。

     log4j.logger.ADAPTER.PSFTBASE=log_level
     log4j.logger.com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction=log_level
     log4j.logger.com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation=log_level
     

  2. これらの行で、log_levelを、設定するログ・レベルに置換します。

     次に例を示します。

     log4j.logger.ADAPTER.PSFTBASE=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation=DEBUG
     

  ロギングを有効化すると、ログ情報が次のファイルに書き込まれます。

  WEBSPHERE_HOME/AppServer/logs/server_name/SystemOut.log
  

• JBoss Application Server

  ロギングを有効にするには、次のようにします。

  1. JBOSS_HOME/server/default/conf/log4j.xmlファイルで、次の行を検索します。

     <category name="ADAPTER.PSFTBASE">
        <priority value="log_level"/>
     </category>
     
     <category name="com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction">
        <priority value="log_level"/>
     </category>
     
     <category name="com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation">
        <priority value="log_level"/>
     </category>
     

  2. これらの行で、log_levelを、設定するログ・レベルに置換します。次に例を示します。

     <category name="ADAPTER.PSFTBASE">
        <priority value="DEBUG"/>
     </category>
     
     <category name="com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction">
        <priority value="DEBUG"/>
     </category>
     
     <category name="com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation">
        <priority value="DEBUG"/>
     </category>
     

  ロギングを有効化すると、ログ情報が次のファイルに書き込まれます。

  JBOSS_HOME/server/default/log/server.log
  

• Oracle Application Server

  ロギングを有効にするには、次のようにします。

  1. OIM_HOME/xellerate/config/log.propertiesファイルに次の行を追加します。

     log4j.logger.ADAPTER.PSFTBASE=log_level
     log4j.logger.com.thortech.xl.Integration.peoplesoft.PeopleSoftUMAction=log_level
     log4j.logger.com.thortech.xl.Integration.peoplesoft.util.tcUtilReconciliation=log_level
     

  2. これらの行で、log_levelを、設定するログ・レベルに置換します。

     次に例を示します。

     log4j.logger.ADAPTER.PSFTBASE=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.PeopleSoftUMAction=DEBUG
     log4j.logger.com.thortech.xl.integration.peoplesoft.util.tcUtilReconciliation=DEBUG
     

  ロギングを有効化すると、ログ情報が次のファイルに書き込まれます。

  OAS_HOME/opmn/logs/default_group~home~default_group~1.log
  

手順4: コネクタのXMLファイルのインポート

コネクタのXMLファイルをOracle Identity Managerにインポートするには、次のようにします。

1. Oracle Identity Manager管理およびユーザー・コンソールを開きます。

2. 左のナビゲーション・バーの「デプロイメント管理」リンクをクリックします。

3. 「デプロイメント管理」の下の「インポート」リンクをクリックします。ファイルを開くダイアログ・ボックスが表示されます。

4. OIM_HOME/xlclientディレクトリにあるPSFTBaseConnector.xmlファイルを探して開きます。ファイル確認ページにXMLファイルの詳細が表示されます。

5. 「ファイルの追加」をクリックします。「置換」ページが表示されます。

6. 「次へ」をクリックします。「確認」ページが表示されます。

7. 「次へ」をクリックします。PSFT Base Server ITリソースの「ITリソース・インスタンス・データの提供」ページが表示されます。

8. PSFT Base Server ITリソースのパラメータの値を指定します。次の表に、指定する値を示します。

   パラメータ	説明
   Admin	PeopleSoft Enterprise Applications管理者のユーザーID。 デフォルト値: PS
   AdminCredentials	PeopleSoft Enterprise Applications管理者のパスワード。
   ComponentInterfaceName	PeopleSoft Enterprise Applicationsのユーザー・データのロードに使用されるコンポーネント・インタフェース。 デフォルト値: USER_PROFILE
   ServerName	PeopleSoft Enterprise ApplicationsサーバーのIPアドレスまたはコンピュータ名。 注意: IPアドレスの後に、PeopleSoft Internet Architectureが実行されているポート番号が必要です。たとえば、ServerName = 172.21.109.48:90
   ServerPort	PeopleSoft Enterprise Applicationsサーバーがリスニングするポート。 デフォルト値: 8000
   IsSecure	SSL機能を有効にするかどうかを指定します。 値はYESまたはNOです。デフォルト値はNOです。 注意: SSLを有効化して、ターゲット・システムとの通信を保護することをお薦めします。
   SymbolicId	ユーザー・プロファイルに関連付けられたAccessIdを指定します。 AccessIdは、ユーザーがPeopleSoft Enterprise Applicationsデータベースに対して十分な権限を持っているかどうかを指定するものです。 サンプル値: PS89
   NumberOfRetries	InvocationTargetExceptionがスローされるまでに、Oracle Identity Managerがターゲット・システムへの接続を試行する回数を指定します。 デフォルト値: 2 注意: タイムアウト機能が有効になるのは、完全リコンシリエーションとプロビジョニングのみです。増分リコンシリエーションには適用されません。
   DelayBetweenRetries	連続する再試行の試行間隔（ミリ秒）を指定します。 デフォルト値: 20000
   IndexOfLastReconciledRecord	このパラメータは、リコンサイルに成功した最後のレコードの索引を保存します。このパラメータは完全リコンシリエーションにのみ適用できます。このパラメータの詳細は、「IndexOfLastReconciledRecordパラメータの構成」を参照してください。 デフォルト値: -1

   
   

9. 「次へ」をクリックします。PSFT Base Server ITリソース・タイプの新しいインスタンスの「ITリソース・インスタンス・データの提供」ページが表示されます。

10. 「スキップ」をクリックして、他のITリソースを定義しないことを指定します。「確認」ページが表示されます。

    
    

    関連項目: その他のITリソースを定義する場合、手順は『Oracle Identity Manager管理およびユーザー・コンソール・ガイド』を参照してください。

    
    

11. 「選択内容の表示」をクリックします。

    XMLファイルの内容が「インポート」ページに表示されます。ノードの横に十字形のアイコンが表示されることがあります。これらのノードは、冗長なOracle Identity Managerエンティティを示しています。コネクタのXMLファイルをインポートする前に、各ノードを右クリックして「削除」を選択し、これらのエンティティを削除する必要があります。

12. 「インポート」をクリックします。コネクタのファイルがOracle Identity Managerにインポートされます。

注意: コネクタのXMLファイルに提供されているITリソースのデフォルト名はPSFT Base Serverです。この名前は、PeopleTools 8.22の増分リコンシリエーション・コードにハードコードされています。増分リコンシリエーションの実行に成功するには、このITリソースの名前を変更しないでください。

コネクタのXMLファイルをインポートしたら、次の章に進みます。