From 4d64f2f7de82f25bf1f0d1998bf42a29ace72a4d Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Wed, 17 Apr 2013 05:57:14 +0000
Subject: [PATCH] Fix for OPENDJ-868: cannot add attributes to referential integrity plugin

---
 opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-groups.xml |   16 +++++++++++++++-
 1 files changed, 15 insertions(+), 1 deletions(-)

diff --git a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-groups.xml b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-groups.xml
index 4a1e814..6290434 100644
--- a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-groups.xml
+++ b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-groups.xml
@@ -20,7 +20,7 @@
   !
   ! CCPL HEADER END
   !
-  !      Copyright 2011-2012 ForgeRock AS
+  !      Copyright 2011-2013 ForgeRock AS
   !    
 -->
 <chapter xml:id='chap-groups'
@@ -401,6 +401,20 @@
 member: uid=bjensen,ou=People,dc=example,dc=com
 member: uid=tmorris,ou=People,dc=example,dc=com</screen>
 
+ <para>By default the referential integrity plugin is configured to manage
+ <literal>member</literal> and <literal>uniqueMember</literal> attributes.
+ These attributes take values that are DNs, and are indexed for equality by
+ default. Before you add an additional attribute to manage, make sure that
+ it has DN syntax and that it is indexed for equality. OpenDJ requires that
+ the attribute be indexed because an unindexed search for integrity would
+ potentially consume too many of the server's resources. Attribute syntax is
+ explained in the chapter on <link xlink:href="admin-guide#chap-schema"
+ xlink:show="new" xlink:role="http://docbook.org/xlink/role/olink"><citetitle
+ >Managing Schema</citetitle></link>. For instructions on indexing attributes,
+ see the section on <link xlink:href="admin-guide#configure-indexes"
+ xlink:show="new" xlink:role="http://docbook.org/xlink/role/olink"><citetitle
+  >Configuring &amp; Rebuilding Indexes</citetitle></link>.</para>
+
  <para>You can also configure the referential integrity plugin to check that
  new entries added to groups actually exist in the directory by setting the
  <literal>check-references</literal> property to <literal>true</literal>. You

--
Gitblit v1.10.0