第 8 章 Directory Preparation Tool (comm_dssetup.pl)

Communications Suite 製品のインストール後、サーバーをプロビジョニングして使用する前に、Directory Preparation Tool ( comm_dssetup.pl) を使用して Directory Server を準備する必要があります。これは、別個にインストールされるコンポーネントです。インストーラで、Directory Preparation Tool を選択する必要があります。この章の内容は次のとおりです。

• 「Directory Preparation Tool を実行する前に」

• 「Directory Preparation Tool の実行」

• 「スキーマファイルの手動更新」

• 「LDAP スキーマ内の Calendar Server OID 競合の解決」

以前のバージョンの Calendar Server または Messaging Server をインストールしている場合は、LDAP ディレクトリエントリを Schema 1 から Schema 2 に移行する必要がある場合があります。

この章で説明している設定ユーティリティーを実行する前に、必ず『Sun Java Communications Suite 5 Schema Migration Guide 』を参照してください。このマニュアルでは、設定ユーティリティーを実行するためのタイミングとオプションについて説明しています。

Directory Preparation Tool を実行する前に

ここでは、Directory Preparation Tool を実行する前に理解しておく必要のある情報が記載されています。ここで説明する内容は次のとおりです。

• 「Directory Preparation Tool の機能」

• 「Directory Preparation Tool の Directory Server に関する注意事項」

• 「Directory Preparation Tool を実行する前に収集する必要がある情報」

• 「Directory Preparation Tool スキーマ選択について」

• 「Access Manager に関する注意事項」

• 「Directory Preparation Tool によって作成される属性のインデックス」

Directory Preparation Tool の機能

Directory Preparation Tool は、次に示す 3 つの手順で処理を行います。

1. ユーティリティーオプションで選択された結果を収集します。

   この手順で必要な情報については、「Directory Preparation Tool を実行する前に収集する必要がある情報」を参照してください。

2. LDAP ディレクトリの変更に使用されるオプションからシェルスクリプトと LDIF ファイルを生成します。

   ディレクトリサーバーに Sun 製品を使用していない場合、または Directory Server をカスタマイズしている場合は、シェルスクリプトを実行せずにここで処理を停止します。詳細は、このあとの「Directory Preparation Tool の Directory Server に関する注意事項」を参照してください。

3. オプションの選択結果から作成されたシェルスクリプトを実行します。それに応じてディレクトリが変更されます。

   このユーティリティーでは、各手順の終わりに、続行するかどうかのメッセージが表示されます。3 番目の手順まで、LDAP ディレクトリに対する変更は行われません。

Directory Preparation Tool の Directory Server に関する注意事項

次に、LDAP ディレクトリに関する注意事項をいくつか示します。

• Directory Preparation Tool を実行する前に、ディレクトリサーバーのインストール、設定、および実行を行う必要があります。

• Directory Preparation Tool は、ユーザーのディレクトリサーバーと同じマシンで実行する必要があります。

• Directory Preparation Tool は、ディレクトリサーバーが存在するすべてのマシンで実行する必要があります。

• 将来、Directory Server をインストールした別のマシン (レプリカなど) を追加する場合は、そのマシンに対しても Directory Preparation Tool を実行してください。

• LDAP ディレクトリをカスタマイズした場合は、次の点に注意してください。

  • 属性にインデックスを作成した場合は、Directory Preparation Tool の実行後、これらの属性のインデックスを再生成する必要がある場合があります。

  • ほかの .ldif ファイル (スキーマ定義) を追加している場合は、影響を受けることはないため、何もする必要はありません。ただし、Directory Preparation Tool を実行する前に、カスタムスキーマ定義ファイルをバックアップしてください。

  • 上記の 2 つのカスタマイズも含め、どのようなカスタマイズを行う場合にも、スクリプトを生成したあと、実際に LDAP ディレクトリを更新する前に、Directory Preparation Tool を停止します。次に、スクリプトを調べて、この推奨アクションがどのように LDAP ディレクトリに影響を与えるかを評価します。ディレクトリに対してスクリプトを実行する前に、カスタマイズ内容を保護するために必要だと思われるあらゆるアクションを行います。

