DSREPAIR -XK3 - How to use it and why you would use it

  • 7015477
  • 05-Aug-2014
  • 05-Aug-2014

Environment

Novell eDirectory 8.8 for NetWare 6.5
Novell Directory Services

Situation

Local DS on a server does not hold a real copy of an object and is getting errors trying to access said object.
Server holds no replicas
ERROR -626 checking XREF ID
Error:  -634 checking XREF on an object for which the server doesn't hold a real (Master, Read/Write, Read-Only) copy
Master replica is staying substantially behind in synchronization time.
After removing a replica, users cannot log into the server.
Authentication times dramatically increased (a replica of the users' Partition is not on the server)
Error -601 reported on an object.  The server reporting the error does not hold a real (Master, Read/Write, Read Only) of the object.
Renamed (0_0) server object showing on servers that do not hold real copies of the server object.
Previously deleted objects are showing up in the tree.
DSREPAIR -XK3 -  How to use it and why you would use it
Removing External Reference Links and Recreating them.

Resolution

On the NetWare Platform:

1.  Load DSREPAIR -XK3 | Advanced options | Repair local DS database | Check local references = Yes | F10 to start the repair.  This goes through all of the server's backlink attribute timestamps and sets them to zero.
2.  Save the repaired database and exit from DSREPAIR completely.  
3.  Run the backlink process to rebuild the backlinks. At the server console prompt type:

SET DSTRACE=ON
SET DSTRACE=NODEBUG
SET DSTRACE=+BLINK   (+ sign turns DSTRACE on as well)
SET DSTRACE=*B  

This last process will update the timestamps on those objects that are still valid. Those that are not updated are purged the next time the janitor and flat cleaner processes run.

On the Windows NT\2000 Platform:

1.  Start the NDS Services applet from the Control Panel
2.  Highlight DSREPAIR.DLM
3.  Enter -XK3 (must be in CAPS) in the Startup Parameters field and Click START.
4.  Click Repair in the menu and then Local Database Repair
5.  Make sure "Check Local References" is checked and then start the repair.

To start the backlink process, do the following:

1.  Start the NDS Services applet from the Control Panel
2.  Highlight DSTRACE.DLM and then Click START
3.  Click Edit in the menu and then Options
4.  Uncheck everything except the Backlinker and Backlinker Detail filters.
5.  Click OK
6.  Go back to the NDS Services applet and highlight DS.DLM and then Click Configure.
7.  Go to the Triggers tab and Click Backlinker.


On the UNIX Platform:

1.  At a command prompt, type ndsrepair -R -Ad -XK3  (ndsrepair and it's switches are case sensitive)
2.  Type ndstrace and Enter
3.  Type set ndstrace = *b

Additional Information

The problem is the backlinks to the externally referenced objects have gone bad.
Formerly known as TID# 10023339