Novell Documentation: eDirectory 8.8

ndstraceの使用

ndstraceユーティリティは、次の3つの主要部分で構成されています。

基本機能

ndstraceの基本機能は次のとおりです。

Linux、Solaris、AIX、またはHP-UXでndstrace画面のステータスを表示します。
一部の同期処理を開始します。

ndstrace画面を起動するには、サーバプロンプトで次のコマンドを入力します。

/opt/novell/eDirectory/bin/ndstrace

ndstraceの基本機能を開始するには、次の構文を使用してサーバプロンプトでコマンドを入力します。

ndstrace command_option

次の表では、入力可能なコマンドオプションのリストを示します。

オプション	説明
ON	基本トレースメッセージを含むeDirectoryトレース画面を起動します。
OFF	トレース画面を無効にします。
ALL	eDirectoryトレース画面を起動し、すべてのトレースメッセージを表示します。
AGENT	ON、BACKLINK、DSAGENT、JANITOR、RESNAME、およびVCLIENTフラグと同等のトレースメッセージを含むeDirectoryトレース画面を開始します。
DEBUG	デバッグに通常使用する定義済みのトレースメッセージのセットを有効にします。設定されるフラグは、ON、BACKLINK、ERRORS、EMU、FRAGGER、INIT、INSPECTOR、JANITOR、LIMBER、MISC、PART、RECMAN、REPAIR、SCHEMA、SKULKER、STREAMS、およびVCLIENTです。
NODEBUG	トレース画面は使用可能なままで、以前に設定したデバッギングメッセージはすべて無効にします。このオプションでは、メッセージもONのコマンドオプションが設定された状態のままになります。

デバッギングメッセージ

ndstrace画面が使用可能な場合、デフォルトのフィルタの設定に基づいて情報が表示されます。デフォルトで表示される情報の内容を変更するには、デバッギングメッセージフラグを使用してフィルタを操作します。デバッギングメッセージにより、eDirectoryのステータスを確認し、問題が発生していないかどうかを検証できます。

各eDirectory処理には、デバッギングメッセージのセットが含まれています。個々の処理中にそのデバッギングメッセージを表示するには、プラス記号(+)、および該当する処理名またはオプションを使用します。処理を表示しない場合は、マイナス記号(-)、および該当する処理名またはオプションを使用します。次に例を示します。

メッセージ	説明
set ndstrace = +SYNC	同期メッセージを表示します。
set ndstrace = -SYNC	同期メッセージを非表示にします。
set ndstrace = +SCHEMA	スキーマメッセージを表示します。

また、ブール演算子の&(AND)および|(OR)を使用して、デバッギングメッセージのフラグを結合することもできます。サーバコンソールでデバッギングメッセージを制御する構文は、次のとおりです。

set ndstrace = +trace_flag [trace_flag]

または

set ndstrace = +trace_flag> [&trace_flag]

次の表では、デバッギングメッセージ用のトレースフラグについて説明します。各トレースフラグは略語で入力できます。

トレースフラグ	説明
ABUF	eDirectory要求との連携、またはeDirectory要求への応答として受信されたデータを含む、インバウンドおよびアウトバウンドパケットバッファに関するメッセージと情報です。
ALOC	メモリ割り当ての詳細について示すメッセージです。
AREQ	他のサーバまたはクライアントからのインバウンド要求に関するメッセージです。
AUTH	認証に関するメッセージとエラーレポートです。
BASE	最小限のデバッギングレベルでのデバッグエラーメッセージ。
BLNK	バックリンクとインバウンドの破損通知メッセージおよびエラーレポートです。
CBUF	アウトバウンドDSクライアント要求に関するメッセージです。
CHNG	キャッシュ変更メッセージです。
COLL	以前に更新内容を受信したときのオブジェクトの更新情報に関するステータスおよびエラーレポートです。
CONN	ローカルサーバが接続を試みている相手のサーバ、およびローカルサーバが接続できない原因となっている可能性のあるエラーとタイムアウトについての情報を示すメッセージです。
DNS	eDirectory統合DNSサーバプロセスに関するメッセージです。
DRLK	分散リファレンスリンクメッセージです。
DVRS	eDirectoryが機能している可能性のあるDirXML^(R)ドライバ固有のエリアを示すメッセージです。
DXML	DirXMLイベントの詳細について示すメッセージです。
FRAG	eDirectoryメッセージをNCPサイズのメッセージに分解する、NCP^TMフラッガからのメッセージです。
IN	インバウンドの要求およびプロセスに関するメッセージです。
INIT	eDirectoryの初期化に関するメッセージです。
INSP	ソースサーバのローカルデータベース内のオブジェクトの整合性に関するメッセージです。このフラグを使用すると、ソースサーバのディスクストレージシステム、メモリ、プロセッサの要求量が増加します。オブジェクトが破損しない限り、このフラグは有効に設定しないでください。
JNTR	janitor、レプリカの同期、フラットクリーナなどのバックグラウンド処理に関するメッセージです。
LDAP	LDAPサーバに関するメッセージです。
LMBR	limber処理に関するメッセージです。
LOCK	ソースサーバのローカルデータベースロックの使用および操作に関するメッセージです。
LOST	消失エントリに関するメッセージです。
MISC	eDirectory内の異なるソースからのメッセージです。
MOVE	パーティションの移動操作、またはサブツリーの移動操作からのメッセージです。
NCPE	NCPレベルの要求を受信したサーバを示すメッセージです。
NMON	iMonitorに関するメッセージです。
OBIT	破損通知処理からのメッセージです。
PART	バックグラウンド処理および要求処理からのパーティション操作に関するメッセージです。
PURG	パージ処理に関するメッセージです。
RECM	ソースサーバのデータベースの操作に関するメッセージです。
RSLV	名前解決要求の処理に関するメッセージです。
SADV	SLP (Service Location Protocol)のツリー名とパーティションの登録に関するメッセージです。
SCMA	スキーマの同期処理に関するメッセージです。
SCMD	スキーマ関連の操作の詳細について示すメッセージです。インバウンド同期とアウトバウンド同期の両方についての詳細を示します。
SKLK	レプリカの同期処理に関するメッセージです。
SPKT	eDirectory NCPサーバレベルの情報に関するメッセージです。
STRM	ストリーム構文の属性の処理に関するメッセージです。
SYDL	レプリケーション処理時の詳細について示すメッセージです。
SYNC	インバウンド同期トラフィック(サーバ側で受信される内容)についてのメッセージです。
TAGS	トレースオプションを識別するタグ文字列が表示されます。このトレースオプションでは、トレース処理で表示される各行のイベントが生成されます。
THRD	バックグラウンド処理(スレッド)の開始時と終了時を示すメッセージです。
TIME	同期処理時に使用される遷移ベクトルに関するメッセージです。
TVEC	Synchronize Up To、レプリカ、および遷移ベクトルなどの属性に関するメッセージです。
VCLN	他のサーバへの接続の確立または切断に関するメッセージです。

