Overview#

Be careful and KNOW what you are doing!

If in doubt#

ndsrepair -R

Unattended repair (-U)#

DO NOT do Ever: Unattended repair (-U). There is no situation where an "unattended full repair" is a good idea.

Patience#

Wait. Repairs may take a while to propagate to all servers.
These are for more advanced users. Be VERY CAREFUL.

ndsrepair -J#

Repairs a single object on the local server. You will need to provide the Entry ID (in hexadecimal format) of the object you want to repair.
ndsrepair -J (hexEntryID)
or if EDirectory Multiple Instance
ndsrepair -J (hexEntryID) ----config-file /etc/opt/novell/eDirectory/conf/nds.conf

Linux Command-Line#

Command-Line values are case-sensitive
OptionDescription
-RRepairs the local eDirectory database. Use this repair operation to resolve inconsistencies in the local database so that it can be opened and accessed by eDirectory. This option has suboptions that facilitate repair operations on the database. It has function modifiers that are explained in Function Modifiers Used with the -R Option. This option, with no suboptions, is the suggested means of repair unless you are told by NetIQ Support to perform certain operations manually.
-PReplica and Partition Operations option. Lists the partitions that have replicas stored in the current server’s eDirectory database files. The Replica options menu provides options to repair replicas, cancel a partition operation, schedule synchronization, and designate the local replica as the master replica.
-SGlobal Schema Operations option. This option contains several schema operations that might be necessary to bring the server's schema into compliance with the master of the Tree object. However, these operations should be used only when necessary. The local and unattended repair operations already verify the schema.
-CCheck External Reference Object option. Checks each external reference object to determine if a replica containing the object can be located. If all servers that contain a replica of the partition with the object are inaccessible, the object will not be found. If the object cannot be found, a warning is posted.
-EReport Replica Synchronization option. Reports replica synchronization status for every partition that has a replica on the current server. This operation reads the synchronization status attribute from the replica's Tree object on each server that holds replicas of the partitions. It displays the time of the last successful synchronization to all servers and any errors that have occurred since the last synchronization. A warning message is displayed if synchronization has not completed within 12 hours.
-NServers Known to This Database option. Lists all servers known to the local eDirectory database. If your current server contains a replica of the Tree partition, this server displays a list of all servers in the eDirectory tree. Select one server to cause the server options to be executed.
-JRepairs a single object on the local server. You will need to provide the Entry ID (in hexadecimal format) of the object you want to repair. You can use this option instead of using the Unattended Repair (-U) option to repair one particular object that is corrupted. The Unattended Repair option can take many hours depending on the size of database. This option will help you save time.
-TTime Synchronization option. Contacts every server known to the local eDirectory database and requests information about each server’s time synchronization status. If this server contains a replica of the Tree partition, then every server in the eDirectory tree will be polled. The version of eDirectory that is running on each server is also reported.
-AAppend to the existing log file. The information is added to the existing log file. By default, this option is enabled.
-OLogs the output in a file. By default, this option is enabled.
-F filenameLogs the output in the specified file.
-UUnattended Full Repair option. Instructs DSRepair to run and exit without further user intervention. This option locks the database and updates server referrals. You can view the log file after the repair has completed to determine what changes DSRepair has made.

Function Modifiers used with the -R option#

Function Modifiers Used with the -R Option
OptionDescription
-lLocks the eDirectory database during the repair operation.
-uUses a temporary eDirectory database during the repair operation.
-mMaintains the original unrepaired database.
-iChecks the eDirectory database structure and the index.
-fReclaims the free space in the database.
-dRebuilds the entire database.
-tPerforms a tree structure check. Set it to Yes to check all the tree structure links for correct connectivity in the database. Set it to No to skip the check. Default =Yes.
-oRebuilds the operational schema.
-rRepairs all the local replicas.
-vValidates the Stream Files.
-cChecks local references.

Timestamping Obituaries at CLI #

You can check on the NDS Obituaries status using ndsrepair:
 
ndsrepair -C --config-file /etc/opt/novell/eDirectory/conf/nds.conf -Ad -A 

[1] Instance at /etc/opt/novell/eDirectory/conf/nds.conf: francis.dc=svr.dc=willeke.dc=com.WILLEKETREE 
Repair utility for Novell eDirectory 8.8 - 8.8 SP1 v20112.44 
DS Version 20114.24 Tree name: WILLEKETREE 
Server name: .francis.svr.willeke.com 

