2 コネクタのデプロイ

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

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

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

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

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

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

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

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

• 手順8: SSLの構成

IBM Lotus Notes and Dominoの複数インストール用のコネクタを構成する場合は、次の手順を実行します。

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

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

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

項目	要件
Oracle Identity Manager	Oracle Identity Managerリリース8.5.3以降。
ターゲット・システム	IBM Lotus Notes and Domino Server 6.5以降。
外部コード	NCSO.jar Notes.jar これらのファイルの詳細は、「手順3: コネクタ・ファイルおよび外部コードのコピー」の項を参照してください。
ターゲット・システムのユーザー・アカウント	Domino Serverの管理者。 「ITリソースの定義」の項の手順を実行する際に、このユーザー・アカウントの資格証明を指定します。

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

Domino IIOP（DIIOP）タスクが実行されていることを確認する必要があります。

これを実行するには、IBM Lotus Notes and Dominoコンソールを開いて、Load DIIOPコマンドを実行します。

DIIOPタスクが実行されていない場合には、コマンドの実行後に開始されます。実行されている場合には、タスクはすでに開始されているというメッセージが表示されます。

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

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

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

インストール・メディア・ディレクトリのファイル	コピー先ディレクトリ
xml\xlLotusNotesConnector.xml	OIM_home\xlclient
xml\xlLotusNotes_XellerateUser.xml	OIM_home\xlclient
lib\JavaTask\xlLotusNotesProvision.jar	OIM_home\xellerate\JavaTasks
lib\ScheduleTask\xlLotusNotesRecon.jar	OIM_home\xellerate\ScheduleTask
resourcesディレクトリのファイル	OIM_home\xellerate\connectorResources
docs\B32156_01.pdf	OIM_home\xellerate\docs\LotusNotes

コネクタ・ファイルをコピーしたら、次のファイルをjava_installation\jre\lib\extディレクトリにコピーします。

• NCSO.jar（lotus_home\lotus\Domino\Data\domino\javaディレクトリ）

• Notes.jar（lotus_home\lotus\Dominoディレクトリ）

ここで、java_installationはOracle Identity Manager用に使用されるJDKディレクトリで、lotus_homeはIBM Lotus Notes and Dominoがインストールされているディレクトリです。

注意: 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. OIM_home\xlclientディレクトリにあるxlLotusNotesConnector.xmlファイルを探して開きます。このXMLファイルの詳細は、「ファイル・プレビュー」ページに表示されます。

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

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

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

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

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

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

    
    

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

    
    

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

    XMLファイルの内容が「インポート」ページに表示されます。一部のノードに十字形のアイコンが表示されている場合があります。各ノードを右クリックして「削除」を選択し、それらのノードを削除します。

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

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

ITリソースの定義

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

パラメータ	説明
AddBook	IDファイルの作成時に、Dominoディレクトリのサーバー・エントリを更新するかどうかを指定します。 値はTrueまたはFalseです。デフォルト値はTrueです。 Dominoディレクトリは、ユーザーの個人ドキュメント、接続ドキュメント、サーバー・ドキュメントおよび相互認証ファイルが含まれるデータベースです。このディレクトリは、パブリック・アドレス帳またはnames.nsfとも呼ばれます。
Admin	IBM Lotus Notes and Dominoのサーバー管理者のユーザーID。
AdminPwd	管理者のパスワード。
CertPath	IDの作成時に使用される認証者IDの完全なファイルの指定。
CertPwd	認証者IDファイルのパスワード。
CreateMailIDFile	IBM Lotus Notes and DominoのRegister New User機能を呼び出す際に、メール・データベースがIDファイルを使用して作成されるかどうかを指定します。 値はTrueまたはFalseです。デフォルト値はTrueです。
Host	IBM Lotus Notes and Dominoサーバーのホスト名またはIPアドレス。
Port	IBM Lotus Notes and DominoサーバーがリスニングするTCP/IPポート。 デフォルト値は63148です。
IDFilePath	IDファイルを保存するパス。
IDType	作成されるIDファイルのタイプ。 値はHIERARCHICALまたはCERTIFIERです。 デフォルトは172 (HIERARCHICAL)です。CERTIFIERの数値は173です。
IsDebug	デバッグ機能。 値はYESまたはNOです。デフォルト値はNOです。
MailDBPath	メール・ファイルのパス。
MailOwnerAccess	所有者に対するメール・データベースのACL設定。 次の値のいずれか: DESIGNER (1) EDITOR (2) MANAGER (0) デフォルト値は0です。
MailQuotaLimit	ユーザーの電子メール・データベースの最大サイズ（MB単位）。 デフォルト値は50です。
MailQuotaWarning	ユーザーのメール・データベースにより、サイズ制限を超えたという警告が発行されるサイズ（MB単位）。 デフォルト値は40です。
MailServer	ユーザーのメール・ファイルが含まれるサーバーの正規名。
MailSystem	ユーザーのメール・システム。 値は次のいずれかです。 INOTES (3) INTERNET (4) NOTES (0) デフォルト値は0です。
MailTemplateName	メール・ファイルの設計用のテンプレート名。
PasswordLength	パスワードに使用可能な最小文字数。 値は任意の数値です。デフォルトの最小長は5文字です。
RegLog	IDの作成時に使用するログ・ファイルの名前。
RegServer	IDの作成時およびその他の登録機能の実行時に使用するサーバーの名前。
StoreAddBook	サーバーのDominoディレクトリにIDファイルを保存するかどうかを示します。 値はTrueまたはFalseです。デフォルト値はTrueです。
SyncInternetPassword	IBM Lotus Notes and Dominoへのローカルのクライアント・ベースのアクセスとWebベースのアクセスの両方に、同じパスワードを使用できるかどうかを指定します。 値はTrueまたはFalseです。デフォルト値はTrueです。
LastReconciliationTimeStamp	最初のリコンシリエーションの実行では、このパラメータには値は保持されません。2回目から、このパラメータには最後のリコンシリエーションの実行が完了した時間が保持されます。 デフォルト値はNoneです。
IsSecure	SSL機能を有効化するかどうかを指定します。 値はYESまたはNOです。デフォルト値はNOです。
DenyAccessGroupName	アカウントが無効化されたユーザーのグループ名。
triggerAdminP	AdminPの起動機能を有効化するかどうかを指定します。 値はYesまたはNoです。デフォルト値はYesです。

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

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

