2 コネクタのデプロイ

コネクタのデプロイには次の手順があります。

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

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

• 手順3: コネクタ・ファイルのコピー

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

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

• 手順6: リコンシリエーションの構成

• 手順7: アダプタのコンパイル

UNIX Telnetの複数のインストールに対してコネクタを構成する場合は、次の手順を実行します。

• ターゲット・システムの複数のインストールに対するコネクタの構成

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

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

項目	要件
Oracle Identity Manager	Oracle Identity Managerリリース8.5.3以降。
ターゲット・システム	ターゲット・システムは次のいずれか。 Solaris 8、Solaris 9またはSolaris 10 HP-UX 11.11（信頼できる/信頼できない） Linux（Red Hat Advanced Server 2.1、Red Hat Enterprise Linux 3.xまたはRed Hat Linux 4.x） AIX 4.3またはAIX 5.2
外部コード	JSCAPE Telnet/SSHライブラリ（SSHファクトリ）。
その他のシステム	オペレーティング・システム・パッチ（HP-UX）。
ターゲット・システムのユーザー・アカウント	root。 「ITリソースの定義」の項の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。
ターゲット・システムでサポートされている文字エンコーディング（en_US）	ターゲット・システムで、UTF-8およびiso8859などのen_US文字エンコーディングの標準がサポートされている必要があります。 ターゲット・システムでサポートされているen_US文字エンコーディングの標準を確認するには、次のコマンドを使用します。 locale -a 注意: ターゲット・システムでen_US文字エンコーディングの標準のいずれもサポートされていない場合には、en_US言語パックをインストールする必要があります。

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

この項では、次のプラットフォームでターゲット・システムを構成する手順を説明します。

• SolarisおよびLinuxの構成手順

• AIXの構成手順

• HP-UXの構成手順

SolarisおよびLinuxの構成手順

SolarisおよびLinux環境では、次の手順を実行します。

1. UNIXサーバーで/etc/passwdおよび/etc/shadowファイルが使用可能であることを確認します。

2. 次のようなコマンドを使用して、ターゲット・サーバーにpasswdミラー・ファイルが作成されていることを確認します。

   cp /etc/passwd /etc/passwd1
   
   

   リコンシリエーション・スケジュール済タスクのPasswd Mirror File/User Mirror File (AIX)属性に、パス付きで同じファイル名を挿入する必要があります。

3. 次のようなコマンドを使用して、ターゲット・サーバーにshadowミラー・ファイルが作成されていることを確認します。

   cp /etc/shadow /etc/shadow1
   
   

   リコンシリエーション・スケジュール済タスクのShadow Mirror File属性に、このファイルの名前とパスを指定する必要があります。

AIXの構成手順

AIX環境では、次の手順を実行します。

1. サーバーで/etc/passwdおよび/etc/security/userファイルが使用可能であることを確認します。

2. 次のようなコマンドを使用して、サーバーにuserミラー・ファイルが作成されていることを確認します。

   lsuser -c -a id pgrp gecos home shell expires maxage ALL |
   tr '#' ' ' > /mainUserFile1
   
   

   リコンシリエーション・スケジュール済タスクのPasswd Mirror File/User Mirror File (AIX)属性に、このファイルの名前とパスを指定する必要があります。

HP-UXの構成手順

HP-UX環境では、次の手順を実行します。

1. rootとしてログインし、次のコマンドを実行します。

   /usr/bin/sam
   
   

2. 「Auditing and Security」および「System Security Policies」を選択します。信頼できるモードに切り替えるかどうかを確認するメッセージが表示されます。

3. 「OK」をクリックします。

   次のメッセージが表示された場合には、次の手順をスキップします。

   System changed successfully to trusted system
   
   

4. ターゲット・サーバーで/etc/passwdおよび/etc/shadowディレクトリが使用可能であることを確認します。

   shadowファイルが存在しない場合には、次のサイトのインストール手順に従います。

   http://docs.hp.com/en/5991-0909/index.html

   すべてのパッチはHP社のパッチ・データベースで入手できます。次のサイトからダウンロード可能です。

   http://www5.itrc.hp.com/

