From 591d42ffa97dc2103e51567f05809cd4087a2484 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Thu, 13 Oct 2011 09:26:44 +0000
Subject: [PATCH] Explain sorting of schema file names

---
 opendj3/src/main/docbkx/admin-guide/chap-schema.xml |   18 +++++++++++++++---
 1 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/opendj3/src/main/docbkx/admin-guide/chap-schema.xml b/opendj3/src/main/docbkx/admin-guide/chap-schema.xml
index 9bc9eac..fd42280 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-schema.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-schema.xml
@@ -160,9 +160,21 @@
   </mediaobject>
   
   <para>When you finish, the schema changes show up by default in the file
-  <filename>config/schema/99-user.ldif</filename>. You can create this file
-  in the lab using the Control Panel, and then apply the definitions in
-  production by adapting the content for use with the
+  <filename>config/schema/99-user.ldif</filename>. Notice that the file name
+  starts with a number, 99. This number is larger than the numbers prefixing
+  other schema file names. In fact, OpenDJ reads the schema files in sorted
+  order, reading schema definitions as they occur. If OpenDJ reads a schema
+  definition for an object class before it has read the definitions of the
+  attribute types mentioned in the object class definition, then it displays
+  an error. Therefore, when naming your schema file, make sure the name appears
+  in the sorted list of file names <emphasis>after</emphasis> all the schema
+  files containing definitions that your schema definitions depends on. The
+  default file name for your schema, <filename>99-user.ldif</filename>, ensures
+  that your definitions load only after all of the schema files installed by
+  default.</para>
+
+  <para>You can create this file in the lab using the Control Panel, and then
+  apply the definitions in production by adapting the content for use with the
   <command>ldapmodify</command> command, for example.</para>
   
   <screen>$ cat config/schema/99-user.ldif 

--
Gitblit v1.10.0