Bug 1316211 - Section 8.1.1 of RHDS 10 documentation appears to point to the incorrect schema directory
Summary: Section 8.1.1 of RHDS 10 documentation appears to point to the incorrect sche...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Directory Server
Classification: Red Hat
Component: Doc-administration-guide
Version: 10.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: ---
Assignee: Petr Bokoc
QA Contact: Viktor Ashirov
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-03-09 17:06 UTC by Andrew N
Modified: 2016-11-14 13:46 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-11-14 13:46:01 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description Andrew N 2016-03-09 17:06:29 UTC 
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Directory_Server/10/html/Administration_Guide/Extending_the_Directory_Schema.html#default-schema

Section Number and Name: 
8.1.1  Default Schema Files

Describe the issue: 

The paragraph in section 8.1.1 says that the schema files can be placed in /usr/lib64/dirsrv/slapd-instance/schema, however on a fresh RHDS 10 install here at a customer site this directory does not exist.  However /etc/dirsrv/slapd-instance/schema does and does contain LDAP schema files.

Suggestions for improvement: 
Point to /etc/dirsrv/slapd-instance/schema as opposed to /usr/lib64/dirsrv/slapd-instance/schema

Additional information:
Comment 5 Petr Bokoc 2016-03-11 13:46:04 UTC 
Alright, I fixed all instances in chapter 8 where the book was referring to /usr/lib64/dirsrv/slapd-instance/schema as the default instance schema directory.

Preview at: http://10.34.3.139:8080/view/Directory%20Server/job/doc-Red_Hat_Directory_Server-Administration_Guide%20%28html-single%29/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#default-schema

However, "/etc/dirsrv/slapd-instance" (one level above) appears a whole bunch of times in the book in other places and in slightly different context. For example, the book refers to it as a directory where some scripts are installed, e.g. "8.7.1. Reloading Schema Using schema-reload.pl" or "⁠9.3.1. Running the db2index.pl Script".

I'm not sure if that should be changed as well - I don't know if the whole default RHDS install path changed or if it's only specifically the default schema directory. I'll get a test instance running later and check everything. Moving to MODIFIED for now.
Comment 6 Petr Bokoc 2016-04-07 14:05:08 UTC 
Right, I get it now. /usr/lib64/dirsrv/slapd-instance contains scripts, and schema configs are indeed in /etc/dirsrv/slapd-instance/schema. I'll need to go through all instances of "/usr/lib64/dirsrv" in all DS10 books and check what each one refers to.
Comment 7 Petr Bokoc 2016-05-17 11:42:45 UTC 
Every occurence of these two directories in all RHDS10 books should be fine now.
Comment 9 Marc Muehlfeld 2016-11-14 13:46:01 UTC 
The updated documentation for Directory Server 10.1 is now available on the Customer Portal.
Note You need to log in before you can comment on or make changes to this bug.