Size of /var/opt/novell/eDirectory/log/ndsrepair.log = 3779 bytes. 

Preparing Log File "/var/opt/novell/eDirectory/log/ndsrepair.log" 
Please Wait... 
External Reference Check 
External Reference Check 
Start: Friday, March 09, 2007 09:44:08 Local Time 

Checked 0 external references 
Found: 0 total obituaries in this DIB, 
0 Unprocessed obits, 0 Purgeable obits, 
0 OK_To_Purge obits, 0 Notified obits 
Total errors: 0 
NDSRepair process completed. 
the --config-file option allows using with Multiple Instances. The command line is placement sensitive.

Checking Synchronization And Versions #

 
# ndsrepair -E 

[1] Instance at /etc/opt/novell/eDirectory/conf/nds.conf: francis.dc=svr.dc=willeke.dc=com.WILLEKETREE 
Repair utility for Novell eDirectory 8.8 - 8.8 SP1 v20112.44 
DS Version 20114.24 Tree name: WILLEKETREE 
Server name: .francis.svr.willeke.com 

Size of /var/opt/novell/eDirectory/log/ndsrepair.log = 3282 bytes. 

Preparing Log File "/var/opt/novell/eDirectory/log/ndsrepair.log" 
Please Wait... 
Collecting replica synchronization status 
Start: Friday, March 09, 2007 09:40:03 Local Time 
Retrieve replica status 

Partition: .[Root]. 
Replica on server: .francis.svr.willeke.com 
Replica: .francis.svr.willeke.com 03-09-2007 09:21:05 
Replica on server: .SH.svr.willeke.com 
Replica: .SH.svr.willeke.com 03-09-2007 09:21:08 
All servers synchronized up to time: 03-09-2007 09:21:05 
Finish: Friday, March 09, 2007 09:40:03 Local Time 

Total errors: 0 
NDSRepair process completed. 

Checking Time And All Server Versions #

 
francis:~ # ndsrepair -T 
[1] Instance at /etc/opt/novell/eDirectory/conf/nds.conf: francis.dc=svr.dc=willeke.dc=com.WILLEKETREE 
Repair utility for Novell eDirectory 8.8 - 8.8 SP1 v20112.44 
DS Version 20114.24 Tree name: WILLEKETREE 
Server name: .francis.svr.willeke.com 

Size of /var/opt/novell/eDirectory/log/ndsrepair.log = 2483 bytes. 

Building server list 
Please Wait... 
Preparing Log File "/var/opt/novell/eDirectory/log/ndsrepair.log" 
Please Wait... 
Collecting time synchronization and server status 
Time synchronization and server status information 
Start: Friday, March 09, 2007 09:39:08 Local Time 

---------------------------+---------+---------+-----------+--------+------- 
DS Replica Time Time is Time 
Server name Version Depth Source in sync +/- 
---------------------------+---------+---------+-----------+--------+------- 
Processing server: .SH.svr.willeke.com 
.SH.svr.willeke.com 20114.29 0 NTP Yes 0 
Processing server: .francis.svr.willeke.com 
.francis.svr.willeke.com 20114.24 0 Non-NetWare Yes 0 
---------------------------+---------+---------+-----------+--------+------- 
Total errors: 0 
NDSRepair process completed. 

Single Object Repair #

 
ndsrepair -J [entry_id] 

Removing Failed Server #

Removing Failed Server is how to remove a failed server from the tree with ndsrepair.

Advanced Switches #

Some more advanced and scarcely documented switches.
Be sure you know what you are doing. We are NEVER responsible!
  • -R -Ad -Xk3 - Kills all external references in this server's eDirectory database. This operation is used to destroy all external references in a nonfunctioning replica. If the references are the source of the problem, eDirectory can then re-create the references in order to get the replica functioning again.
  • -R -Ad -Xk2 - Kills all eDirectory objects in this server's eDirectory database. This operation is used to destroy a corrupt replica that cannot be removed in any other way.
  • -S -Ad - List of all global schema operations along with the advanced options

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-34) was last changed on 29-Dec-2016 13:47 by jim