Red Hat 8.1 User Manual

Page of 374
Chapter 2. Core Server Configuration Reference
118
Parameter
Description
Default Value
Syntax
Case-insensitive string, multi-valued
Example
nsIndexAttribute: "cn:pres,eq"
nsIndexAttribute: "description:sub"
2.3.15.7. cn=schema reload task
The directory schema is loaded when the directory instance is started or restarted. Any changes to
the directory schema, including adding custom schema elements, are not loaded automatically and
available to the instance until the server is restarted or by initiating a schema reload task.
Custom schema changes can be reloaded dynamically, without having to restart the Directory Server
instance. This is done by initiating a schema reload task through creating a new task entry under the
cn=tasks
 entry.
The custom schema file can be located in any directory; if not specified with the 
 attribute,
the server reloads the schema from the default /etc/dirsrv/slapd-instance_name/schema
directory.
IMPORTANT
Any schema loaded from another directory must be copied into the schema directory
or the schema will be lost when the server.
The schema reload task is initiated though the command line by creating a special task entry which
defines the parameters of the task and initiates the task. As soon as the task is complete, the task
entry is removed from the directory. For example:
dn: cn=example schema reload,cn=schema reload task, cn=tasks, cn=config
objectclass: extensibleObject
cn:example schema reload
schemadir: /export/schema
The cn=schema reload task entry is a container entry for schema reload operations. The
cn=schema reload task
 entry itself has no attributes, but each of the task entries within this entry,
such as cn=task_IDcn=schema reload taskcn=taskscn=config, uses the schema reload
attributes to define the individual reload task.
cn
The cn attribute is used to identify a new task operation to initiate. The cn attribute value can be
anything, as long as it defines a new task.
Parameter
Description
Entry DN
cn=task_name, cn=schema reload task,
cn=tasks, cn=config
Valid Values
Any string
Default Value
Syntax
DirectoryString