Overview#

Ndstrace is a command "Window" and utility used for tracing event in eDirectory

Ndstrace Anomalies#

Some things we have noticed about Ndstrace

NDSTRACE Examples#

Some NDSTRACE Examples we have used that we have found helpful, but often forget.

ndstrace Searches#

Often we find ourselves digging through a Ndstrace files looking for that proverbial needle. We found some ndstrace Searches that seem to work pretty well in assisting.

Maintenance Commands ndstrace(1M)#

NAME#

ndstrace - Utility that displays the server debug messages.

SYNOPSIS#

       /opt/novell/eDirectory/bin/ndstrace

       ndstrace  [-l|-u|-c  "command1;......"|--version]  [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>]
       [svty <severity_level>] [conn <connection_ID>]

DESCRIPTION#

The ndstrace utility displays messages related to the internal view of Novell* eDirectory* activity. The ndstrace utility uses a number of commands and filters to manipulate the amount of information displayed. It also has commands that initiate certain synchronization processes, and others that allow for changing certain eDirectory parameters on the server.

You can load ndstrace in two modes, the UI/Curses mode and command line mode. The ndstrace command without any option loads the ndstrace utility in the UI/curses mode. Type Exit from this mode to unload the utility.

The various ndstrace options are listed below:

OPTIONS#

  • -l Loads the ndstrace utility in the command line mode. You can redirect the output messages to a file in the background.
  • -u Unloads the ndstrace utility.
  • -c command - The ndstrace commands can be given through the command line as a list with items separated by semicolons (;).
  • --version - Prints the version information.
  • -h Specifies the interface and port on which the server is listening.
  • --config-file - Specifies the location of the nds.conf configuration file.

thrd <thread ID>#

Filters the trace messages based on the thread ID. For example, to enable filtering for thread ID 35, enter the following:
            dstrace thrd 35
To disable filtering based on thread ID, enter the following:
            dstrace thrd

svty <severity_level>#

Filters the trace messages based on the severity level. The severity levels can be FATAL, WARN, ERR, INFO, and DEBUG. For example, to enable filtering for severity level fatal, enter the following:
         dstrace svty fatal
To disable filtering based on the severity level, enter the following:
            dstrace svty

conn <connection_ID>#

Filters the trace messages based on the connection ID. For example, to enable filtering for connection ID 21, enter the following:
            dstrace conn 21
To disable filtering based on connection ID, enter the following:
            dstrace conn

BASIC COMMANDS#

Syntax#

set ndstrace = <Flag>

Flags#

ON Enables the ndstrace debug screen, but does not set or reset filters.

OFF Disables the ndstrace debug screen, but does not reset the filters.

ALL Enables all debug trace message filters. Buffers are turned on with this command.

DEBUG Turns on a predefined set of general debugging messages by enabling the following filters: TAGS, FRAG, JNTR, SPKT, BEMU, INIT, LMBK, RECM, SCMA, SKLK, BLNK, INSP, MISC, PART and TVEC.

AGENT Turns on a predefined set of DS Agent-related debugging messages by enabling the following filters: TAGS, JNTR, AREQ, BLNK, RSLV and TVEC.

NODEBUG Turns off all the filters.

FILTERS#

Syntax#

set ndstrace = [+|-]<filter>

ndstrace [+|-]<filter> [ [+|-]<filter> .... ]

