付録A Directory Server で利用可能なスクリプトのテスト

-a max_pending_ops

定義された最大保留操作数で、ツールを非同期モードで実行します。

-b base_dn

LDAP 操作テストの実行に使用するベース DN を指定します。指定しないと、デフォルト値は dc=example,dc=com になります。

-D bind_dn

サーバーへの接続に使用する ldclt ユーティリティーのバインド DN を指定します。

-E max_errors

ツールの終了までに、テスト LDAP 操作で許容されるエラー発生の最大数を設定します。デフォルトは 1000 です。

-e execution_params

テストに使用する操作のタイプおよび他のテスト環境パラメーターを指定します。-e の可能な値は、表A.2「実行パラメーター」 にリスト表示されています。このオプションには、コンマ区切りリストで複数の値を指定できます。

-f filter

検索テストに使用する LDAP 検索フィルターを指定します。

-h

テストを実行する Directory Server のホスト名または IP アドレスを指定します。ホストが指定されていない場合、ldclt はローカルホストを使用します。

-I error_code

特定のレスポンスコードにマッチするエラーが発生した場合に無視するように ldclt に指示します。たとえば、-I 89 は、エラーコード 89 を無視するようにサーバーに指示します。

-i inactivity_times

終了するまでにツールが非アクティブでいられる間隔を設定します。デフォルトでは、この設定は 3 で、これは 30 秒 (各操作の間隔が 10 秒) と解釈されます。

-N number_of_samples

実行する反復回数を設定します (10 秒間のテストを実行する回数)。デフォルトでは、この設定は無制限で、ツールは手動で停止した場合にのみ終了します。

-n number_of_threads

操作に対して同時に実行するスレッドの数を設定します。デフォルト値は 10 です。

-o SASL_option

SASL を使用してサーバーに接続するようにツールに指示し、使用する SASL メカニズムを指定します。形式は -o saslOption=value です。saslOption は、次の 6 つの値のいずれかになります。

* mech: SASL 認証メカニズム

* authid: サーバーにバインドしているユーザー (Kerberos プリンシパル)

* authzid: プロキシー認可 (プロキシー認可はサポートされていないため、サーバーによって無視されます)

* secProp: セキュリティープロパティー

* realm: Kerberos レルム

* flags

想定される値は、サポートされるメカニズムによって異なります。-o を複数回使用して、メカニズムに必要なすべての SASL 情報を渡すことができます。以下に例を示します。

[literal,subs="+quotes,verbatim"] …​. -o "mech=DIGEST-MD5" -o "authzid=test_user" -o "authid=test_user" …​.

-P supplier_port

レプリケーションテストのためにサプライヤーサーバーに接続するのに使用するポートを指定します。指定されていない場合のデフォルトは 16000 です。

-p port

テストしている Directory Server インスタンスのサーバーポート番号を指定します。

-Q

ツールをスーパー quiet モードで実行します。これは、ldclt が実行する操作で発生したエラーを無視します。

-q

ツールを quiet モードで実行します。

-R number

範囲の上限の数値を設定します。

-r number

範囲の下限の数値を設定します。

-S consumer_name

レプリケーションテストを実行するために接続するコンシューマーサーバーのホスト名を指定します。

-s scope

検索条件を指定します。ldapsearch と同様に、値は subtree、one、または base に設定することができます。

-T ops_per_thread

1 スレッドで許容される最大操作数を設定します。

-t timeout

LDAP 操作のタイムアウト期間を設定します。デフォルトは 30 秒です。

-V

ツールを高冗長モードで実行します。

-v

ツールを冗長モードで実行します。

-W wait_time

1 つの操作の終了後に次の操作を開始するまで ldclt ツールが待機する時間を秒単位で設定します。デフォルトは 0 で、待機時間がないことを意味します。

-w password

テストのために Directory Server にバインドする際に、-D アイデンティティーで使用するパスワードを指定します。

-Z /path/to/cert.db

テスト接続用に TLS を有効にし、証明書データベースとして使用するファイルを参照します。

abandon

非同期検索リクエストについて破棄操作を開始します。

add

ディレクトリーにエントリーを追加します (ldapadd)。

append

genldif オプションで生成された LDIF ファイルの最後にエントリーを追加します。

ascii

ASCII 7 ビットの文字列を生成します。

attreplace=name:mask

既存のエントリーの属性 (name) を置き換える変更操作を実行します。

attrlist=name:name:name

検索操作で返す属性のリストを指定します。

attrsonly=#

