SET DSTRACE

V případě problémů s eDirectory se jako nástroj pro diagnostiku používal příkaz SET DSTRACE. Ten vhodným nastavením umožnil pohled na stav databáze a aktivity, které se okolo ní točily.

SET DSTRACE=[options]

Screen switch:
 

 option  Descrition
 ON  Enable DSTRACE Screen
 OFF  Disable DSTRACE Screen
 NODEBUG  Only enables the screen, turns off all debugging messages.  Screen will display just the title of    the screen: A NetWare 4.1 Directory Services (PTF 951012) 4.89, 11/01/1995".  This is useful  when you want to start over with the filter commands.  The filter commands are accumulative and only are reset when DS.NLM is unloaded and reloaded.  This will reset the DSTRACE screen to nothing and used in conjunction with +min will set the dstrace back to the defaults.
 DEBUG  Turns on a predefined set of debugging messages by enabling the following filters:  ON, INIT, FRAGGER, MISC, STREAMS, LIMBER, JANITOR, BACKLINK, SKULKER, SCHEMA, INSPECTOR, ERRORS, PART, EMU, VCLIENT, RECMAN and REPAIR
 AGENT  Turns on a predefined set of debugging messages by the enabling the following filters:  ON, JANITOR, BACKLINK, RESNAME, DSAGENT, and  VCLIENT
 ALL  Enables all debug trace message filters.  This will allow through even "normal errors" such as DSA common request errors and collisions.  Buffers are NOT turned on with this command
 CHECKSUM  4.94 and above:  Enables Transport Dependent Checksum (TDC).  When packets are broke up to 64 K bytes packets.  The process of making sure that packet does not get corrupt in the exchange or rebuild process is done through ipx data packet checksumming.  Packet checksumming is used by such frame types as 802.2 and actually will check the integrity of the data packets
 NOCHECKSUM  Disables transport level checksum.  The only way to completely remove checksumming is to set nochecksum and down the server.    This will clear  all connections that maybe still involved in checksum.

SET TTF=[options] (Trace To File)
 

 option  Descrition
 ON  Enable Trace To File
 OFF  Disable Trace To File

SET DSTRACE=[+/-Filters options]

Filter switch:
 

 option  Descrition
+ Enable filter
 - Disable filter
 AUTHEN  Enables debug error messages of authentication events
 BACKLINK  Enables debug error messages pertaining to the process of connecting 
 BLINK   External references to real objects (back linking). 
 BUFFERS  Enables debug error messages in the request and reply buffers used by the Directory Service Agent. 
 COLL  "Normal" errors.  Enables debug error messages when two changes have COLLISION been made on the same object
 DSAGENT
 DSWIRE
 "Normal" errors. Enables debug error messages of the low level DS agent 
DSA - tracking.  This will show the DSA COMMON request errors.
 EMU  Enables debug error messages in the bindery partition.
 E
 ERRORS
 Enables ALL debug error messages.  Any errors normal or a problem on any ERR process will display. Display all errors in the DS. 
 FRAG
 FRAGGER
 Enables debug error messages of the fragger level.
 G  Gives up Sync To current server and change server status to down. When too many requests are in process and the server ID is unable to be specified.  The server will give up and flag the server as down and to stop trying to communicate
 H  Forces the "Heartbeat", the skulker, to synchronize.  This initiates immediate communication between servers allowing an exchange of time stamps with any server in the replica ring
 IN  Enables debug error messages of inbound synchronization traffic.  What is being received by this server
 INIT  Enables debug error messages of the initialization of Directory Services
 INSPECTOR  Enables debug error messages of the inspector process
 JANITOR
 J
 Enables debug error messages of the clean up or janitor process
 LDAP  Enables debug LDAP messages
 LIMBER  Enables debug error messages of the server connectivity check which is the limber process
 L   Limber process.  Forces server connectivity check.  The limber process checks the server's object to make sure that it is in the right tree: correct tree name, server name and address
 M   Set a maximum file size for the DSTRACE.DBG   Used in conjunction with the set ttf command.
 MERGE  Enables debug error messages of objects merging together
 MIN  Enables debug error messages at the minimum debugging level
 MISC  Enables debug error messages of all miscellaneous processes
 OUT  Enables debug error messages of outbound synchronization traffic.  What is being sent out from this server.
 P   Lists the current settings for the different processes
 PART  Enables debug error messages of partition operations.
 SCHEMA  Enables debug error messages of schema modifications and schema synchronization.
 SAP  Enables debug error messages of the Service Advertising Protocol
 SKULKER  Enables debug error messages of the synchronization traffic.  Displays object SYNC updates involved in the synchronization process
 STREAMS  Enables debug error messages about streams
 TIMEVECTOR  Enables debug error messages relating to local and remote Sync Up To TV vectors. 
 VCLIENT  Enables debug error messages dealing with server to server connections and VC outgoing client messages
 RECMAN  Enables debug error messages of access to record or database manager. Low level DS database processes
 REPAIR  Enables debug error messages of the repair process
 RESNAMERN  Enables debug error messages of resolve name requests

SET DSTRACE=[*options]