Directory Preparation Tool を実行する前に収集する必要がある情報

Directory Preparation Tool の最初の手順では、Directory Server に関する情報が必要になります。次の表に示す情報を収集して、このための準備をします。この情報を記録しておくために、「Directory Server インストール用ワークシート」を使用してください。

Directory Preparation Tool スキーマ選択について

Communications Suite サーバーは、次のスキーマ選択をサポートしています。

• Sun LDAP Schema 2 ネイティブモード

  Directory Preparation Tool スキーマバージョンの選択項目 2 に対応します。これは新規インストールの場合のデフォルトです。

• Sun LDAP Schema 1

  Directory Preparation Tool スキーマバージョンの選択項目 1 に対応します。

• Sun LDAP Schema 2 互換モード

  Directory Preparation Tool スキーマバージョンの選択項目 1.5 に対応します。

使用するスキーマを決めかねている場合、さらに詳細について、『Sun Java Communications Suite 5 配備計画ガイド』の「スキーマの選択について」および『Sun Java Communications Suite 5 Schema Migration Guide 』を参照してください。

Access Manager に関する注意事項

Schema 2 を使用している場合は、Access Manager をインストールして設定する必要があります。

ユーザーの管理に Access Manager コンソールを使用しないでください。Messaging および Calendar のユーザーの管理には、Delegated Administrator を使用してください。

Directory Preparation Tool によって作成される属性のインデックス

属性にインデックスを作成すると、検索アルゴリズムのパフォーマンスが向上します。ツールで属性にインデックスを作成できます。インデックスを作成する場合、Communications Suite 製品すべてに対してインデックスが追加されます。したがって、1 つの製品に対してインデックスの作成を行えば、ほかの製品に対して再度インデックスを作成する必要はありません。同じ属性に再度インデックスを作成しようとしても、何も起こりません。ツールは、インデックスが存在しない場合にだけ、インデックスが作成される属性ごとに db2index を呼び出します。

次の表に、Directory Preparation Tool によってインデックスが作成されるすべての属性をサフィックスのカテゴリ別に示します。また、属性ごとに作成されるインデックスのタイプも示します。Directory Server のインデックス作成については、http://docs.sun.com/coll/1316.1を参照してください。

このほかにもインデックスを独自に追加する場合は、インデックスの追加手順について、Directory Server のマニュアルを参照してください。

Directory Preparation Tool の実行

この節の内容は、次のとおりです。

• 「Directory Preparation Tool を実行する」

• 「Directory Preparation Tool を対話型モードで実行する」

• 「Directory Preparation Tool をサイレントモードで実行する」

Directory Preparation Tool を実行する

1. Directory Server がインストールされているサーバー上で、スーパーユーザー (root) としてログインするか、スーパーユーザーになります。

2. 必要に応じて Directory Server を起動します。

3. /opt/SUNWcomds/sbin ディレクトリに移動します。

   あるいは、必要に応じて、.zip ファイルが /opt/SUNWcomds/lib で入手できます。

4. サイレントモードまたは対話型モードで、Directory Preparation Tool を実行します。

   詳細な手順については、「Directory Preparation Tool の実行」または「Directory Preparation Tool の実行」を参照してください。

   ツールスクリプトを実行するには、インストーラによって自動的にインストールされ、共有コンポーネントとして組み込まれているバージョンの Perl を使用します。インストールが終わると、Perl は次のディレクトリに保存されています。

   ds-svr-base/bin/slapd/admin/bin/perl

Directory Preparation Tool を対話型モードで実行する

対話型モードで Directory Preparation Tool を実行するには、引数なしでスクリプトを実行し、表示された質問に対して選択項目を入力します。

次の番号付きのリストは、対話型モードのスクリプトの使用方法をパネルごとに示しています。

