Red Hat 8.1, Command Reference Manual

Page: 124 / 372

Chapter 2. Core Server Configuration Reference
110
2.3.15.3. cn=export
A database or multiple databases can be exported 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=export
entry is a container entry for export task operations. The
cn=export
entry itself
has no attributes, but each of the task entries within this entry, such as
cn=
task_ID
,
cn=export
,
cn=tasks
,
cn=config
, uses the following attributes to define the export task.
An export task entry under
cn=export
must contain the name of the database to export (in the
nsInstance
attribute) and the name of the LDIF file to write the output to (in the
nsFilename
attribute).
Additionally, it must contain a unique
cn
to identify the task. For example:
dn: cn=example export, cn=export, cn=tasks, cn=config
objectclass: extensibleObject
cn: example export
nsInstance: userRoot
nsFilename: /home/files/example.ldif
As the export 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 export operation, similar to the
options for the
db2ldif
and
db2ldif.pl
scripts:
•
nsIncludeSuffix
, analogous to the
-s
option, to specify the suffixes to include in the exported LDIF
files
•
nsExcludeSuffix
, analogous to the
-x
option, to exclude the specified suffixes from the exported
LDIF files
•
nsUseOneFile
, analogous to the
-M
option, to break up the exported suffixes into individual LDIF
files
•
nsExportReplica
, analogous to the
-r
option, to indicate whether the exported database is used in
replication
•
nsPrintKey
, analogous to the
-N
option, to set whether to print the entry IDs as the entries are
processed by the export operation
•
nsUseId2Entry
, analogous to the
-C
option, to set whether to use only the main index,
id2entry
,
to list the entries to export
•
nsNoWrap
, analogous to the
-U
option, to set whether to wrap long lines in the LDIF file
•
nsDumpUniqId
, analogous to the
-u
option, to set whether to include the unique IDs with the entries
when they are exported
nsFilename
The
nsFilename
attribute contains the path and filenames of the LDIF files to which to export the
Directory Server instance database.
Parameter Description
Entry DN cn=
task_name
, cn=export, cn=tasks, cn=config