Server User Manual

Chapter 2. Core Server Configuration Reference
108
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)
• nsUniqueIdGenerator, analogous to the -g option to generate unique ID numbers for the entries
• nsUniqueIdGeneratorNamespace, analogous to the -G option to generate a unique, name-based ID
for the entries