Reference Guide › DXtools › DXloaddb Tool—Load a Datastore from an LDIF File

DXloaddb Tool—Load a Datastore from an LDIF File

Use DXloaddb to load a datastore from a LDIF file. The datastore must already exist. All previous information in the datastore is deleted.

Usage notes:

• The LDIF file does not need to be sorted.
• DXloaddb hashes any password entry in the LDIF file that is in clear text.

  If a hash algorithm is specified in the DSA configuration, DXloadbdb uses that. Otherwise it uses SHA-1.

• By default, DXloaddb uses the DSA's configuration for operational attribute handling:
  • If op-attrs = true then any operational attributes in the LDIF file are loaded into the datastore.

    Any entries in the LDIF file that do not have a createTimestamp, have a creatTimestamp added to the datastore.

  • If op-attrs = false then operational attributes in the LDIF file are ignored and no operational attributes are created by the DXloaddb.

This command has the following format:

dxloaddb [options] dsa ldif-file 

• options

  Denotes one or more of the following options:

  • -n

    Specifies that DXloaddb does not do any actions.

  • -O

    Specifies that DXloaddb includes standard operational attributes, such as password policy (for example, number of login attempts), and time stamp attributes. If this option is specified, DXloaddb creates any operational attributes that are not defined in the LDIF file.

  • -s

    Specifies that DXloaddb produces the following statistics concerning the datastore:

    • Total data size in MB
    • Total number of entries
    • Number of entries ignored
    • Amount of padding in the datastore file in KB
    • Average number of entries per MB
  • -v

    Specifies verbose output.

• ldif-file

  The name of the LDIF file to load into the datastore.

• DSA

  Defines the DSA whose datastore is to be loaded.

Example: Create and Load a Datastore

The correct sequence in which to create and load a datastore is:

dxnewdb
dxloaddb

Example: Load LDIF Data into Datastore

The following example loads the data from democorp.ldif file to datastore democorp:

dxloaddb democorp democorp.ldif 

IThe following is a possible part of democorp.ldif :

dn: o=Democorp, c=US
oc: organization
dn: ou=Administration, o=Democorp, c=US
oc: organizationalUnit
dn: cn=Fred Jones, ou=Administration, o=Democorp, c=US
oc: organizationalPerson
postalAddress: 11 Main Street $ Newtown
surname: Jones
title: Manager
telephonenumber: +1 (123) 456 7890
telephonenumber: +1 (987) 654 3210
dn: ou=Sales, o=democorp, c=US
oc: organizationalUnit

Telephonenumber appears twice because it is a multi-valued attribute