eDirectory 8.6/8.7 UNIX NDSREPAIR Guide

  • 7001444
  • 27-Sep-2008
  • 27-Apr-2012

Environment

Novell eDirectory 8.7.3.4 for HP-UX
Novell eDirectory 8.7.3.5 for HP-UX
Novell eDirectory 8.7.3.6 for HP-UX
Novell eDirectory 8.7.3.7 for HP-UX
Novell eDirectory 8.7.3.8 for HP-UX
Novell eDirectory 8.7.3.9 for HP-UX
Novell eDirectory 8.7.3.10 for HP-UX

Situation

using NDSREPAIR on UNIX
NDSREPAIR switches
NDSREPAIR man page
eDirectory 8.6/8.7 UNIX NDSREPAIR Guide

Resolution

The ndsrepair utility can be used to repair and correct problems with the database, such as records, schema, bindery objects, and external references. The ndsrepair utility performs the following operations on the eDirectory database:

Additional Information

Structure checks the database automatically without closing the database and without user intervention
Checks the database index
Repairs the database without closing the database or locking out users
Reclaims free space by discarding empty records
Extends and modify the schema for containment
Collects time sync information
Gets replica information and has options to perform partition operations (such as changing replica type to Master)
Lists information of servers known to the database and provides options to perform operations on the server

Usage:

ndsrepair -Argument

-U Unattended Full Repair

Instructs ndsrepair to run and exit without further user assistance. This is the recommended means of repair unless you are told by Novell Technical Support to perform certain operations manually. You can view the log file after the repair has completed to determine what actions ndsrepair has taken.

-R Repair the Local Database
Repairs the local eDirectory database. Use the repair operation to resolve inconsistencies in the local database so that it can be opened and accessed by eDirectory. This option has sub options that facilitate repair operations on the database. 

The function modifiers used with the -R option are described below:

-l          Locks the eDirectory database during the repair operation
-u         Uses a temporary eDirectory database during the repair operation
-m        Maintains the original unrepaired database
-i          Perform database structure check
-f          Reclaims the free space in the database
-d         Rebuilds the entire database
-t          Performs a tree structure check
-i          Checks the eDirectory database structure and the index
-o         Rebuilds the operational schema
-r          Repairs all the local replicas
-v          Validates the stream files
-c         Checks local references

By default -i, -d, -t, -r, -v and -c options are set.


-E Report Replica Synchronization
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 [Root] 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 twelve hours.

-C Check External Reference Object
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 containing the object are inaccessible, the object will not be found. If the object cannot be found, a warning is posted.

-P Replica and Partition Operations
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.

-S Global Schema Operations
Contains several schema operations that might be necessary to bring the server's schema into compliance with the master of [Root]. However, these operations should be used only when necessary. The local and unattended repair operations already verify the schema's compliance.

-N Servers Known to This Database
Lists all servers known to the local eDirectory database. If your current server contains a replica of the [Root] partition, this server displays a list of all serves in the eDirectory tree. Select one server to run the server options.

-T Time Synchronization
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 [Root] partition, then every server in the eDirectory tree will be polled. The version of eDirectory that is running on each server is also reported.

-J Repair Single Object
Repairs a single object on the local server. You will need to provide the server specific entry ID (in hexadecimal format) of the object you want to repair. You can use ndsimonitor to get the entry ID of the object. 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 may take many hours, depending on the size of database. This option will help you save time.

-A Append to the Existing Log File
The information is added to the existing log file. By default this option is set.

-O
Logs the output in a file. By default this option is set.

-F
Logs the output in the file <filename>..
Formerly known as TID# 10079270