1. 「最初の画面」パネル

   # cd /opt/SUNWcomds/sbin # ./comm_dssetup.pl Welcome to the Directory Server preparation tool for Sun Java System Communications Services. (Version 6.3 Revision 0.1) This tool prepares your directory server for use by the communications services which include Messaging, Calendar and their components. The logfile is /var/tmp/dssetup_YYYYMMDDHHSS Do you want to continue [y]:

   Enter キーを押して続行するか、no と入力してから Enter キーを押して終了します。

2. 「Directory Server のインストールルート」パネル

   Please enter the full path to the directory where the Sun Java System Directory Server was installed. Directory server root [/var/opt/mps/serverroot]

   Directory Server のインストールルートの場所を指定します。デフォルトをそのまま使用する場合は、Enter キーを押します。

3. 「Directory Server のインスタンス」パネル

   マシンに Directory Server の複数のインスタンスがある場合は、それらが表示され、1 つを選択するように求められます。

   Please select a directory server instance from the following list: [1] slapd-varrius Which instance do you want [1]:

   選択項目に対応する番号を入力し、Enter キーを押します。デフォルトをそのまま使用する場合は、番号を入力せずに、Enter キーを押します。

4. 「Directory Manager の識別名 (DN)」パネル

   この画面には、Directory Manager DN を入力する部分と Directory Manager のパスワードを入力する部分があります。

   1. 最初に、Directory Manager の DN (識別名) の入力が求められます。

      Please enter the directory manager DN [cn=Directory Manager]:

      Directory Manager DN (デフォルトは cn=Directory Manager) は組織ツリー内のユーザーおよびグループのデータに責任を持つ管理者です。このスクリプトで指定する Directory Manager DN が、Calendar Server 設定や Messaging Server 設定と同様、Directory Server のインストールに設定したものと同じ DN であることを確認してください。

      デフォルトをそのまま使用する場合は、Enter キーを押します。

   2. Directory Manager のパスワードの入力が求められます。

      Password:

      Directory Manager のパスワードを入力し、Enter キーを押します。

      Directory Server が実行しており、ポート 389 (デフォルトポート) で待機しているかどうかが確認されます。

      成功すると、次の例に示すように、検出されたバージョンが表示されます。

      Detected DS version 5.2

      成功しなかった場合は、Directory Server が実行しているか、またはポート 389 (デフォルト) で待機していることが検出されなかったことが伝えられます。続行する前にこの問題を修正するように指示されます。スクリプトは終了します。以下にこの出力の例を示します。

      Directory Server not running or not listening to port 389. Detected DS version 0.0 Please correct the problem and re-run this script.

5. 「ユーザーおよびグループの Directory Server」パネル

   Will this directory server be used for users/groups [Yes]:

   このディレクトリのインスタンスが設定データの格納にのみ使用される場合は No を入力します。デフォルトをそのまま使用する場合は Enter キーを押します。

   No を入力した場合は、ユーザーおよびグループのデータを格納するディレクトリインスタンスに対してもこのスクリプトを実行する必要があります。この作業は、設定プログラム csconfigurator.sh を実行する前に行ってください。

   回答が Yes の場合は、組織ツリーに対するユーザーおよびグループベースのサフィックスを指定する必要があります。

6. 「ユーザーおよびグループベースのサフィックス」パネル

   Please enter the Users/Groups base suffix [o=usergroup]:

   ユーザーおよびグループベースのサフィックスは、LDAP 組織ツリーの最上位のエントリです。必ず、ここで選択したサフィックスが Directory Server、Communications Suite サーバーおよび Access Manager に対して指定したサフィックスと同じになるようにしてください。

7. 「スキーマタイプ」パネル

   There are 3 possible schema types: 1-schema 1 for systems with Calendar or Messaging 5.x data 1.5-schema 2 compatibility for systems with Calendar or Messaging 5.x data that has been converted with the Schema Migration Utility commdirmig 2-schema 2 native for systems using Access Manager Please enter the Schema Type (1, 1.5, 2) [1]:

   スキーマタイプを入力します。デフォルトをそのまま使用する場合は、Enter キーを押します。

   ---

   注 –

   Schema 2 (オプション 1.5 または 2) を使用する場合は、Access Manager のインストールと設定を行う必要があります。そうしないと、Directory Preparation Tool が終了します。Directory Preparation Tool を再実行する前に、Access Manager をインストールする必要があります。

   ---

