8.3 Using ldif2dib for Bulkloading

You can specify the LDIF file containing the data to be imported and the path to the database files where data needs to be imported through the command line interface. Using ldif2dib to bulkload data requires the following steps:

  1. Take a backup of the DIB.

    For more information on the backup and restore process, refer to in the NetIQ eDirectory 8.8 SP8 Administration Guide.

  2. Stop the eDirectory server.

  3. To start bulkloading from the LDIF file, enter the following at the command prompt:

    ldif2dib <LDIF File Name> [Options]

    Where

    • LDIF File Name: Specifies the name of LDIF file to bulkload.

    • Options: These are optional and specify the different parameters that you can use for tuning this utility. The options supported by the ldif2dib utility are listed below:

      Options

      Description

      Value

      -b

      Specifies batch mode operation.

      Default: 0

      -c

      Specifies the cache size in bytes.

      Default: 0

      -e

      Populates errors into the specified log file.

      Default: ldif2dib.log

      -p

      Specifies the block cache percentage.

      Range: 0–100. Default: 50

      -i

      Specifies the check point interval in seconds.

      -n

      Specifies the database name to import entries.

      Enables bulkloading the object entries from LDIF file to any instance of eDirectory (DIB).

      if -n is not used, the utility displays a list of all eDirectory instances configured on the system. If only a single instance is configured, the utility selects the location of the nds.db file for that instance.

      Default: nds.db

      If you are not using the default database, you need to specify the complete path to the DIB.

      -dr

      Specifies the directory where the roll forward log (rfl) files are located.

      Default: eDirectory database

      -dd

      Specifies the directory where the data files are located.

      Default: eDirectory database

      -t

      Specifies the transaction size, that is, objects per transaction.

      Default: 100 objects

      -md

      Specifies the maximum dirty cache in bytes.

      Default: 0

      -ld

      Specifies the low dirty cache in bytes.

      Default: 0

      -r

      Populates the change cache, if there is more than one replica for the partition into which the objects are being loaded.

      If this option is not provided, the change cache is generated when the server is brought up on the bulkloaded DIB.

      -a

      Specifies the number of entries that should be loaded.

      Entire LDIF file

      -u

      Checks for duplicate entries either in the LDIF file or the DIB.

      -k

      Specifies the number of entries that should be skipped from the LDIF file.

      Default: 0 objects

      -s

      Specifies skipping errors and continuing.

       

      -w

      Generates a RSA key-pair (NDS password) that is to be imported for the userPassword attribute.

      -v

      Verbose mode to log the DNs of the entries processed into the log file.

      -x

      Disables indexes before loading entries using ldif2dib. At the end of the bulkload, the indexes are re-enabled.

       

      -?

      Displays the help messages. You can use this option anywhere in the command line with or without the hyphen (-).

    For example, if you want to set the options for specifying batch mode, cache size and block cache percentage options, enter the following command:

    ldif2dib 1MillionUsers.ldif -b/novell/log/logfile.txt -c314572800 -p90

HINT:You can temporarily suspend the bulkload by pressing the s/S key. The Escape key (Esc) can be used to stop the bulkload.