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
ターゲット・システムのユーザー・アカウント	Demoユーザーに割り当てられたすべての権限を持つユーザーをBMC Remedyに作成します。 「ITリソースの定義」の項の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。

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

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

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

インストール・メディア・ディレクトリのファイル	コピー先ディレクトリ
configディレクトリにあるファイル test/configディレクトリにあるファイル	OIM_home/xellerate/XLIntegrations/BMCTICKET/config
lib/JavaTask/xlBMCRemedyTicket.jar	OIM_home/xellerate/JavaTasks
lib/ScheduleTask/xlBMCRemedyTicketRecon.jar	OIM_home/xellerate/ScheduleTask
resourcesディレクトリにあるファイル	OIM_home/xellerate/connectorResources
test/scriptsディレクトリにあるファイル	OIM_home/xellerate/XLIntegrations/BMCTICKET/scripts
xml/BMCTicketConnector_DM.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ファイルの内容も、クラスタの各ノードの対応するディレクトリにコピーする必要があります。

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

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

• 各ターゲット・アプリケーションの「HPD:HelpDesk」フォームのカスタマイズ

• 暗号化の有効化

各ターゲット・アプリケーションの「HPD:HelpDesk」フォームのカスタマイズ

各ターゲット・アプリケーションには、BMC Remedyのカスタム・チケット・フォームが必要です。ターゲット・アプリケーションのカスタム・チケット・フォームを作成するには、次のいずれかの方法を使用できます。

• 「HPD:HelpDesk」フォームのコピーを作成します。

• 「HPD:HelpDesk」フォームに基づくビューを作成します。

「HPD:HelpDesk」フォームのコピーまたはビューを作成する前に、次の手順を実行する必要があります。

1. 「HPD:HelpDesk」フォーム上にOIMUserIdフィールドを追加します。

2. attributemapping_prov.propertiesファイルとattributemapping_recon.propertiesファイルでOIMUserIdフィールドの値を更新します。

   これらのファイルは次のディレクトリにあります。

   OIM_home/xellerate/XLIntegrations/BMCTICKET/config
   
   

   attributemapping_prov.propertiesファイルで、次の行を探します。

   OIMUserId=<database ID>
   
   

   この行で、<database ID>をデータベースIDに置き換えます。たとえば、次のようになります。

   OIMUserId=536870915
   
   

   attributemapping_recon.propertiesファイルで、次の行を探します。

   Ticket.OIMUserId=<database ID>
   
   

   この行で、<database ID>をデータベースIDに置き換えます。たとえば、次のようになります。

   Ticket.OIMUserId=536870915
   
   

これらを変更したら、各ターゲット・システムのフォームのコピーまたはビューを作成します。各ビューまたはコピーで、次の情報を提供するフィールドを追加します。

• ターゲット・アプリケーション名

• ターゲット・アプリケーション・モジュールのアクセス情報

• ユーザーの詳細

「HPD:HelpDesk」フォームのフィールドの追加およびビューの作成方法の詳細は、『Action request system 6.0 Developing ARSystem Application:Basic』を参照してください。

暗号化の有効化

この項では、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暗号化製品でサポートされている値に設定してください。

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

手順4: 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/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.BMCTicket=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCTicket=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.BMCTicket=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCTicket=INFO
     
     

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

  WebSphere_home/AppServer/logs/server_name/startServer.log
  
  

• JBoss Application Server

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

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

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

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

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

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

  JBoss_home/server/default/log/server.log
  
  

• OC4J

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

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

     log4j.logger.Adapter.BMCTicket=log_level
     
     

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

     次に例を示します。

     log4j.logger.Adapter.BMCTicket=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ディレクトリにあるBMCTicketConnector_DM.xmlファイルを検索して開きます。このXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

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

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

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

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

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

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

    
    

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

    
    

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

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

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

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

ITリソースの定義

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

パラメータ	説明
UserName	ターゲット・システムへの接続に使用されるユーザーID。 デフォルト値はDemoです。
Password	ターゲット・システムへの接続に使用されるユーザーIDのパスワード。 デフォルト値は空白です。
SeverName	BMC RemedyサーバーのIPアドレスまたはコンピュータ名。
Port	BMC RemedyサーバーがリスニングするTCP/IPポート。 デフォルト値は0です。
LastReconTime	このパラメータは最初のリコンシリエーションの実行時に開始され、リコンシリエーションの実行終了時のタイムスタンプ値を格納します。 デフォルト値はNoneです。
IsSecure	暗号化機能が有効化されているかどうかを指定します。 値はYESまたはNOです。デフォルト値はNOです。
FormName	新規作成されたユーザーおよび更新されたチケットの詳細を取得できるターゲット・システムのフォームまたはビューの名前。
NoOfTrials	コネクタがターゲット・システムの接続を試行する最大回数。 デフォルト値は2です。
DelayBetweenTrials	タイムアウト発生時のターゲット・システムへの接続の時間差。 デフォルト値は、2000です。
FullNameOfUser	ターゲット・システムへの接続を試行するユーザーの完全名。

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