8. 「ドメインコンポーネント (DC) ツリーベースのサフィックス」パネル

   Schema 1 または Schema 2 の互換モードを選択した場合は、DC ツリーベースのサフィックスを入力するように求められます。Schema 2 ネイティブモードを選択した場合は、このメッセージは表示されません。

   Please enter the DC Tree base suffix [o=internet]:

   前述した「スキーマタイプ」パネルで Schema 1 または Schema 2 の互換モードを選択した場合は、DC ツリーベースのサフィックスを入力するように求められます。Schema 2 ネイティブモードを選択した場合は、このメッセージは表示されません。

   DC ツリーはローカル DNS 構造をミラー化し、ユーザーおよびグループのデータエントリを含む組織ツリーへのインデックスとして、システムによって使用されます。DC ツリーベースのサフィックスは、DC ツリーの最上位エントリ名です。

   サフィックスを入力します。デフォルトをそのまま使用する場合は、Enter キーを押します。

9. 「質問」パネル

   この次の画面では、ディレクトリへの更新に関する一連の質問が表示されます。

   1. 「スキーマファイルの更新」

      この時点で、プログラムはスキーマの要素が正しいかどうかを確認します。スキーマに足りない要素があると、次のメッセージを表示します。

      Detected bad schema elements in 99user.ldif. It is recommended that you update the schema. Do you want to update the schema files [yes]:

      必要な新しい要素をスキーマに追加する場合は、Yes と回答します。新しいバージョンの Calendar Server または Messaging Server をインストールするたびに、新しいスキーマファイルでディレクトリを更新する必要があります。

      ここでスキーマファイルを更新しない場合は、No と回答します。

   2. 「新しいインデックスの設定」

      前の手順でスキーマを更新するようにした場合は、新しいインデックスを設定するかどうか尋ねられます。属性にインデックスを作成する方法については、「Directory Preparation Tool によって作成される属性のインデックス」を参照してください。

      Do you want to configure new indexes [yes]:

      インデックスの作成を承認する場合は、Enter キーを押します。

      すでに同じ属性に対してインデックスの作成手順を実行している場合は、no を入力します。

   3. 「インデックスの再生成」

      すぐにインデックスを作成するか、あとで作成するかを選択できます。あとでインデックスを作成することを選択した場合は、都合のいいときにインデックスの作成を有効にしてスクリプトを再実行します。インデックス作成には長い時間がかかる可能性がありますが、Directory Server はその間も機能しています。つまり、インデックスの作成中も読み取り専用モードにはなりません。

      Reindex now [yes]?

      あとでインデックスの作成を行いたい場合は、no を入力します。そうでない場合は、Enter キーを押して、デフォルトをそのまま使用します。