手順3: コネクタ・ファイルのコピー

次の表に、コピーするコネクタ・ファイルおよびそれらのコピー先のディレクトリを示します。

注意: この表の1列目のディレクトリ・パスは、インストール・メディアの次に示すZIPファイル内にあるコネクタ・ファイルの場所に対応しています。 Operating Systems\UNIX\Unix Telnet Rev 4.2.0.zip これらのファイルの詳細は、「コネクタを構成するファイルおよびディレクトリ」を参照してください。

インストール・メディア・ディレクトリのファイル	コピー先ディレクトリ
xmlディレクトリにあるファイル	OIM_home/xellerate/XLIntegrations/Telnet/xml
lib\xliTelnet.jar	OIM_home/xellerate/JavaTasks
lib\xliTelnet.jar	OIM_home/xellerate/ScheduleTask
ext\sshfactory.jar	OIM_home/xellerate/ThirdParty
resourcesディレクトリのファイル	OIM_home/xellerate/connectorResources
testsディレクトリのファイル	OIM_home/xellerate/XLIntegrations/Telnet/tests
docs\B32177_01.pdf	OIM_home/xellerate/docs/Telnet

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

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

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

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

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

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

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

必要な入力ロケールに変更するには、必要なフォントのインストールと必要な入力ロケールの設定を行います。

必要な入力ロケールを設定するには、次のようにします。

注意: 使用しているオペレーティング・システムによっては、この手順の実行方法が異なる場合があります。

1. 「コントロール パネル」を開きます。

2. 「地域のオプション」をダブルクリックします。

3. 「地域のオプション」ダイアログ・ボックスの「入力ロケール」タブで、使用する入力ロケールを追加してから、その入力ロケールに切り替えます。

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

OIM_home\xellerate\connectorResourcesディレクトリ内に新しいリソース・バンドル・ファイルを追加するたび、または既存のリソース・バンドル・ファイルで変更を行うたびに、コネクタ・リソース・バンドルに関連するコンテンツをサーバー・キャッシュから消去する必要があります。

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

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

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

   
   

   注意: このステップを実行する前にステップ1を実行する必要があります。コマンドを次のように実行すると、例外がスローされます。 OIM_home\xellerate\bin\batch_file_name

   
   

   • Microsoft Windowsの場合:

     PurgeCache.bat ConnectorResourceBundle
     
     

   • UNIXの場合:

     PurgeCache.sh ConnectorResourceBundle
     
     

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

   OIM_home\xellerate\config\xlConfig.xml
   
   

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

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

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

注意: コネクタ・ファイルを指定した順序でインポートしないと、コネクタが機能しない場合があります。

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

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

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

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

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

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

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

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

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

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

    
    

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

    
    

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

    XMLファイルの内容が「デプロイメント・マネージャ - インポート」ウィンドウに表示されます。各ノードを右クリックして「削除」を選択し、それらのノードを削除します。

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

13. 同じ手順を実行して、XLITelnetSchedulerTask_DM.xmlファイルをインポートします。このファイルはOIM_home/xellerate/XLIntegrations/Telnet/xmlディレクトリにあります。

14. 信頼できるソース・リコンシリエーション・モードでコネクタを使用する場合は、同じ手順を実行してXLITelnet_Trusted_DM.xmlファイルをインポートします。このファイルはOIM_home/xellerate/XLIntegrations/Telnet/xmlディレクトリにあります。

    
    

    注意: 信頼できるソース・リコンシリエーションに構成できるのは、1つのコネクタのみです。別の信頼できるソースを構成している状態でXLITelnet_Trusted_DM.xmlファイルをインポートした場合、2つのコネクタのリコンシリエーションはいずれも機能しなくなります。

    
    

コネクタのXMLファイルをインポートしたら、「手順6: リコンシリエーションの構成」に進みます。

ITリソースの定義

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

