1LDIF2DB(8)                  System Manager's Manual                 LDIF2DB(8)
2
3
4

NAME

6       ldif2db - Directory Server script for importing a LDIF file
7

SYNOPSIS

9       ldif2db   [-Z   serverID]   -n  backendname  {-s  includesuffix}*  [{-x
10       excludesuffix}*] [-g [string] [-G  namespace_id]]  {-i  ldiffile}*  [-c
11       chunksize] [-v] [-O] [-E] [-q] [-h]
12

DESCRIPTION

14       Imports a LDIF file.  Either the option '-n' or '-s' must be used.  The
15       server instance must be stopped prior to running this command.
16

OPTIONS

18       A summary of options is included below:
19
20       -Z Server Identifier
21              The server ID of the Directory Server  instance.   If  there  is
22              only one instance on the system, this option can be skipped.
23
24       -n Backend Name
25              The name of the LDBM database to restore.  Example: userRoot
26
27       -s includeSuffix
28              Specifies  the suffixes to be included or specifies the subtrees
29              to be included.
30
31       -x excludeSuffix
32              Specifies the suffixes to be excluded or specifies the  subtrees
33              to be excluded.
34
35       -i filename
36              Name for the LDIF file to import.
37
38       -c Chunk size
39              The  number  of  entries to process before starting a fresh pass
40              during the import.  By default this is handled internally by the
41              server.
42
43       -O
44              Requests   that  only  the  core  database  is  created  without
45              attribute indexes.
46
47       -v     Display version
48
49       -g [string]
50              Generates a unique ID. Type none for no unique ID to  be  gener‐
51              ated  and  deterministic for the generated unique ID to be name-
52              based. By default, a time-based unique ID  is  generated.   When
53              using  the  deterministic generation to have a name-based unique
54              ID, it is also possible to specify the namespace for the  server
55              to use, as follows:
56
57              -g deterministic namespaceId
58
59              namespaceId is a string of characters in the format 00-xxxxxxxx-
60              xxxxxxxx-xxxxxxxx-xxxxxxxx.
61
62       -G namespace_id
63              Generates a namespace ID as a name-based unique ID. This is  the
64              same as specifying the -g deterministic option.
65
66       -E
67              Encrypts  data  during import. This option is used only if data‐
68              base encryption is enabled.
69
70       -v
71              Display version
72
73       -h
74              Display usage
75

EXAMPLE

77       ldif2db -Z instance1 -n userRoot -i /LDAP/ldif/data.ldif
78
79       ldif2db -s "dc=example,dc=com" -i /LDAP/ldif/data.ldif
80

DIAGNOSTICS

82       Exit status is zero if no errors occur.  Errors result  in  a  non-zero
83       exit status and a diagnostic message being written to standard error.
84

AUTHOR

86       ldif2db was written by the 389 Project.
87

REPORTING BUGS

89       Report bugs to https://pagure.io/389-ds-base/new_issue
90

92       Copyright © 2017 Red Hat, Inc.
93
94
95
96                                March 31, 2017                      LDIF2DB(8)
Impressum