リコンシリエーションを構成するには、次の手順を実行します。

• 信頼できるソース・リコンシリエーションの構成

• リコンシリエーション・スケジュール済タスクの作成

信頼できるソース・リコンシリエーションの構成

注意: この手順のこのステップは、信頼できるソース・リコンシリエーションを構成する場合にのみ実行します。信頼できるソース・リコンシリエーションに構成できるのは、1つのコネクタのみです。別の信頼できるソースを構成している状態でxlLotusNotes_XellerateUser.xmlファイルをインポートした場合、2つのコネクタのリコンシリエーションはいずれも機能しなくなります。 リコンシリエーションの構成の概念の詳細は、『Oracle Identity Manager Connectorフレームワーク・ガイド』を参照してください。

信頼できるソース・リコンシリエーションを構成するには、まず次のようにして、信頼できるソース・リコンシリエーションのXMLファイルをインポートする必要があります。

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

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

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

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

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

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

7. 「インポート」をクリックします。

8. 表示されているメッセージ内で、「インポート」をクリックしてそのXMLファイルをインポートすることを確認し、「OK」をクリックします。

次の項で説明されているステップの実行中に、IsTrustedリコンシリエーション・スケジュール済タスクの属性値をYESに設定します。

リコンシリエーション・スケジュール済タスクの作成

参照フィールドおよびユーザー・リコンシリエーションにスケジュール済タスクを作成するには、次のようにします。

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

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

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

4. 「Find」をクリックします。事前定義済のスケジュール済タスクの詳細は、2つの別々のタブに表示されます。

5. 1つ目のスケジュール済タスクの場合は、「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で設定した日時に実行されます。

11. ステップ5〜10を繰り返してもう1つのスケジュール済タスクを作成します。

両方のスケジュール済タスクを作成したら、「手順7: アダプタのコンパイル」の項に進みます。

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

この項では、次に示すスケジュール済タスクに指定する値の詳細を説明します。

• 参照フィールド・リコンシリエーション・スケジュール済タスク

• ユーザー・リコンシリエーション・スケジュール済タスク

参照フィールド・リコンシリエーション・スケジュール済タスク

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

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

属性	説明	デフォルト/サンプル値
TargetRO	リソース・オブジェクトの名前	LOTUSRO
ServerName	コネクタがデータのリコンサイルに使用するITリソース・インスタンスの名前	LotusNotes
LookupFieldName	リコンサイルされるグループ参照フィールドの名前	LookUp.Lotus.Grp

これらのタスク属性の値を指定したら、ステップ10へ進んでスケジュール済タスクを作成してください。

ユーザー・リコンシリエーション・スケジュール済タスク

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

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

属性	説明	デフォルト/サンプル値
TargetRO	リソース・オブジェクトの名前。	LOTUSRO
ServerName	コネクタがデータのリコンサイルに使用するITリソース・インスタンスの名前。	LotusNotes
IsTrusted	リコンシリエーションを信頼できるモードで実行する必要があるかどうかを指定。	YESまたはNO デフォルト値はNOです。
LoginNameField	値がXellerate Userのログイン名として使用されるパラメータ。 選択したパラメータの値が、IBM Lotus Notes and Dominoユーザーごとに一意であることを確認してください。	Notes.LastNameまたはNotes.ShortName
Notes.XellerateOrganisation	Oracle Identity Managerの組織名のデフォルト値。 この値は、Xellerate Userを信頼できるモードで作成するために使用されます。	Xellerate Users

