Red Hat 8.1 - Manual (Page 82)

Parameter Description
Entry DN cn=task_name, cn=task_type, cn=tasks,
cn=config
Valid Values 0 to the maximum 32 bit integer value
(2147483647)
Default Value
Syntax
Integer
Example nsTaskTotalItems: 152
nsTaskCancel
This attribute allows a task to be aborted while in progress. This attribute can be modified by users.
Parameter Description
Entry DN cn=task_name, cn=task_type, cn=tasks,
cn=config
Valid Values true | false
Default Value
Syntax
Case-insensitive string
Example nsTaskCancel: true
ttl
This attribute sets the amount of time (in seconds) the task entry will remain in the DSE after the task
has finished or aborted. Setting a ttl attribute allows the task entry to be polled for new status
information without missing the exit code. Setting the ttl attribute to 0 means that the entry is not
cached.
Parameter Description
Entry DN cn=task_name, cn=task_type, cn=tasks,
cn=config
Valid Values 0 (cannot be cached) to the maximum 32 bit
integer value (2147483647)
Default Value
Syntax
DirectoryString
Example ttl: 120
2.3.15.2. cn=import
An LDIF file or multiple LDIF files can be imported through 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.
The cn=import entry is a container entry for import task operations. The cn=import entry itself has
no attributes, but each of the task entries within this entry, such as cn=task_ID, cn=import,
cn=tasks, cn=config, uses the following attributes to define the import task.
An import task entry under cn=import must contain the LDIF file to import (in the nsFilename attribute)
and the name of the instance into which to import the file (in the nsInstance attribute). Additionally, it must
contain a unique cn to identify the task. For example:
dn: cn=example import, cn=import, cn=tasks, cn=config
objectclass: extensibleObject
cn: example import
nsFilename: /home/files/example.ldif
nsInstance: userRoot
As the import operation runs, the task entry will contain all of the server-generated task attributes listed
in
Section 2.3.15.1, “Task Invocation Attributes for Entries under cn=tasks” .
There are some optional attributes which can be used to refine the import operation, similar to the
options for the ldif2db and ldif2db.pl scripts:
nsIncludeSuffix , which is analogous to the -s option to specify the suffix to import
nsExcludeSuffix , analogous to the -x option to specify a suffix or subtree to exclude from the import
nsImportChunkSize , analogous to the -c option to override starting a new pass during the import
and merge the chunks
nsImportIndexAttrs , which sets whether to import attribute indexes (with no corollary in the script
options)
82
Chapter 2. Core Server Configuration Reference