パラメータ	説明
Admin UserId	管理者のユーザーID。 root
Admin Password	管理者のパスワード。 dead_line
Server IP Address	サーバーのIPアドレス。
Port	サーバーでTelnetサービスが実行されているポート。 デフォルト値: 23
Server OS	次のいずれかを指定します。 AIX HP-UX SOLARIS LINUX
Shell Prompt	#または$。
Login Prompt	サーバーにログインすると表示されるログイン・プロンプト。 login:
Password Prompt	サーバーにログインすると表示されるパスワード・プロンプト。 Password:
Whether Trusted System (HP-UX)	YES（信頼できるHP-UXシステムの場合）またはNO（信頼できないHP-UXシステムの場合）。
Target Locale	ターゲット・ロケール。 次に示すいずれか1つの値を指定できます。 en_US（英語の場合） ja_JP（日本語の場合） fr_FR（フランス語の場合） 注意: 指定する値を変更（大/小文字の変更も含む）しないでください。
Supported Character Encoding (en_US) - Target	en_USターゲット・ロケール用のエンコーディング形式。 デフォルト値はUTF-8です。 注意: 次のコマンドを使用して、ターゲット・システムでサポートされているen_USエンコーディング形式を確認できます。 locale -a

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

手順6: リコンシリエーションの構成

この項では、Oracle Identity Managerサーバーの構成に関わる次のステップを説明します。

• リコンシリエーションの前提条件の追加

• スケジュール済タスクの定義

• Oracle Identity Managerリリース9.0.1のリコンシリエーションの有効化

リコンシリエーションの前提条件の追加

ここでは次の項目について説明します。

• システム・プロパティの構成

• Oracle Identity Managerエンティティに対する信頼できるソース・リコンシリエーションの構成

システム・プロパティの構成

システム・プロパティを構成するには、次のようにします。

1. Oracle Identity Manager Design Consoleを開きます。

2. 「System Configuration」ページに移動します。

3. 「Default date format」エントリがあるかどうか確認します。このエントリがない場合は、ステップ4を実行します。

4. 「Server」カテゴリに新規エントリを追加します。

   • 名前: Default date format

   • キーワード: XL.DefaultDateFormat

   • 値: yyyy/MM/dd hh:mm:ss z

5. 「Save」をクリックします。

Oracle Identity Managerエンティティに対する信頼できるソース・リコンシリエーションの構成

注意: この手順のこのステップは、信頼できるソース・リコンシリエーションを構成する場合にのみ実行します。信頼できるソース・リコンシリエーションに構成できるのは、1つのコネクタのみです。信頼できるソースが別に構成されている場合に、信頼できるソース・リコンシリエーションをこのコネクタで構成すると、両方のコネクタでリコンシリエーションが機能しなくなります。 リコンシリエーションの構成の概要は、『Oracle Identity Manager Connectorフレームワーク・ガイド』を参照してください。

この手順には次のステップがあります。

1. Oracle Identity Manager Design Consoleを開きます。

2. 「Resource Object」フォームで次のようにします。

   1. Xellerate Userを検索します。

   2. 「Object Reconciliation」タブで、必要なリコンシリエーション・フィールドを追加します。「Xellerate User」フォームの必須フィールドへの入力を指定するために必要な、すべてのリコンシリエーション・フィールドを追加します。たとえば、「User Login」や「First Name」などのフィールドです。マッピングする必要がない必須フィールドは、「Password」のみです。「User Defined Process」フォームのすべての必須フィールドをマッピングしてください。

3. 「Process Definition」フォームで次のようにします。

   1. Xellerate Userを検索します。

   2. 「Reconciliation Field Mappings」タブで、必要なリコンシリエーション・フィールド・マッピングを追加します。「User Defined Process」フォームのすべての必須フィールドをマッピングしてください。

4. 「Reconciliation Rules」フォームで次のようにします。

   1. ルール要素とともに、Xellerate Userリソース・オブジェクトの新規ルールを作成します。

   2. 「Active」チェック・ボックスを選択します。

スケジュール済タスクの定義

