How to use DSTrace
(Last modified: 11Apr2002)
This document (10017284) is provided subject to the disclaimer at the end of this document.
goal
How to use DSTrace
fact
Novell NetWare 4.1
Novell NetWare 4.11
Novell NetWare 5.0
Novell ZENworks for Desktops 2
Novell BorderManager Enterprise Edition 3.0
Formerly TID 2908733
DSTrace is a debugging screen on the console that is designed to identify a problem with synchronization of servers within partitions. Default Synchronization occurs every 30 minutes, but instead of waiting you can force synchronization to occur instantly in order to track down any 600 level errors.
fix
Below are the options to force a sync from a console prompt using server MLA_DS1 as an example. (Not case sensitive)
MLA_DS1: SET DSTRACE=ON Turns the debugging screen on
DSTrace is set to: ON
MLA_DS1: SET DSTRACE=+S Displays objects that are synchronizing
DSTrace is set to: +S
MLA_DS1: SET DSTRACE=*H Force high convergence heart beat synchronization.
DSTrace is set to: *H
NOTE: The plus (+) sign with any switch signifies a display or view perspective. The asterisk (*) sign signifies an action to be performed.
Typing the above information and switching screens (ALT-ESC if you are at the server, ALT-F3 if you are using Rconsole) will give you the following DSTrace screen.
1 (96/03/05 16:12:38)
2 SYNC: Start sync of partition <Root> state:[0] type:[0]
3 SYNC: Start outbound sync with (#=3, state=0, type=3) [01000ad2]<MLA_DS3.Root>
4 (16:12:38) SYNC: failed to communicate with server <CN=MLA_DS3> ERROR: -625
5 SYNC: Start outbound sync with (#=2, state=0, type=1) [01000ad3]<MLA_DS2.Root>
6 SENDING TO ------> CN=MLA_DS2
7 SYNC: sending updates to server <CN=MLA_DS2>
8 SYNC: [01000ad2][(14:42:09,1,1] MLA_DS3.Root (NCP Server)
9 SYNC: Objects: 1, total changes: 3, sent to server <CN=MLA_DS2>
10 SYNC: update to server <CN=MLA_DS2> successfully completed
11 SYNC: Skulkpartition for <Root> Succeeded
12 SYNC End sync of partition <Root> All processed = NO
Line 1 tells the time and date of when the master last synched.
Line 2 tells what partition is about to sync. If you have more than one partition on this server this line will let you know when sync is switching to a new partition. State:[0] means that the server is ON. The replica Type (0=master, 1=Read/Write, 2=Read Only, 3=Subordinate Reference).
Line 3 shows the first outbound synch for the partition to server MLA_DS3.
Line 4 shows any sync errors, in this case there is a "failed to communicate" "Error: -625"
Line 5 shows the second outbound synch for the partition to server MLA_DS2
Line 6&7 transferring information to server MLA_DS2
Line 8 Synchronization of the server object
Line 9 Summary of information sent to server MLA_DS2
Line 10 MLA_DS2 has been successfully completed. - No errors for this server.
Line 11 Synchronization of Root partition has finished.
Line 12 The partition was not updated because of the 625 error on MLA_DS3, All processed=No.
The ultimate goal is to clean up all 600 level errors so that you get an ?All processed = YES' is displayed for all partitions on the server we are currently Rconsoled into.
Logging DSTrace information to a file.
If the DSTrace screen scrolls too fast or you need to send it in to Technical Support, you can send the trace to a file.
SET DSTRACE=ON Turns the debugging screen on.
SET TTF=ON Sets the trace to be recorded to file format. (dstrace.dbg)
SET DSTRACE=*R Resets the TTF trace file to zero bytes. Removes old information
SET DSTRACE=+S Displays objects that are synchronizing
SET DSTRACE=*H Force high convergence heart beat synchronization.
NOTE: The plus (+) sign with any switch signifies a display or view perspective. The asterisk (*) sign signifies an action to be performed.
Switch screen and wait for the ?All processed=No' then type:
SET TTF=OFF - If you don't you will fill up your sys volume in a few days with the dstrace.dbg file. This will send the DSTrace screen output to a file in the SYS:SYSTEM named DSTRACE.DBG. This file can be viewed through a text editor and, if necessary, sent to Technical Support.
document
| Document Title: | How to use DSTrace |
| Document ID: | 10017284 |
| Solution ID: | 1.0.23968910.2333479 |
| Creation Date: | 23Sep1999 |
| Modified Date: | 11Apr2002 |
| Novell Product Class: | Management Products NetWare Novell eDirectory |
disclaimer
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.