2 コネクタのデプロイ

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

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

• 手順2: ターゲット・システムの構成

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

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

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

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

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

項目	要件
Oracle Identity Manager	Oracle Identity Managerリリース8.5.3以上。
ターゲット・システム	BMC Remedy AR System 6.0。
外部コード・ファイル	BMC Remedy Admin Clientのインストール・ディレクトリにある次のJARおよびDLLファイル。 arapi60.jar arutil60.jar arapi60.dll arjni60.dll arrpc60.dll arutl60.dll
ターゲット・システムのユーザー・アカウント	APP管理グループのメンバーであるユーザー・アカウント。 「ITリソースの定義」の項の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。 ターゲット・システムのユーザー・アカウントに特定の権限が割り当てられていない場合は、次のメッセージが表示されます。 You do not have write access.

手順2: ターゲット・システムの構成

ターゲット・システムを構成するには、次の手順を実行します。

• 「SHR:DeletePeople」フォームの作成

• 暗号化の有効化

「SHR:DeletePeople」フォームの作成

「SHR:DeletePeople」フォームは、削除されたユーザーの詳細を保存するために使用されます。この情報は、リコンシリエーション中に必要です。

Demoユーザー・アカウントを使用して、「SHR:DeletePeople」フォームを作成できます。または、Demoユーザー・アカウントのすべての権限を持つユーザー・アカウントを作成することもできます。

「SHR:DeletePeople」フォームを作成するには、次のようにします。

1. ArAdminツールを開きます。

   前の項で作成したユーザー・アカウントを使用して、BMC Remedy User Managementサーバーに接続します。パスワードは空白のままにできます。

2. 「Forms」をクリックします。

3. 「SHR:People」フォームをクリックします。

4. 「File」メニューから「Save As」を選択し、このフォームをSHR:DeletePeopleとして保存します。

削除されたユーザー・レコードを「SHR:People」フォームから「SHR:DeletePeople」フォームに移動するためのデータベース・トリガーを作成するには、次のようにします。

1. BMC Remedy用に作成されたデータベースで次のSELECT文を実行して、「SHR:People」および「SHR:DeletePeople」フォームの表の名前を確認します。

   SELECT name,schemaid FROM arschema WHERE name LIKE 'SHR:People';
   
   

2. SQL*Plusを使用してBMC Remedyデータベースにログインします。

3. SQLプロンプトで、インストール・メディア・ディレクトリにある次のファイルからSQLコードをコピーします。

   scripts/Trigger.txt
   
   

   このファイルについては、「コネクタを構成するファイルおよびディレクトリ」の項説明します。

4. SQLコード内で、仮の表名である57および608を、ステップ1を実行して決定した表名で置き換えます。

5. SQLコードを実行してトリガーを作成します。

暗号化の有効化

この項では、Remedy暗号化に関する次の項目について説明します。

• Remedy暗号化の構成

• AR System暗号化のエラー・メッセージ

Remedy暗号化の構成

暗号化を有効化して暗号化オプションを設定するには、ar.confファイル（UNIX）またはar.cfgファイル（Microsoft Windows）にサーバー暗号化オプションを指定する必要があります。これは、テキスト・エディタを使用して実行できます。

Encrypt-Security-Policy暗号化オプションを設定できます。これは、暗号化が有効化されているかどうかを示す整数値です。ar.cfg（またはar.conf）ファイルにこのオプションがない場合、暗号化はデフォルトで無効化されています。暗号化が有効化されている場合は、この暗号化オプションを次のいずれかの値に設定できます。

• 0: 暗号化が許可されます。暗号化が有効化または無効化されているクライアントおよびサーバーがこのAR Systemサーバーに接続できます。

• 1: 暗号化は必須です。暗号化が有効化されているクライアントおよびサーバーのみがこのAR Systemサーバーに接続できます。

• 2: 暗号化は許可されません。暗号化が有効化されているかどうかにかかわらず、クライアントおよびサーバーは暗号化なしで通信できます。

次の表に、ar.conf（またはar.cfg）ファイルに追加可能なオプションのサンプル設定を示します。