ndstraceでデバッギングメッセージを使用していると、特に便利なトレースフラグがあることが分かります。Novellサポートで多く使用されているndstrace設定には、次のようなショートカットがあります。

set ndstrace = A81164B91

この設定を使用すると、複数のデバッギングメッセージを１つのグループとして使用できます。

バックグラウンド処理

eDirectoryのステータスを確認できるデバッギングメッセージの他に、eDirectoryバックグラウンド処理を強制的に実行するコマンドのセットも用意されています。バックグラウンド処理を強制的に実行するには、コマンドの先頭にアスタリスク(*)を付けます。例:

set ndstrace = *H

また、いくつかのバックグラウンド処理のステータス、タイミング、および制御を変更することもできます。これらの値を変更するには、コマンドの先頭に感嘆符(!)を付けて新しいパラメータまたは値を入力します。例:

set ndstrace = !H 15 (parameter_value_in_minutes)

eDirectoryバックグラウンド処理を制御する各ステートメントの構文を次に示します。

set ndstrace = *trace_flag [parameter]

または

set ndstrace = !trace_flag [parameter]

次の表では、バックグラウンド処理のトレースフラグ、必要なパラメータ、およびトレースフラグが表示する処理のリストを示します。

トレースフラグ	パラメータ	説明
*A	None	ソースサーバのアドレスキャッシュをリセットします。
*AD	None	ソースサーバのアドレスキャッシュを無効にします。
*AE	None	ソースサーバのアドレスキャッシュを有効にします。
*B	None	ソースサーバ上で1秒後にバックリンク処理の実行を開始するようにスケジュールします。
!B	時間	バックリンク処理の実行間隔を分単位で設定します。 Default=1500 minutes (25 hours) Range=2 to 10080 minutes (168 hours)
*CT	None	ソースサーバのアウトバウンド接続テーブルと、テーブルの現在の統計情報を表示します。これらの統計情報には、他のサーバやクライアントからソースサーバへのインバウンド接続に関する情報は含まれていません。
*CTD	None	コンマ区切りの形式で、ソースサーバのアウトバウンド接続テーブルと、テーブルの現在の統計情報を表示します。これらの統計情報には、他のサーバやクライアントからソースサーバへのインバウンド接続に関する情報は含まれていません。
*D	レプリカrootEntry ID	指定したローカルエントリIDをソースサーバの［すべてのオブジェクトを送信］リストから削除します。エントリIDでは、サーバのローカルデータベースで固有のパーティションルートオブジェクトを指定する必要があります。通常、このコマンドは、サーバのアクセス不能が原因でSend All Updates処理が何度試みられても失敗する場合にのみ使用します。
!D	時間	インバウンド同期およびアウトバウンド同期の間隔を指定した分数に設定します。 Default=24 minutes. Range=2 to 10080 minutes (168 hours)
!DI	時間	インバウンド同期の間隔を指定した分数に設定します。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
!DO	時間	アウトバウンド同期の間隔を指定した分数に設定します。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
*E	None	ソースサーバのエントリキャッシュを再初期化します。
!E	None	インバウンド同期およびアウトバウンド同期処理の実行を開始するようにスケジュールします。
!EI	None	インバウンド同期処理の実行を開始するようにスケジュールします。
!EO	None	アウトバウンド同期処理の実行を開始するようにスケジュールします。
*F	None	janitor処理の一部として、フラットクリーナ処理の実行がソースサーバ上で5秒後に開始されるようにスケジュールします。
!F	時間	フラットクリーナ処理の実行間隔を分単位で設定します。 Default=240 minutes (4 hours) Range=2 to 10080 minutes (168 hours)
*G	レプリカrootEntry ID	指定したルートパーティションIDの変更キャッシュを再構築します。
*H	None	ソースサーバ上で直ちににレプリカ同期処理の実行を開始するようにスケジュールします。
!H	時間	Heatbeat同期処理の実行間隔を分単位で設定します。 Default=30 minutes Range=2 to 1440 minutes (24 hours)
*HR	None	メモリ内で最後に送信されたベクトルを消去します。
*I	レプリカrootEntry ID	指定したローカルエントリIDをソースサーバの［すべてのオブジェクトを送信］リストに追加します。エントリIDでは、サーバのローカルデータベースで固有のパーティションルートオブジェクトを指定する必要があります。レプリカの同期処理では、［すべてのオブジェクトを送信］リストがチェックされます。パーティションのルートオブジェクトのエントリIDがリスト内に存在する場合、Synchronized Up To属性の値に関係なく、eDirectoryによってパーティション内のすべてのオブジェクトと属性が同期されます。
!I	時間	Heatbeat同期処理の実行間隔を分単位で設定します。 Default=30 minutes Range=2 to 1440 minutes (24 hours)
*J	None	レプリカの同期処理の一部として、ソースサーバ上でパージ処理の実行を開始するようにスケジュールします。
!J	時間	janitor処理の実行間隔を分単位で設定します。 Default=2 minutes Range=1 to 10080 minutes (168 hours)
*L	None	ソースサーバ上で5秒後にlimber処理の実行を開始するようにスケジュールします。
*M	Bytes	ソースサーバのndstrace.logファイルで使用する最大ファイルサイズを変更します。このコマンドは、デバッグファイルのステータスに関係なく使用できます。bytesの値は10000バイトから100MBまでの範囲で指定します。この範囲外の値が指定された場合、変更は発生しません。
!M	None	eDirectoryで使用されるメモリの最大量をレポートします。
!N	0\|1	名前の形式を設定します。 0=hex only 1=full dot form
*P	None	調整可能なパラメータとそのデフォルトの設定を表示します。
*R	None	TTFファイルをリセットします。デフォルトではsys:system\ndstrace.dbgファイルです。このコマンドは、SETパラメータのNDS Trace File Length Set to Zeroと同じ働きをします。
*S	None	サーバ上のレプリカを同期する必要があるかどうかをチェックするスカルク処理をスケジュールします。
!SI	時間	インバウンドスキーマ同期処理の実行間隔を分単位で設定します。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
!SO	時間	アウトバウンドスキーマ同期処理の実行間隔を分単位で設定します。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
!SIO	時間	時間を分単位で指定し、その間のインバウンドスキーマ同期処理を無効にします。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
!SO0	時間	時間を分単位で指定し、その間のインバウンドスキーマ同期処理を無効にします。 Default=24 minutes Range=2 to 10080 minutes (168 hours)
*SS	None	強制的に即時スキーマの同期を実行します。
*SSA	None	スキーマの同期処理の実行を即時に開始するようにスケジュールします。過去24時間に同期が実行されていた場合でも、すべてのターゲットスキーマでスキーマの同期が強制的に実行されます。
*SSD	None	ソースサーバの［ターゲットスキーマ同期］リストをリセットします。このリストでは、スキーマの同期処理の実行中にソースサーバと同期する必要のあるサーバが識別されます。レプリカを保持していないサーバは、サーバオブジェクトとレプリカを保持しているサーバのターゲットリストに包含されるように要求を送信します。
*SSL	None	ターゲットサーバのスキーマ同期リストを印刷します。
*ST	None	ソースサーバ上のバックグラウンド処理のステータス情報を表示します。
*STX	None	ソースサーバ上のバックリンク処理(外部参照)のステータス情報を表示します。
*STS	None	ソースサーバ上のスキーマ同期処理のステータス情報を表示します。
*STO	None	ソースサーバ上のバックリンク処理(破損通知)のステータス情報を表示します。
*STL	None	ソースサーバ上のlimber処理のステータス情報を表示します。
!T	時間	サーバの稼動状態のチェックの実行間隔を分単位で設定します。 Default=30 minutes Range=1 to 720 minutes (12 hours)
*U	サーバのオプションのID	コマンドにエントリIDが含まれていない場合は、以前に「down」から「up」にラベルが付加された任意のサーバのステータスを変更します。コマンドにローカルエントリIDが含まれている場合は、指定されたサーバのステータスを「down」から「up」に変更します。エントリIDは、ソースサーバのデータベースで固有であり、サーバを表すオブジェクトを参照する必要があります。
!V	リスト	制限のあるeDirectoryバージョンのリストを表示します。バージョンが表示されない場合は制限がないことを示します。各バージョンはコンマで区切られます。
*Z	None	現在、スケジュールされているタスクを表示します。