Action switch
 

 option  Descrition
 B  Forces the Backlink process.  When NDS creates an external reference for an entry not stored on the local server, NDS attempts to create a pointer or back link to the real entry.  This process occurs every 780 minutes.  This options forces the back link to occur now. 
 C  (4.97 and above) Connection table statistics for outbound connection caching or virtual clients
 CI  (4.97 and above)  Connection table statistics for virtual clients.  Displays idle time information
 CR  (4.97 and above) Connection table statistics for virtual clients.  Displays information about routing table packets. 
 CT  (4.97 and above) Connection table statistics for virtual clients.  Displays who this server is connected to. 
 CO  (Zero) (4.97 and above) Connection table statistics for virtual client.  Resets statistics (same as loading DS.NLM).
 D  Aborts the send all object operation associated with a *I.  This is only used after a Send All Object is unable to complete.  It acts as an endless loop trying to send the entries to all replicas.  One server is probably unaccessible.  The process will never complete, therefore is aborted
 E  Checks entry cache.  Locks the DIB, verifies that the entry cache is viable, then re-opens the DIB again
 F  Flatcleaner and Janitor process.  This process purges and removes deleted, unnecessary or expired items and entries.  Also purges dynamic bindery objects and "not present" external references.
 R  Resets the DSTRACE.DBG file to zero bytes.  Associated with the set ttf command
 S  Schedules the skulker.  Similar to the *h process.  This process checks to see if any of the replicas on the server need to be synchronized.  If so it schedules the synchronization process to run sooner than usual
 SS  Starts an immediate synchronization of all schema not just the skulker.  Anytime the Directory schema is modified by changing or creating new attribute definitions and/or new object class definitions, these changes will be replicated among all the servers in the tree
 U  Resets the servers communication status list.  Forces the server status to UP

SET DSTRACE=[options]

Tunning switch - saved tunning parameters also to text file SYS:\_NETWARE\_NDSDB.INI
To increase the amount of memory available to the NDS, the number of bytes are 1000000 (1 million) = 1MB.  For example: SET DSTRACE = !MB20000000 (M=Memory B=Bytes). The current recommendation is for the cache to be 110% of the DS DIB size (default is 8 MB).
 

 option  Descrition
 %  Percent
 AVAIL  Percentage of available or total physical memory for hard memory limit only.
 !MDYN
 DYN
 Sets a dynamically adjusting limit
 !MB
 !MHARD
 HARD
 Sets a hard memory limit. Percentage of available or physical memory to use
 LEAVE:number_of_bytes  Minimum number of bytes to leave
 MIN:number_of_bytes  Minimum number of bytes
 MIN:number_of_bytes  Maximum number of bytes
 NOSAVE  No save parameters
 TOTAL  Percentage of available or total physical memory for hard memory limit only.

Example of tunning:
 

 option  Descrition
 SET DSTRACE=!MBamount_of_RAM_to_use_in_bytes

 SET DSTRACE=!MB8388608

 To set a fixed hard limit

 Set a hard limit of 8 MB

 SET DSTRACE=!MHARD,AVAIL OR TOTAL,%:percent,MIN:number_of_bytes,MAX:number_of_
bytes,LEAVE:number_of_bytes_to_leave,NOSAVE

SET DSTRACE=!MHARD,%:75,MIN:16777216,NOSAVE

 To set a calculated hard limit. Only type the options you want to specify.
 

 Set a hard limit of 75% of total physical memory and minimum of 16 MB, and to specify not to save these options to the startup file

 SET DSTRACE=!MDYN,%:percent,MIN:number_of_bytes,MAX: number_of_bytes,LEAVE:number_of_bytes_to_leave, NOSAVE

 SET DSTRACE=!MDYN,%:75,MIN:8388608 

 To set a dynamically adjusting limit.Only type the options you want to specify.

 Set a dynamic limit of 75% of available memory and a minimum of 8 GB

Default interval and server parameterts

ServerStateUpThreshold = 30 minutes (Set Dstrace=!Tn n=minutes)
External Reference Life Span = 192 hours (Set NDS External Reference life span = n n=hours)
JanitorInterval = 2 minutes (Set Dstrace=!Jn n=minutes)
FlatCleaningInterval = 60 minutes (Set Dstrace=!Fn n=minutes)
BacklinkInterval = 780 minutes (Set Dstrace=!Bn n=minutes)
Heartbeat Data = 30 minutes (Set Dstrace=!Hn n=minutes)
Heartbeat Schema = 240 minutes (Set Dstrace=!In n=minutes)
Requests In Progress threshold = 1000 (Set Dstrace=!Gn n=requests)
Request IPX checksums = DISABLED (Set Dstrace=(no)checksum)
IPX:RIPDelay = 20 ticks (Set Dstrace=!Wn n=time in ticks)
IPX:Retries = 3 (Set Dstrace=!Xn n=retries)
IPX:TimeOutScaleFactor = 2 (Set Dstrace=!Yn n=number)
IPX:TimeOutShiftFactor = 4 (Set Dstrace=!Zn n=number)
Disk accesses before yield = 10 (Set Dstrace=!Rn n=minutes)
Connection Expiration Timeout = 135 minutes (Set Dstrace=!CEn n=minutes)
NDS Packet CRC checking = ENABLED (cannot disable)
Maximum Sockets Threshold = 75% (Set Dstrace=)
Outbound Synchronization = ENABLED
(to disable Set Dstrace=!D0 disable for 1 day Set Dstrace=!Dn n=minutes)
(to enable Set Dstrace=!EO)
Inbound Synchronization = ENABLED
(to disable Set Dstrace=!D0 disable for 1 day Set Dstrace=!Dn n=minutes)
(to enable Set Dstrace=!EI)
Schema Outbound Synchronization = ENABLED
(to disable Set Dstrace=!S0 disable for 1 day)
(to enable Set Dstrace=!SO)
Schema Inbound Synchronization = ENABLED
(to disable Set Dstrace=!S0 disable for 1 day)
(to enable Set Dstrace=!SI)
Schema synchronization enabled = 1 (Set Dstrace=)
 
 
 

Powered by Drupal - Design by artinet