10. 「設定の概要」パネル

    Directory Preparation Tool は Directory Server 設定を更新する前に、設定の概要を表示し、続行するかどうかを質問します。

    Here is a summary of the settings that you chose: Server Root : /var/opt/mps/serverroot/ Server Instance : slapd-varrius Users/Groups Directory : yes Update Schema : yes Schema Type : 1 DC Root : o=internet User/Group Root : dc=red,dc=sesta,dc=com Add New Indexes : yes Reindex New Indexes Now : yes Directory Manager DN : cn=Directory Manager Now ready to generate a shell script and ldif file to modify the Directory. No changes to the Directory Server will be made this time. Do you want to continue [Y]:

    「Directory Preparation Tool の実行」で Schema 2 ネイティブモードを選択した場合、DC ルートは「User/Group Root」で入力した値と同じになります。

    設定を変更するには、no と入力してスクリプトを再実行します。

    続行する場合は Enter キーを押します。Directory Preparation Tool によって LDIF ファイルとシェルスクリプトが作成されます。作成されるファイルの名前は次のようになります。

    /var/tmp/dssetup_timestamp.ldif

    /var/tmp/dssetup_timestamp.sh

    続行すると、プログラムの実行に従って、メッセージが表示されます。次に、出力の例を示します。

    Generating files... Checking to see if Suffixes need to be added Checking to see that uid uniqueness plugins are turned off Adding indexes Adding Indexes for User/group Tree (backend:userRoot) Checking indexes for member No new indexes required Checking indexes for mailAlternateAddress No new indexes required Checking indexes for mail No new indexes required Checking indexes for mailEquivalentAddress No new indexes required Checking indexes for cosspecifier No new indexes required Adding Indexes for DC Tree (backend:internetdb2) Checking indexes for inetCanonicalDomainName No new indexes required Checking indexes for inetDomainBaseDN No new indexes required Adding Indexes for PAB Tree (backend:pabdb2) Checking indexes for memberOfPAB No new indexes required Checking indexes for icsCalendar No new indexes required Checking indexes for un No new indexes required Checking indexes for memberOfPABGroup No new indexes required Checking indexes for icsCalendarOwned No new indexes required Checking indexes for memberOfManagedGroup No new indexes required Adding Indexes for New PAB Tree (backend:PiServerDbdb2) Checking indexes for MemberOfPiBook No new indexes required Checking indexes for MemberofPiGroup No new indexes required Checking indexes for displayname No new indexes required Checking to see if DN needs to be created for suffixes Generating ldif for installer metadata Generating ldif for Adding schema for installer metadata Generating ldif for updating DN for cn=CommServers,o=comms-config The following files have been created: /var/tmp/dssetup_20041209114027.sh /var/tmp/dssetup_20041209114027.ldif Running /var/tmp/dssetup_20041209114027.sh will make changes to the Directory. You can run this file now or at a later time Ready to execute the script now.

11. 「スクリプトの実行」

    Do you want to continue [yes]:

    デフォルトの設定 (yes) をそのまま使用する場合は、Enter キーを押します。 dssetup_timestamp.sh スクリプトが LDAP ディレクトリに対して実行されます。スクリプトを今すぐ実行しない場合は、No を入力して終了します。終了した場合は、あとで /var/tmp/dssetup_ timestamp.sh スクリプトを実行できます。

    次に、スクリプトの実行中に生成されるテキスト出力の例を示します。

    Running /var/tmp/dssetup_20041209114027.sh -D "cn=Directory Manager" -j /var/tmp/dssetup_20041209114027.pw Stopping Directory Server Updating Schema files... Copying 20subscriber.ldif Copying 50ns-delegated-admin.ldif Copying 50ns-mail.ldif Copying 50ns-mlm.ldif Copying 50ns-msg.ldif Copying 50ns-value.ldif Copying 55ims-ical.ldif Copying 56ims-schema.ldif Copying 70sun-schema2.ldif Copying 71sun-am.ldif Copying 60iplanet-calendar.ldif Copying 50ns-iabs.ldif Copying 98ns-dummy-uwc.ldif Copying 70delgated-admin.ldif Copying /var/tmp/99user_20041209114027.ldif to /var/opt/mps/serverroot/slapd-varrius/config/schema/99user.ldif Starting Directory Server Applying ldif file /var/tmp/dssetup_20041209114027.ldif modifying entry cn=schema modifying entry cn=schema modifying entry cn=CommServers,o=comms-config Done Applying ldif file /var/tmp/dssetup_20041209114027.ldif rejects to /var/tmp/dssetup_20041209114027.ldif.rej status = 0 Successful Completion. Consult /var/tmp/dssetup_20041209114027.log for details

Directory Preparation Tool をサイレントモードで実行する

• 「Directory Preparation Tool サイレントモードの手順」

• 「Directory Preparation Tool サイレントモードの構文」

Directory Preparation Tool サイレントモードの手順

サイレントモードで Directory Preparation Tool を実行するには、「Directory Preparation Tool サイレントモードの構文」に示す構文を使って、オプションの文字列が付いた Perl コマンドを実行します。オプション引数はすべて必須です。表 8–1 にそれらのオプションを示します。