リコンシリエーション・スケジュール済タスクを作成するには、次のようにします。

1. Oracle Identity Manager Design Consoleを開きます。

2. 「Xellerate Administration」フォルダを開きます。

3. 「Task Scheduler」を選択します。

4. 「Find」をクリックします。事前定義されたスケジュール済タスクの詳細が表示されます。

5. 「Max Retries」フィールドに数値を入力します。この数はOracle Identity Managerがタスクを完了するために試行する回数です。この数を超えると、ERRORステータスがタスクに割り当てられます。

6. 「Disabled」および「Stop Execution」チェック・ボックスが選択されていないことを確認します。

7. 「Start」リージョンで、「Start Time」フィールドをダブルクリックします。表示されている日時エディタから、タスクを実行する日時を選択します。

8. 「Interval」リージョンで、次のスケジュール・パラメータを設定します。

   • タスクを繰り返し実行するように設定するには、「Daily」、「Weekly」、「Recurring Intervals」、「Monthly」または「Yearly」のオプションを選択します。

     「Recurring Intervals」オプションを選択した場合は、タスクを再帰ベースで実行する時間間隔も指定する必要があります。

   • タスクを一度のみ実行するよう設定するには、「Once」オプションを選択します。

9. スケジュール済タスクのユーザーによる構成が可能な属性の値を指定します。指定する値の詳細は、「スケジュール済タスク属性の値の指定」を参照してください。

   
   

   関連資料: タスク属性の追加および削除の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

   
   

10. 「Save」をクリックします。スケジュール済タスクが作成されます。現在はタスクが実行されていないため、「Status」フィールドにINACTIVEステータスが表示されます。タスクは、ステップ7で設定した日時に実行されます。

スケジュール済タスクを作成したら、「Oracle Identity Managerリリース9.0.1のリコンシリエーションの有効化」に進みます。

スケジュール済タスク属性の値の指定

リコンシリエーション・スケジュール済タスクの次の属性に値を指定する必要があります。

注意: 属性値はインポートしたコネクタのXMLファイルで事前定義されています。変更する属性にのみ値を指定してください。

属性	説明	サンプル値
Server	ITリソースの名前	Telnet server- Solaris
Passwd Mirror File/User Mirror File	passwordミラー・ファイル/userミラー・ファイルの名前 この属性は、AIXでのみ使用されます。	/etc/passwd1
Shadow Mirror File	shadowミラー・ファイルの名前 注意: HP-UXの信頼できるシステムの場合でも、この属性の値はNULLまたは空白にはできません。ただし、HP-UXの信頼できるシステムでのリコンシリエーション・プロセスでは、この属性は無視されます。	/etc/shadow1
Target System Recon - Resource Object name	ターゲット・システムのリソース・オブジェクトの名前	Telnet User
Trusted Source Recon - Resource Object name	信頼できるソース・リソース・オブジェクトの名前	デフォルト値: Xellerate User 信頼できるソース・リコンシリエーションを構成しない場合にはfalse（小文字）を指定
Date Format	ターゲット・システムから送信される日付値が、リコンシリエーション中に保存される書式 指定する値は、「システム・プロパティの構成」の項で指定された値と同一である必要があります。	yyyy/MM/dd hh:mm:ss z

これらのタスク属性の値を指定したら、ステップ10に進んで、スケジュール済タスクを作成します。

Oracle Identity Managerリリース9.0.1のリコンシリエーションの有効化

Oracle Identity Managerリリース9.0.1を使用している場合は、次の手順を実行してリコンシリエーションを有効にする必要があります。

関連資料: 『Oracle Identity Managerデザイン・コンソール・ガイド』

1. Telnet Userの「Process Definition」フォームを開きます。このフォームは「Process Management」フォルダにあります。

2. 「Reconciliation Field Mappings」タブをクリックします。

3. ITリソース・タイプの各フィールドで次の操作を行います。

   1. フィールドをダブルクリックして、そのフィールドの「Edit Reconciliation Field Mapping」ウィンドウを開きます。

   2. 「Key Field for Reconciliation Matching」の選択を解除します。

