What are Obituaries#

Since eDirectory is a distributed database, each server receives updated information through synchronization. Since all the servers in the replica ring do not receive updates simultaneously, the server may not hold the same information at a given time. As a result, each server holds on to the old information until all the other servers receive the updates. eDirectory uses obituaries to keep track of this type of information and more.

Obituaries are created when an eDirectory object is:#

  • DELETED
  • MOVED
  • RENAMED
  • RESTORED
The obituary itself is an attribute of the object on which the change took place. The reason for an obituary attribute is created is to maintain database consistency between real copies of the object and external references of the changed object.

Obituary Types The eDirectory engine utilizes 14 different obituary types. The following table lists each type and what they do.

NameReference
Number
Description
Restored0This obituary type (0) designates an object that has been restored from a backup system.
Dead1This obituary type is assigned the reference number 1 to designate that this object is being deleted.
Move2This obituary type designates an object that is being moved to another name context. Obituary number 2 is assigned to a DS_ENTRY_NOT_PRESENT version of the object that exists in the original name context.
INHIBIT_MOVE Obituary3This obituary type designates an object that has been moved from another name context. Obituary number 3 is assigned to the relocated object in its new name context.
Old RDN4This obituary type designates an object whose Relative Distinguished Name has been changed. Obituary number 4 is assigned to the renamed object that has the new RDN.
New RDN5This obituary type designates an object whose Relative Distinguished Name has been changed. Obituary number 5 is assigned to the DS_ENTRY_NOT_PRESENT object that has the original RDN.
BackLink6This obituary type identifies an eDirectory Server which holds either an external reference or a replica of the object. Obituary number 6 is assigned to the object that has been assigned as the primary obituary.
Tree Old RDN7This obituary type designates a partition root object whose Relative Distinguished Name has changed. Obituary number 7 is assigned to the renamed partition root object that has the new RDN.
Tree New RDN8This obituary type designates a partition root object whose Relative Distinguished Name has changed. Obituary number 8 is assigned to the DS_ENTRY_NOT_PRESENT object that has the original RDN.
Purge All9NDS uses this obituary type internally to identify an object whose attribute values should be purged.
Move Sub-tree10This obituary type designates a partition root object that is being moved to another name context. Obituary number 10 is assigned to the partition root object that is being moved.
Moved From11This obituary type is used so that if an object has been moved from a different user-created partition, its previous location is known to the NDS.
Used By12This obituary type notifies a user-created partition that points to an external reference.
Count13Novell uses this obituary type internally for test purposes only.

Obituary Classifications#

The classification of an obituary determines how it is processed. Currently, there are four classes of obituaries. These classifications are shown in the following table.
ClassificationDefinitions and Associated Obituaries
PrimaryPrimary Obituaries represent the basic action that is being performed on an object. These obituaries are assigned to an object by an authenticated Client that has the appropriate rights. They are processed by the Replica Purger background process. The obituary types classified as Primary Obituaries are:
- Restored
- Dead
- Moved
-New RDN
SecondarySecondary Obituaries represent the eDirectory servers that must be notified of the Primary Obituary action. eDirectory assigns these obituaries to an object and they cannot be assigned by an eDirectory Client. There is one Secondary Obituary for each eDirectory server that holds a replica of the partition that encompasses the object and there is one for each eDirectory server that holds an external reference of the obituary. These obituaries are removed by the Replica Purger background process. The obituary types classified as Secondary Obituaries are:
- Used By
- BackLink
InformationalInformational Obituaries identify an object whose identity has been changed due to the placement of a Primary Obituary. eDirectory assigns these obituaries to an object and they cannot be assigned by an eDirectory Client. They are removed by the Replica Purger background process. The obituary types classified as Informational Obituaries are:
- Inhibit Move
- Moved From
- Old RDN
- Tree Old RDN
Special CaseSpecial Case Obituaries represent partition, or internal, operations that are performed on an eDirectory object. These obituaries are assigned to an object by an authenticated eDirectory Client that has the appropriate rights, or by eDirectory. They are processed by the Replica Purger background process. The obituary types classified as special-case obituaries are:
- Tree New RDN
- Purge All
- Move Sub-Tree

Obituary States#

There are four different Flag States that are used to identify and process obituaries:

  • FLAGS 0000 (this is an Issued or Unprocessed state) - The server that processed the entry, notifies all servers in replica list.
  • FLAGS 0001 (this is the Notified state) - All servers have responded that they have been Notified.
  • FLAGS 0002 (this is the Ok TO Purge state) - All servers have said they flagged the entry as an obituary.
  • FLAGS 0004 (this is the Purgeable state) - Servers may now really remove the entry.

Checking Obituaries at CLI#

You can check on the NDS Obituaries status using Ndsrepair

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-15) was last changed on 25-Jun-2016 11:32 by jim