import-ldif

Description

Import LDIF data into a Directory Server backend.

Connection parameters are not required when importing to a local Directory Server that is not running. However, connection parameters are required if the Directory Server is remote, or if the Directory Server is running locally and it is inconvenient to have to stop it for the import. You can use the options to include or exclude specific attributes and branches of the tree, and to include or exclude entries matching a given filter. The input file may be compressed.

This tool features both an offline mode of operation as well as the ability to schedule an operation to run within the Directory Server's process. To schedule an operation supply LDAP connection options that allow this tool to communicate with the server through its task interface. Tasks can be scheduled to run immediately or at a later time (see Task Scheduling Options below). Once scheduled, tasks can be managed using the manage-tasks tool.

Examples

import-ldif --backendID userRoot --ldifFile userRoot.ldif

import-ldif --backendID userRoot --ldifFile userRoot.ldif.gz --isCompressed \
     --rejectFile rejects.ldif --skipFile skipped.ldif --overwrite

import-ldif --task --hostname server1 --port 389 \
     --bindDN uid=admin,dc=example,dc=com --bindPassword password \
     --backendID userRoot --ldifFile userRoot.ldif

import-ldif --backendID userRoot --templateFile example.template

import-ldif --includeBranch dc=example,dc=com --ldifFile people.ldif

Arguments

-V
--version

-H
--help

--help-ldap

--help-sasl

--help-debug

-Z
--useSSL

-q
--useStartTLS

--useNoSecurity

-h {host}
--hostname {host}

-p {port}
--port {port}

-D {bindDN}
--bindDN {bindDN}

-w {bindPassword}
--bindPassword {bindPassword}

-j {bindPasswordFile}
--bindPasswordFile {bindPasswordFile}

-o {name=value}
--saslOption {name=value}

-X
--trustAll

-P {trustStorePath}
--trustStorePath {trustStorePath}

-T {trustStorePassword}
--trustStorePassword {trustStorePassword}

-U {path}
--trustStorePasswordFile {path}

-K {keyStorePath}
--keyStorePath {keyStorePath}

-W {keyStorePassword}
--keyStorePassword {keyStorePassword}

-u {keyStorePasswordFile}
--keyStorePasswordFile {keyStorePasswordFile}

-N {nickname}
--certNickname {nickname}

--useAdministrativeSession

--propertiesFilePath {propertiesFilePath}

--usePropertiesFile

--task

-t {startTime}
--start {startTime}

--completionNotify {emailAddress}

--errorNotify {emailAddress}

--dependency {taskID}

--failedDependencyAction {action}

-Q
--quiet

-l {ldifFile}
--ldifFile {ldifFile}

-A {templateFile}
--templateFile {templateFile}

-n {backendName}
--backendID {backendName}

-F
--clearBackend

-b {branchDN}
--includeBranch {branchDN}

-B {branchDN}
--excludeBranch {branchDN}

-i {attribute}
--includeAttribute {attribute}

-e {attribute}
--excludeAttribute {attribute}

-I {filter}
--includeFilter {filter}

-E {filter}
--excludeFilter {filter}

-R {rejectFile}
--rejectFile {rejectFile}

--skipFile {skipFile}

-O
--overwrite

-s {seed}
--randomSeed {seed}

--stripTrailingSpaces

--countRejects

-c
--isCompressed

-y
--isEncrypted

--isSigned

--addMissingRdnAttributes

-r
--overwriteExistingEntries

--logFilePath {logFilePath}