手順7: アダプタのコンパイル

コネクタのXMLファイルのインポート時に、次のアダプタがOracle Identity Managerにインポートされます。

• Telnet Disable User

• Telnet Delete User

• Telnet Default Shell Updated

• Telnet Create User

• Telnet Set Password

• Telnet User UID Updated

• Telnet GECOS Updated

• Telnet Home Directory Updated

• Telnet Primary Group Name Updated

• Telnet Account Expiry Date Updated

• Telnet Password Change Time Updated

• Telnet Secondary Group Names Updated

• Telnet Inactive Days Updated

• Telnet User Login Updated

• Telnet Enable User

• Telnet Prepopulate User Login

• Telnet Prepopulate End Date

これらのアダプタを使用してターゲット・システムにアカウントをプロビジョニングするには、これらをコンパイルする必要があります。

「アダプタ・マネージャ」フォームを使用してアダプタをコンパイルするには、次のようにします。

1. 「アダプタ・マネージャ」フォームを開きます。

2. 現在のデータベースにインポートしたすべてのアダプタをコンパイルするには、「すべてをコンパイル」を選択します。

   （すべてではないが）複数のアダプタをコンパイルするには、コンパイルするアダプタを選択します。次に、「選択したものをコンパイル」を選択します。

   
   

   注意: 正常にコンパイルされなかったアダプタのみを再コンパイルするには、「以前の失敗分をコンパイル」をクリックします。そのようなアダプタはコンパイルのステータスがOKになっていません。

   
   

3. 「開始」をクリックします。Oracle Identity Managerにより、選択したアダプタがコンパイルされます。

4. Oracle Identity Managerがクラスタ環境にインストールされている場合は、OIM_home\xellerate\Adapterディレクトリから、コンパイル済のアダプタをクラスタの他の各ノードの同じディレクトリにコピーします。必要な場合には、その他のノードのアダプタ・ファイルを上書きします。その後、各ノードを再起動します。

アダプタの詳細情報を表示するには、次のようにします。

1. 「アダプタ・マネージャ」フォームでアダプタをハイライト表示します。

2. アダプタの行ヘッダーをダブルクリックするか、アダプタを右クリックします。

3. 表示されているショートカット・メニューから「アダプタの起動」を選択します。アダプタの詳細が表示されます。

注意: 一度に1つのアダプタをコンパイルするには、「アダプタ・ファクトリ」フォームを使用します。「アダプタ・ファクトリ」フォームおよび「アダプタ・マネージャ」フォームの使用方法の詳細は、『Oracle Identity Manager Toolsリファレンス・ガイド』を参照してください。

ターゲット・システムの複数のインストールに対するコネクタの構成

注意: この手順は、UNIX Telnetの複数のインストールに対してコネクタを構成する場合にのみ実行します。この手順の各ステップ実行の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

ターゲット・システムの複数のインストールに対してコネクタを構成するには、次のようにします。

1. 各ターゲット・システム・インストールに対して1つのリソースを作成して構成します。

   「IT Resources」フォームは「Resource Management」フォルダにあります。ITリソースは、コネクタのXMLファイルをインポートすると作成されます。このITリソースは、同じリソース・タイプの、残りのITリソース作成用のテンプレートとして使用できます。

2. 各ターゲット・システム・インストールについてリコンシリエーションを構成します。手順は、「手順6: リコンシリエーションの構成」を参照してください。ITリソースの指定に使用される属性の変更と、ターゲット・システム・インストールを信頼できるソースとして設定するかどうかの指定のみが必要です。

   UNIX Telnetの単一インストールまたは複数インストールのいずれも、信頼できるソースとして指定できます。

3. 必要であれば、Xellerate Userリソース・オブジェクトに対してリコンサイルされるフィールドを変更します。

管理およびユーザー・コンソールを使用してプロビジョニングを実行する場合、ユーザーのプロビジョニング先のUNIX Telnetインストールに対応するITリソースを指定できます。