Filters Values#

  • ABUF - Enables inbound and outbound packet buffers that contain data being received in conjunction with, or in response to, an eDirectory request.
  • ALOC - Enables debug and error messages to show the details of memory allocation.
  • AREQ - Enables status and error reports concerning inbound requests from other servers or clients.
  • AUTH - Enables authentication messages and error reports.
  • BASE - Enables debug error messages at the minimum debugging level.
  • BLNK - Enables back link and inbound obituary messages and error reports.
  • CBUF - Enables debug error messages to display outbound DS Client requests.
  • CHNG - Enables change cache messages.
  • COLL - Enables status and error reports concerning an object's update information when the update has been previously received.
  • CONN - Enables debug error messages to show information about the servers your server is trying to connect to, and to see errors and timeouts that might be causing your server not to connect.
  • DNS - Enables debug error messages about the eDirectory-integrated DNS server processes.
  • DRLK -Enables distributed reference link messages.
  • DVRS - Enables - debug error messages to show DirXML driver-specific areas that eDirectory might be working on.
  • DXML - Enables debug and error messages to show details of DirXML events.
  • FRAG - Enables messages from the NCP* fragger, which breaks eDirectory messages into messages sized of NCP.
  • IN - Enables status messages and error reports concerning inbound requests and processes.
  • INIT - Enables debug error messages related to the initialization of eDirectory.
  • INSP - Enables status messages and error reports concerning the integrity of the objects in the source server's local database.
    Important: Use of this flag increases the demands on the source server's disk storage system, memory, and processor. Do not leave this flag enabled unless objects are being corrupted.
  • JNTR - Enables status messages and error reports concerning the following background processes: janitor, replica synchronization, and Flat cleaner.
  • LDAP - Enables LDAP server messages.
  • LMBR - Enables limber status messages and error reports.
  • LOCK - Enables status messages and error reports concerning the use and manipulation of the source server's local database locks.
  • LOST - Enables lost entry messages.
  • MISC - Various messages and errors from different sources in eDirectory.
  • MOVE - Enables messages from the move partition or move subtree operations.
  • NCPE - Enables debug error messages to show the server receiving requests at the NCP level.
  • NMON - Enables debug and error messages about iMonitor.
  • OBIT - Enables messages from the obituary process
  • PART - Enables status messages and error reports about partition operations from background processes and from the request processing.
  • PURG - Enables debug error messages about the purge process.
  • RECM - Enables status messages and error reports concerning the manipulation of the source server's database.
  • RSLV - Enables status messages and error reports concerning the processing of resolve name requests.
  • SADV - Enables debug error messages for the registration of tree names and partitions with the Service Location Protocol (SLP).
  • SCMA - Enables status messages and error reports concerning the schema synchronization process.
  • SCMD - Enables debug and error messages to show details of schema-related operations. It gives details of both inbound and outbound synchronization.
  • SKLK - Enables status messages and error reports concerning the replica synchronization process.
  • SPKT - Enables debug error messages about eDirectory NCP server-level information.
  • STRM - Enables status messages and error reports concerning the processing of attributes with a Stream syntax.
  • SYDL - Enables debug error messages to show more details during the replication process.
  • SYNC - Enables debug error messages of inbound synchronization traffic (what is being received by this server).
  • TAGS - Enables the tag string that identifies the trace option that generated the event on each line output by the trace process.
  • THRD - Enables debug error messages to show when any background processes (threads) begin and end.
  • TIME - Enables debug error messages about the transitive vectors that are used during the synchronization process.
  • TVEC - Enables various messages pertaining to the following attributes: Synchronize Up To, Replica Up To, and Transitive Vector.
  • VCLN - Enables status messages and error reports concerning the establishment or deletion of connections with other servers.
  • WANM - Enables messages logged by Wan traffic manager, mostly at the connection layer.

STARTING BACKGROUND PROCESSES#

Syntax#

set ndstrace = *<flag>