オプションの設定	意味
Encrypt-Security-Policy: 1	暗号化は必須です。
Encrypt-Public-Key-Expire: 86400	公開鍵の継続時間は1日（86400秒）です。
Encrypt-Symmetric-Data-Key-Expire: 2700	対称型データの暗号化キーの継続時間は45分（2700秒）です。
Encrypt-Public-Key-Algorithm: 5	公開鍵の暗号化キーの強度はRSA-1024（パフォーマンス・セキュリティ）です。
Encrypt-Data-Encryption-Algorithm: 2	対称型データの暗号化キーの強度はRC4 128ビット（パフォーマンス・セキュリティ）です。

これらのオプションを設定しない場合は、デフォルト値が使用されます。暗号化レベルのデフォルトは、使用する暗号化製品により異なります。

Remedy暗号化を有効化するには、次のようにします。

1. 実行中のAR Systemプロセスをすべて終了または停止します。

   これを実行するには、「コントロール パネル」、「管理ツール」、「サービス」の順に開きます。実行中の各AR Systemプロセスを停止します。

2. ar.confファイル（UNIXの場合）またはar.cfgファイル（Microsoft Windowsの場合）に、設定が0（暗号化を許可）または1（暗号化必須）のEncrypt-Security-Policyオプションを追加します。必要に応じて、ファイルにその他のオプションを追加します。

   ar.confファイルのデフォルトのUNIXディレクトリは、ar_install_dir/confです。Microsoft Windowsの場合、ar.cfgファイルはar_install_dir\confディレクトリに格納されています。ここで、ar_install_dirはARサーバーのARSystemのインストール・ディレクトリです。

   
   

   注意: Encrypt-Security-Policyオプションを1（暗号化必須）に設定すると、暗号化を使用するようにアップグレードされていないサーバーまたはクライアントと通信できなくなります。

   
   

3. AR Systemサーバーを再起動します。

AR Systemの暗号化のエラー・メッセージ

AR Systemサーバーを起動すると、暗号化が有効化されている場合には、暗号化ライセンスおよび暗号化構成設定が確認されます。Remedy暗号化製品の適切なライセンスが検出されない場合、または無効な構成設定が検出された場合には、次のエラー・メッセージが1つ以上表示されます。

エラー番号	エラー・メッセージおよび説明
9010	Encryption is enabled, but the encryption library is not found. Remedy暗号化製品をインストールしてください。
9012	No encryption license. 使用しているRemedy暗号化製品の暗号化ライセンスを追加してください。
9013	The encryption license does not match the type of Remedy Encryption product that is installed. インストールされているRemedy暗号化製品のライセンスを取得してください。
9006	The encryption library does not support the specified public key encryption algorithm. ar.cfg（またはar.conf）ファイルのEncryption-Public-Key-Algorithmオプションを、インストールされているAR System暗号化製品でサポートされている値に設定してください。
9007	The encryption library does not support the specified data encryption algorithm. ar.cfg（またはar.conf）ファイルのEncrypt-Data-Encryption-Algorithmオプションを、インストールされているAR System暗号化製品でサポートされている値に設定してください。

暗号化が無効化されている場合、暗号化エラー・チェックは行われず、暗号化エラーは無視されます。エラー・メッセージは、検出された順序で表示されます。

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

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

注意: この表の最初の列に示すディレクトリ・パスは、インストール・メディアの次のディレクトリでのコネクタ・ファイルの場所に対応しています。 Help Desk/BMC Remedy/BMC Remedy User Management これらのファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。

インストール・メディア・ディレクトリのファイル	コピー先ディレクトリ
configディレクトリにあるファイル test/configディレクトリにあるファイル	OIM_home/xellerate/XLIntegrations/BMC/config
scripts/Trigger.txt	OIM_home/xellerate/BMCTrigger
lib/JavaTask/xlBMCRemedy.jar	OIM_home/xellerate/JavaTasks
lib/ScheduleTask/xlBMCRemedyRecon.jar	OIM_home/xellerate/ScheduleTask
resourcesディレクトリにあるファイル	OIM_home/xellerate/connectorResources
test/scriptsディレクトリにあるファイル	OIM_home/xellerate/XLIntegrations/BMC/scripts
xmlディレクトリにあるファイル	OIM_home/xlclient

コネクタ・ファイルをコピーしたら、次のようにします。

1. 次のファイルをBMC Remedy Admin Clientのインストール・ディレクトリ（C:\Program Files\AR Systemなど）から、OIM_home\xellerate\ThirdPartyディレクトリにコピーします。

   arapi60.jar
   arutil60.jar
   arapi60.dll
   arjni60.dll
   arrpc60.dll
   arutl60.dll
   
   