このユーティリティーによって、次の LDIF ファイルとシェルスクリプトが作成され、LDAP ディレクトリのインデックスとスキーマが更新されます。

/var/tmp/dssetup_timestamp.ldif

/var/tmp/dssetup_timestamp.sh

指定したオプションの値に応じて、ユーティリティーが新しいスクリプトを実行して Directory Server を更新するかどうかが決まります。更新を行わないようにした場合は、スクリプトを確認し、必要な変更を行ってから、あとで実際の更新を行うことができます。

Directory Preparation Tool サイレントモードの構文

サイレントモードで実行するすべてのオプションを次に示します。

perl comm_dssetup.pl
    -i yes|no
    -R yes|no
    -c DirectoryServerRoot
    -d DirectoryInstance
    -r DCTreeSuffix
    -u UserGroupSuffix
    -s yes|no
    -D DirectoryManagerDN
    -w DirectoryManagerPassword
    -b yes|no -t 1|1.5|2
    -m yes|no
   [-S PathtoSchemaFiles]
               

スキーマファイルの手動更新

なんらかの理由で、Directory Preparation Tool が生成したスクリプトを実行しないことにした場合は、次の指示に従って、Sun Java System Directory Server のスキーマファイルを手動で更新できます。

LDAP ディレクトリのスキーマを手動で更新し、あとで Calendar Server をアップグレードした場合、LDAP サーバーのスキーマをもう一度手動で更新する必要があります。スキーマを手動で更新したあとは、Calendar Server によってスキーマが自動的に更新されることはありません。

LDAP ディレクトリを手動で更新する

1. Calendar Server 6.3 をインストールします。

2. Calendar Server が動作している場合は、停止します。

3. Directory Server が動作している場合は、停止します。

4. 60iplanet-calendar.ldif ファイルを、ディレクトリサーバーが動作しているマシン上の次のディレクトリにコピーします。

   dir-svr-base/slapd-hostname /config/schema

   dir-svr-base は Directory Server のインストールディレクトリを示し、hostname はマシンを識別します。

5. 属性にインデックスを作成する場合は、設定プログラムと同じように、この時点で行います。

   設定プログラムによってインデックスが作成される属性のリストについては、「Directory Preparation Tool によって作成される属性のインデックス」を参照してください。

6. Directory Server を再起動します。

   オブジェクト識別子 (OID) に関するエラーが発生した場合は、「LDAP スキーマ内の Calendar Server OID 競合の解決」を参照してください。

LDAP スキーマ内の Calendar Server OID 競合の解決

LDAP スキーマで OID が競合している場合、Directory Server はどの OID を使用するかを判断できず、エラーメッセージを返します。たとえば、次のメッセージは icsCalendarUser オブジェクトクラスの OID の競合を示します。

[24/Apr/2004:23:45:28 -0700] dse - 
The entry cn=schema in file 99user.ldif is invalid, 
error code 20 (Type or value exists) - object class icscalendaruser: 
   The name does not match the OID. 
   Another object class is already using the name or OID.
[24/Apr/2004:23:45:28 -0700] dse - 
Please edit the file to correct the reported problems 
and then restart the server.

この問題は Calendar Server 6.3 をインストールしていて、さらに Directory Server 99user.ldif ファイルを動的に更新する旧バージョンの Calendar Server が存在している場合に発生する可能性があります。

OID の競合を解決するには、次の 2 つの手順を実行します。

1. 99user.ldif ファイルの編集と古い OID の削除です。Calendar Server 6.3 について、問題を起こす可能性のある特定の OID を次の表に示します。

   オブジェクトクラス	古い OID	新しい OID
   icsCalendarUser	2.16.840.1.113730.3.2.141	1.3.6.1.4.1.42.2.27.9.2.44
   icsCalendarResource	2.16.840.1.113730.3.2.143	1.3.6.1.4.1.42.2.27.9.2.45
   icsCalendarDomain	2.16.840.1.113730.3.2.144	1.3.6.1.4.1.42.2.27.9.2.4

2. 99user.ldif ファイルを編集したあとで、Directory Server を再起動します。