Flag Values#

  • A - Resets the address cache on source server.
  • AD - Disables the address cache on source server.
  • AE - Enables the address cache on source server.
  • B - Schedules the back link process to begin execution on the source server in one second.
  • CT - Displays the source server's outbound connection table and the current statistical information for the table. These statistics do not give any information about the inbound connections from other servers or clients to the source server.
  • CTD - Displays, in comma-delimited format, the source server's outbound connection table and the current statistical information for the table. These statistics do not give any information about the inbound connections from other servers or clients to the source server.
  • D <HEX> - Removes the specified local entry ID from the source server's Send All Object list. The entry ID must specify a partition root object that is specific to the server's local database. This command is usually used only when a Send All Updates is endlessly trying and cannot be completed because a server is inaccessible.
  • E - Re-initializes the source server's entry cache.
  • F - Schedules the Flat cleaner process, which is part of the janitor process, to begin execution on the source server in five seconds.
  • G <hex> - Rebuilds the change cache of the specified root partition ID.
  • H - Schedules the replica synchronization process to begin execution immediately on the source server.
  • HR - Clears the in-memory last sent vector.
  • I <HEX> - Adds the specified local entry ID to the source server's Send All Object list. The entry ID must specify a partition root object that is specific to the server's local database. The replica synchronization process checks the Send All Object list. If the entry ID of a partition's root object is in the list, eDirectory synchronizes all objects and attributes in the partition, regardless of the value of the Synchronized Up To attribute.
  • J - Schedules the purge process, which is part of the replica synchronization process, to begin execution on the source server.
  • L - Schedules the limber process to begin execution on the source server in five seconds.
  • M<bytes> - Changes the maximum file size used by the source server's ndstrace.log file. The command can be used regardless of the state of the debug file. The <bytes> specified must be a value between 10000 bytes and 100 MB. If the value specified is higher or lower than the specified range, no change occurs.
  • P - Displays the current values of the eDirectory tunable parameters.
  • R - Resets the ndstrace.log file to zero bytes.
  • S - Schedules the eDirectory replica synchronization process to begin execution on the source server in three seconds. Only replicas already scheduled to be synchronized will be synchronized.
  • SS - Schedules the schema synchronization process to begin immediately on the source server. Only those target servers that have not been successfully synchronized in the last 24 hours will be synchronized.
  • SSA - Schedules the schema synchronization process to begin immediately and forces schema synchronization with all target servers, even if they have been synchronized in the last 24 hours.
  • SSD - Resets the source server's Target Schema Sync list. This list identifies which servers the source server should synchronize with during the schema synchronization process. A server that does not hold any replicas sends a request to be included in the target list of a server that contains a replica with its server object.
  • SSL - Prints the schema synchronization list of target servers.
  • ST - Displays the status information for the background processes on the source server.
  • STX - Displays the status information for the back link process (external references) on the source server.
  • STS - Displays the status information for schema synchronization process on the source server.
  • STO - Displays the status information for the back link process (obituaries) on the source server.
  • STL - Displays the status information for the limber process on the source server.
  • U <entryID> - If the command does not include an entry ID, changes the status of any server that has been previously labeled Down to Up. If the command includes a local entry ID, changes the status of the specified server from Down to Up. Entry IDs are specific to the source server's database and must refer to an object that represents a server.
  • Z - Displays the currently scheduled tasks.

eDirectory Performance Tuning BACKGROUND PROCESSES#

Syntax#

set ndstrace = !<flag><value>

Tuning Flags #

  • B <int> - Sets the interval, in minutes, for the back link process. The default interval is 1500 minutes (25 hours). The range is 2 to 10080 minutes (168 hours).
  • D <int> - Sets the inbound and outbound synchronization interval to the specified number of minutes. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • DI <int> - Sets the inbound synchronization interval to the specified number of minutes. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • DO <int> - Sets the outbound synchronization interval to the specified number of minutes. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • E - Schedules the inbound and outbound synchronization processes to begin execution.
  • EI - Schedules the inbound synchronization process to begin execution.
  • EO - Schedules the outbound synchronization process to begin execution.
  • F<int> - Sets the interval, in minutes, for the Flat cleaner process. The default interval is 240 minutes (4 hours). The range is 2 to 10080 minutes (168 hours).
  • H<int> - Sets the interval, in minutes, for the heartbeat synchronization process. The default interval is 30 minutes. The range is 2 to 1440 minutes (24 hours).
  • I<int> - Sets the interval, in minutes, for the heartbeat synchronization process. The default interval is 30 minutes. The range is 2 to 1440 minutes (24 hours).
  • J<int> - Sets the interval, in minutes, for the janitor process. The default interval is 2 minutes. The range is 1 to 10080 minutes (168 hours).
  • M - Reports the maximum memory used by eDirectory.
  • N [0] - Sets the name form: zero (0) specifies HEX only, and one (1) specifies full dot form.
  • SI<int> - Sets the interval, in minutes, for the inbound schema synchronization process. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • SO<int> - Sets the interval, in minutes, for the outbound schema synchronization process. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • SI0<int> - Disables the inbound schema synchronization process for the specified number of minutes. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • SO0<int> - Disables the outbound schema synchronization process for the specified number of minutes. The default interval is 24 minutes. The range is 2 to 10080 minutes (168 hours).
  • T<int> - Sets the interval, in minutes, for checking the server's UP state. The default interval is 30 minutes. The range is 1 to 720 minutes (12 hours).
  • V<ver>[,<ver>] - Lists the restricted eDirectory versions. If no versions are listed, there are no restrictions. Each version is separated by a comma.

More Information#

There might be more information for this subject on one of the following:

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-36) was last changed on 29-Dec-2016 16:34 by jim