7.5. カスタムスキーマファイルの手動での作成

• ファイルは次のエントリーで始まる必要があります。

  dn: cn=schema

  Copy to Clipboard Toggle word wrap
• スキーマファイルには、属性タイプまたはオブジェクトクラス、あるいはその両方を含めることができます。
• オブジェクトクラス定義は、他のスキーマファイルで定義された属性を使用できます。

• カスタムスキーマファイルを使用するインスタンスに応じて、次のいずれかの場所に保存します。

  • /etc/dirsrv/slapd-<instance_name>/schema/ は、この特定のインスタンスでスキーマファイルを使用できるようにします。
  • /usr/share/dirsrv/schema/ は、このホストで実行しているすべてのインスタンスでスキーマファイルを使用できるようにします。

• デフォルトでは、Directory Server は 99user.ldif ファイルのカスタムスキーマを想定しています。別のファイル名を使用する場合は、以下のようにします。

  • 名前は、アルファベット順で 99user.ldif よりも前でなければなりません。たとえば、99aaa.ldif は問題ありませんが、99zzz.ldif は適切ではありません。

  • カスタムスキーマファイルは、00 から 98 までのコアスキーマファイルの後にロードする必要があるため、名前は 2 桁で始まり、01 より大きくなければなりません。

    Directory Server は、スキーマファイルをアルファベット順に読み取ります。したがって、たとえば、定義 99user.ldif を保存すると、名前が 00 と 01 で始まる標準ファイルの定義がオーバーライドされます。

• /usr/share/dirsrv/data/ ディレクトリーの標準スキーマファイルを使用する場合は、ファイルを使用するインスタンスに応じて、ファイルを /etc/dirsrv/slapd-<instance_name>/schema/ または /usr/share/dirsrv/schema/ にコピーします。ただし、宛先ディレクトリーで別のファイル名を使用してください。それ以外の場合は、Directory Server はアップグレード中にファイルの名前を変更し、.bak 接尾辞を追加します。

• ドット区切りの番号として指定された一意のオブジェクト識別子 (OID)。
• NAME attribute_name 形式の一意の名前。
• DESC description 形式の説明。
• SYNTAX OID 形式の属性値の OID。LDAP 属性構文の詳細は、RFC 4517 を参照してください。
• オプション: 属性が定義されているソース。

• ドット区切りの番号として指定された一意のオブジェクト識別子 (OID)。
• NAME attribute_name 形式の一意の名前。
• DESC description 形式の説明。
• SUP object_class 形式のこのオブジェクトクラスの上位 (親) オブジェクトクラス。関連する親がない場合は、SUP top を使用します。
• STRUCTURAL という単語は、オブジェクトクラスが適用されるエントリーのタイプを定義します。すべてのエントリーは、少なくとも 1 つの STRUCTURAL オブジェクトクラスに属している必要があります。AUXILIARY は、すべてのエントリーに適用できることを意味します。
• 必須属性のリスト。前に MUST キーワードが付きます。複数の属性を含めるには、グループを括弧で囲み、属性を `$ ` (ドル記号とスペース) で区切ります。
• MAY キーワードが前に付いたオプションの属性のリスト。複数の属性を含めるには、グループを括弧で囲み、属性を `$ ` (ドル記号とスペース) で区切ります。

• OID 2.16.840.1.1133730.2.1.123 および構文 Directory String (OID 1.3.6.1.4.1.1466.115.121.1.15) を持つ dateOfBirth という名前の単一値属性
• exampleperson という名前のオブジェクトクラス (親オブジェクトクラス (SUP top) がなく、dateOfBirth 属性が含まれる必要あり)

検証手順:

• /var/log/dirsrv/slapd-<instance_name>/errors ファイルを監視します。

  • ビルドが成功すると、Directory Server は次のログを記録します。

    [23/Sep/2021:13:47:33.334241406 +0200] - INFO - schemareload - schemareload_thread - Schema reload task starts (schema dir: default) ...
    [23/Sep/2021:13:47:33.415692558 +0200] - INFO - schemareload - schemareload_thread - Schema validation passed.
    [23/Sep/2021:13:47:33.454768148 +0200] - INFO - schemareload - schemareload_thread - Schema reload task finished.

    Copy to Clipboard Toggle word wrap
  • ビルドが失敗した場合、Directory Server は失敗した手順とその理由をログに記録します。