A.2.3. 使用方法

rsearch ユーティリティーを使用すると、LDAP 操作のパフォーマンスを測定できます。以下の例は、さまざまな一般的なテストシナリオに rsearch を使用する方法を示しています。

注記

rsearch は、フィルターやスコープなどの検索パラメーターの引数を必要としますが、これらの引数を空にして、他の種類の LDAP 操作のテストを実行することができます。以下に例を示します。

# rsearch -D "cn=Directory Manager" -w secret -s "" -f ""

A.2.3.1. 許可された設定ファイル

多くの場合、rsearch ツールはコマンドラインで渡された情報を使用してサーバーに接続します。rsearch ツールは、渡された引数の代わりに、2 つの異なる設定ファイルを受け入れることができます。

  • UID と UID のいずれかの一覧、または UID と UID のいずれかの一覧が含まれる DN または UID ファイル。DN/UID ファイルにより、rsearch は、複数のランダムバインド ID を使用して接続することができます。すべての操作テストは、bind/unbind テストと組み合わせることができます。

    警告

    このコマンドは、ディレクトリーからすでに削除された DN/UID ファイルの ID でバインドしようとする可能性があるため、削除テストでランダムなバインドアイデンティティーを使用しないでください。

    DN/UID ファイルは、- B オプションでファイルを渡してから、操作オプション(-c、-d、-m、または - x)で使用されます。

  • 指定の LDAP フィルターの一部として使用する名前の一覧が含まれる name ファイル。ファイルのフィルターは、- f オプションで指定したフィルターよりも複雑になります。フィルターファイルを使用して、さまざまな検索テストを実行できます。たとえば、フィルターがごくない場合にのみ、ツールはキャッシュから結果の取得を開始し、無効なフィルターを使用すると検索の失敗をテストできます。完全一致、複雑なフィルター、属性検索などのフィルターパフォーマンスをテストすることもできます。

    フィルターファイルを使用する場合は、-f オプションをプレースホルダーの値で渡す必要があります。プレースホルダーは、cn =%s などの属性値のみを置き換えるために使用できます。これにより、フィルターファイルから属性値変数をプルするようにコマンドに指示します。また、プレースホルダーはフィルター自体を置き換えることもできます(-f "%s")は、ファイルから無作為に選択したフィルターを指定することもできます。

    -i オプションは、検索フィルターに使用する名前ファイルを渡します。ファイルのすべての行は、- f オプションで指定したフィルターに追加されます。これらの 2 つのオプションを一緒に使用できるようにする方法はいくつかあります。

    • 最も単純なシナリオは -f オプションを空のままにするため、プレースホルダーでしかありません。この場合、フィルターは、- i オプションで渡されるファイルから直接取得されます。
    • または、ファイルのエントリーが単純に名前のリストになり、- f オプションにパーシャルフィルターを指定することもできます。たとえば、名前ファイルには UID の一覧(jsmith、bjensen、amorrow)があり、- f フィルターは "uid=" になる場合がありますrsearch は、検索フィルターを完了するために名前を自動的に追加します。