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

(Last modified: 24Jan2003)

This document (10023339) is provided subject to the disclaimer at the end of this document.

goal

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

Removing External Reference Links and Recreating them.

fact

Novell NetWare (all versions)

Novell Directory Services

symptom

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.

cause

The problem is the backlinks to the externally referenced objects have gone bad.

fix

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

document

Document Title: DSREPAIR -XK3 -  How to use it and why you would use it
Document ID: 10023339
Solution ID: 1.0.43980632.2446115
Creation Date: 14Dec1999
Modified Date: 24Jan2003
Novell Product Class:End of Life
Management Products
NetWare
Novell BorderManager Services
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.