これらのタスク属性の値を指定したら、ステップ10へ進んでスケジュール済タスクを作成してください。

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

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

• adpLNCreateuser

• adpLNUpdateUserName

• adpUpdateUserInfo

• adpLNDeleteUser

• adpLNEnableDisable

• adpLNUpdateGrp

• adpLNUpdatePassword

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

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

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

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

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

   
   

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

   
   

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

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

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

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

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

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

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

手順8: SSLの構成

注意: これはデプロイのオプションの手順です。この手順の詳細は、次のWebサイトを参照してください。 http://www-128.ibm.com/developerworks/lotus/library/ls-Java_access_2/

Oracle Identity ManagerおよびIBM Lotus Notes and Dominoサーバー間にSSL接続を設定するには、次のようにします。

1. SSL通信用のIBM Lotus Notes and Dominoサーバーで、DIIOPおよびHTTPタスクが実行されていることを確認してください。

   
   

   注意: 「手順2: ターゲット・システムの構成」の項で説明されている手順を実行済の場合、DIIOPタスクはすでに実行されています。

   
   

2. IBM Lotus Notes and Dominoサーバーで、Server Certificate Admin（certsrv.nsf）データベースを使用するキー・リングを作成します。2つのキー・リング・ファイルkeyfile.kyrおよびkeyfile.sthを、サーバーのデータ・ディレクトリに移動します。

3. DIIOPタスクを再度開始して、IBM Lotus Notes and Dominoデータ・ディレクトリにTrustedCerts.classという名前のファイルを生成します。次にデータ・ディレクトリのパスを示します。

   lotus_home\Lotus\Domino\Data
   
   

   このとき、lotus_homeはIBM Lotus Notes and Dominoがインストールされているディレクトリです。

4. TrustedCerts.classファイルをTrustedCerts.jarファイルにパッケージ化します。

5. TrustedCerts.jarファイルを、Oracle Identity Managerサーバーのjava_installation\jre\lib\extディレクトリに移動します。

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

注意: この手順は、IBM Lotus Notes and Dominoの複数インストール用のコネクタを構成する場合以外は実行しないでください。この手順の各ステップ実行の詳細は、『Oracle Identity Managerデザイン・コンソール・ガイド』を参照してください。

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

1. ターゲット・システムのインストールごとに、リソース・オブジェクトを1つ作成および構成します。

   「Resource Objects」フォームは、「Resource Management」フォルダにあります。コネクタのXMLファイルのインポート時に、LOTUSROリソース・オブジェクトが作成されます。このリソース・オブジェクトは、残りのリソース・オブジェクト作成用のテンプレートとして使用できます。

2. リソース・オブジェクトごとに1つずつITリソースを作成して構成します。

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

3. 各リソース・オブジェクトにプロセス・フォームを1つ設計します。

   「Form Designer」フォームは、「Development Tools」フォルダにあります。コネクタのXMLファイルのインポート時に、次のプロセス・フォームが作成されます。

   • UD_LOTUS（メイン・フォーム）

   • UD_LNGRP（子フォーム）

   これらのプロセス・フォームは、残りのプロセス・フォーム作成用のテンプレートとして使用できます。

4. 各リソース・オブジェクトに、プロセス定義を1つ作成および構成します。

   「Process Definition」フォームは、「Process Management」フォルダにあります。コネクタのXMLファイルをインポートすると、Lotus Processプロセス定義が作成されます。このプロセス定義は、残りのプロセス定義作成用のテンプレートとして使用できます。

   ターゲット・システム・インストールごとにプロセス定義を作成するとき、実行する必要のある次の手順は、それぞれのプロセス定義の作成に固有です。

   • 「Object Name」参照フィールドから、ステップ1で作成したリソース・オブジェクトを選択します。

   • 「Table Name」参照フィールドから、ステップ3で作成したプロセス・フォームを選択します。

   • 「IT Resource」データ型のアダプタ変数をマッピングするときは必ず、ステップ2で作成したITリソースを「Qualifier」リストから選択してください。

5. 各ターゲット・システム・インストールについてリコンシリエーションを構成します。手順は、「手順6: リコンシリエーションの構成」の項を参照してください。各リコンシリエーション・スケジュール済タスクで変更されるのは、次の属性の値のみです。

   • TargetRO

   • ServerName

   • IsTrusted

   信頼できるソースとして指定するIBM Lotus Notes and Dominoのインストールでは、IsTrusted属性をYESに設定します。信頼できるソースには、IBM Lotus Notes and Dominoの単一インストールを指定することも、複数インストールを指定することもできます。その他のIBM Lotus Notes and Dominoインストールでは、この属性をNOに設定します。

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

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