2. PATH環境変数にOIM_home\xellerate\ThirdPartyを指定します。

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

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

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

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

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

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

• ロギングの有効化

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

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

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

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

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

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

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

   
   

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

   
   

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

   • Microsoft Windowsの場合:

     PurgeCache.bat ConnectorResourceBundle
     
     

   • UNIXの場合:

     PurgeCache.sh ConnectorResourceBundle
     

   
   

   注意: ステップ2の実行時にスローされる例外は無視できます。

   
   

   このコマンドの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.BMCRemedy=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCRemedy=INFO
     
     

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

  WebLogic_home/user_projects/domains/domain_name/server_name/server_name.log
  
  

• IBM WebSphere

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

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

     log4j.logger.Adapter.BMCRemedy=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCRemedy=INFO
     
     

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

  WebSphere_home/AppServer/logs/server_name/startServer.log
  
  

• JBoss Application Server

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

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

     <category name="Adapter.BMCRemedy">
        <priority value="log_level"/>
     </category>
     
     

  2. XMLコードの2行目で、log_levelを、設定するログ・レベルに置換します。次に例を示します。

     <category name="Adapter.BMCRemedy">
        <priority value="INFO"/>
     </category>
     
     

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

  JBoss_home/server/default/log/server.log
  
  

• OC4J

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

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

     log4j.logger.Adapter.BMCRemedy=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCRemedy=INFO
     
     

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

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

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

「コネクタを構成するファイルおよびディレクトリ」で説明したように、コネクタのXMLファイルには、コネクタのコンポーネントの定義が含まれています。コネクタのXMLファイルをインポートすることで、Oracle Identity Managerにこれらのコンポーネントを作成します。

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

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

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

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

4. OIM_home/xlclientディレクトリにあるBMCConnector_DM.xmlファイルを検索して開きます。このXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

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

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

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

8. BMC ITリソースのパラメータの値を指定します。指定する値の詳細は、「ITリソースの定義」の表を参照してください。

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

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

    
    

    関連資料: その他のITリソースを定義する場合、手順は『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。

    
    

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

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

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

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

ITリソースの定義

BMC ITリソース・パラメータには、次の表に示す値を指定してください。

パラメータ	Description
UserName	ターゲット・システムへの接続に使用されるユーザーID。 デフォルト値はDemoです。
Password	ターゲット・システムへの接続に使用されるユーザーIDのパスワード。
ServerName	BMC Remedy User ManagementサーバーのIPアドレスまたはコンピュータ名。
Port	BMC Remedy User ManagementサーバーがリスニングするTCP/IPポート。 デフォルト値は0です。
TrustedField	ユーザー・レコード検索用の一意の識別キー。 デフォルト値はLogin Nameです。
TrustedTimeStamp	このパラメータは信頼できるソースのリコンシリエーションに使用されます。 このパラメータは最初のリコンシリエーションの実行時に開始され、リコンシリエーションの実行終了時のタイムスタンプ値を格納します。 デフォルト値はNoneです。これは変更しないでください。
NonTrustedTimeStamp	このパラメータは信頼できないソースのリコンシリエーションに使用されます。 このパラメータは最初のリコンシリエーションの実行時に開始され、リコンシリエーションの実行終了時のタイムスタンプ値を格納します。 デフォルト値はNoneです。これは変更しないでください。
IsSecure	暗号化機能が有効化されているかどうかを指定します。 値はYESまたはNOです。デフォルト値はNOです。
DeleteUserFormName	削除されたユーザーの詳細を取得できるターゲット・システムのフォームの名前。 デフォルト値はSHR:DeletePeopleです。
FormName	新規作成されたユーザーおよび更新されたユーザーの詳細を取得できるターゲット・システムのフォームの名前。 値はSHR:Peopleです。
NumberOfTrials	InvocationTargetExceptionがスローされるまでに、ターゲット・システムへの接続を再試行する回数。 デフォルト値: 2
DelayBetweenTrials	後続の再試行との間の時間差（ミリ秒）。 デフォルト値: 20000

これらのITリソース・パラメータの値を指定したら、この手順のステップ9に進んで、コネクタのXMLファイルをインポートします。