検索操作で使用して、属性値を読み取るかどうかを設定します。設定できる値は 0 (値を読み取る) または 1(値を読み取らない) です。

bindeach

ldclt ツールに対し、試行する各操作とバインドするように指示します。

bindonly

ldclt ツールに対し、バインド/バインド解除操作のみを実行するように指示します。他の操作は実行されません。

close

バインド解除操作を実行するのではなく、接続を終了するようにツールに指示します。

cltcertname=name

TLS 接続に使用する TLS クライアント証明書の名前を指定します。

commoncounter

ldclt ツールにより開いたすべてのスレッドが同じカウンターを共有します。

counteach

ツールに対し、成功した操作だけでなく、各操作をカウントするように指示します。

delete

削除操作を開始します。

deref

検索操作 (esearch) に間接参照制御を追加します。adds で、これは ldclt に、新しいエントリーに secretary 属性を追加するよう指示し、間接参照を許可します。

dontsleeponserverdown

サーバーが停止すると、ツールのループが非常に高速になります。

emailPerson

これにより、emailPerson オブジェクトクラスが生成されたエントリーに追加されます。これは add 操作でのみ有効です (-e add)。

esearch

完全一致の検索を実行します。

genldif=filename

操作で使用する LDIF ファイルを生成します。

imagesdir=path

テストで使用するイメージの場所を指定します。

incr

増分値を有効にします。

inetOrgPerson

これにより、inetOrgPerson オブジェクトクラスが生成されたエントリーに追加されます。これは add 操作でのみ有効です (-e add)。

keydbfile=file

TLS 接続で使用するキーデータベースのパスおよびファイル名を含めます。

keydbpin=password

キーデータベースにアクセスするためのトークンパスワードを含めます。

noglobalstats

定期的なグローバル統計値を 出力しない ようにツールに指示します。

noloop

増分数をループしません。

object=filename

入力ファイルからエントリーオブジェクトを作成します。

person

これにより、person オブジェクトクラスが生成されたエントリーに追加されます。これは add 操作でのみ有効です (-e add)。

random

ldclt ユーティリティーに、ランダムなフィルターやベース DNS などすべてのランダムな要素を使用するように指示します。

randomattrlist=name:name:name

ldclt ユーティリティーに対して、指定のリストからランダムな属性を選択するように指示します。

randombase

ldclt ユーティリティーに、ディレクトリーからランダムなベース DN を選択するように指示します。

randombaselow=value

乱数ジェネレーターの低い値を設定します。

randombasehigh=value

乱数ジェネレーターの高い値を設定します。

randombinddn

ldclt ユーティリティーに、ランダムなバインド DN を使用するように指示を出します。

randombinddnfromfile=file

ldclt ユーティリティーに対して、ファイルから選択したランダムなバインド DN を使用するように指示します。ファイルの各エントリーには、適切な DN/パスワードのペアが必要です。

randombinddnlow=value

乱数ジェネレーターの低い値を設定します。

randombinddnhigh=value

乱数ジェネレーターの高い値を設定します。

rdn=attrname:value

検索フィルターとして使用する RDN を提供します。これは、-f フィルターの代わりに使用されます。

referral=value

操作の参照動作を設定します。on (参照を許可する)、off (参照を許可しない)、または rebind(再度接続を試みる) の 3 つのオプションを選択できます。

smoothshutdown

ldclt ユーティリティーに、ワーカースレッドが終了するまでメインスレッドをシャットダウンしないように指示します。

string

ldclt ユーティリティーに、ランダムな数値ではなくランダムな文字列を作成するように指示します。

v2

テスト操作に LDAPv2 を使用するように ldclt ユーティリティーに指示します。

withnewparent

modRDN 操作を実行し、エントリーの名前を引数として設定した newparent に変更します。

randomauthid

ランダムな SASL 認証 ID を使用します。

randomauthidlow=value

ランダムな SASL 認証 ID の下限値を設定します。

randomauthidhigh=value

ランダムな SASL 認証 ID の上限値を設定します。

0

成功 (エラーなし)。

1

操作で深刻な致命的なエラーが発生した。

2

ツールで渡されたパラメーターにエラーがあった。

3

ツールが LDAP エラー数の上限に達した。

4

このツールが Directory Server インスタンスにバインドできなかった。

5

このツールが TLS 経由で接続するための TLS ライブラリーを読み込むことができなかった。

6

マルチスレッド (mutex) エラーが発生しました。

7

初期化に問題があった。

8

このツールが、メモリー割り当てエラーなどのリソース制限に達した。

99

スクリプトで不明なエラーが発生した。