Red Hat 8.1 Configuration And Command Reference page 80

80
Chapter 2. Core Server Configuration Reference
2.3.15. cn=tasks
Some core Directory Server tasks can be initiated by editing a directory entry using LDAP tools. T hese
task entries are contained in cn=tasks. Each task can be invoked by updating an entry such as the
following:
dn: cn=task_id, cn=task_type, cn=tasks, cn=config
...
In Red Hat Directory Server deployments before Directory Server 8.0, many Directory Server tasks were
managed by the Administration Server. T hese tasks were moved to the core Directory Server
configuration in version 8.0 and are invoked and administered by Directory Server under the cn=tasks
entry.
T here are seven tasks that are managed under the cn=tasks entry:
cn=import
cn=export
cn=backup
cn=restore
cn=index
cn=schema reload task
cn=memberof task
T he common attributes for these tasks are listed in
Entries under cn=tasks".
T he cn=tasks entry itself has no attributes and serves as the parent and container entry for the
individual task entries.
IMPORTANT
T ask entries are not permanent configuration entries. T hey only exist in the configuration file for
as long as the task operation is running or until the ttl period expires. T hen, the entry is deleted
automatically by the server.
2.3.15.1. T ask Invocation Attributes for Entries under cn=tasks
Five tasks which administer Directory Server instances have configuration entries which initiate and
identify individual operations. T hese task entries are instances of the same object class,
extensibleObject, and have certain common attributes which describe the state and behavior of
Directory Server tasks. T he task types can be import, export, backup, restore, index, schema reload, and
memberof.
cn
T he cn attribute is used to identify a new task operation to initiate. T he cn attribute value can be
anything, as long as it defines a new task.
Parameter
Entry DN
Valid Values
Default Value
Syntax
Example
nsT askStatus
T his attribute contains changing information about the status of the task, such as cumulative statistics
or its current output message. T he entire contents of the attribute may be updated periodically for as
long as the process is running.
T his attribute value is set by the server and should not be edited.
Parameter
Entry DN
Valid Values
Default Value
Section 2.3.15.1, "T ask Invocation Attributes for
Description
cn=task_name, cn=task_type, cn=tasks,
cn=config
Any string
DirectoryString
cn: example task entry name
Description
cn=task_name, cn=task_type, cn=tasks,
cn=config
Any string