Using BULKLOAD to mass create users

(Last modified: 27Sep2002)

This document (10022339) is provided subject to the disclaimer at the end of this document.

goal

fact

Novell Directory Services

fix

PURPOSE
The BULKLOAD utility is new with NDSTM 8. BULKLOAD allows you to use industry-standard LDAP
Data Interchange Format (see LDIF ) data files to create, modify, or delete NDS objects.

SYNTAX
[LOAD] BULKLOAD

LOADING NDS Objects
To run BULKLOAD.NLM, you must have created your LDIF file. BULKLOAD can produce keypairs
for each user when the userPassword field is included. (The process runs considerably slower when you
include the userPassword field.)

After you have created your LDIF file, follow the steps below.

  1.Copy the LDIF file to the server's SYS:SYSTEM directory.
  2.Start BULKLOAD.NLM at the server console.
  3.When prompted, log in as a user with the NDS rights needed to perform the operations (add,
    delete, or modify objects and properties).
  4.Select Apply LDIF File to run the batch process.

Errors are written to a log file named after the LDIF file. For instance, if the LDIF file is
NEWUSERS.LDIF, the log file will be NEWUSERS.LOG.

SAMPLE of an LDIF File
BULKLOAD supports version 0 LDIF files for adding objects and version 1 LDIF files for adding, modifying, and deleting objects. The LDIF file type exported from most e-mail programs is version 0.
Version 1 LDIF files must begin with the line:

version: 1

If this line is omitted, BULKLOAD assumes that the file is version 0, and that all objects in the file are to be added.

Version 0

You can export data in LDIF version 0 format from most e-mail and directory systems. BULKLOAD
supports only additions from LDIF version 0 files. Following is a sample LDIF version 0 file:

dn: cn=Patrick Milliken, o=Someorg
cn: Patrick Milliken
sn: Milliken
objectclass: inetorgperson
givenname: Patrick
telephonenumber: +1 802 555 1212
title: Developer
dn: cn=Susan Moller, o=Someorg
cn: Susan Moller
sn: Moller
givenname: Susan
objectclass: inetorgperson
telephonenumber: +1 801 555 1212

Version 1

LDIF version 1 files must begin with the following line:

version:1

LDIF version 1 files may contain additions, modifications, and deletions in the same file.

Following are sample data for adding entries:

dn: cn=Patrick Milliken, o=Someorg
changetype:add
cn: Patrick Milliken
sn: Milliken
givenname: Patrick
objectclass: inetorgperson
telephonenumber: +1 999 222 2222
title: Developer
dn: cn=Susan Moller, o=Someorg
changetype:add
cn: Susan Moller
sn: Moller
givenname: Susan
objectclass: inetorgperson
telephonenumber: +1 999 222 2222
title: Director

Following is a sample for modifying entries. The dashes are required to terminate each change.

dn: cn=Patrick Milliken, o=Someorg
changetype:modify
add:postaladdress
postaladdress: 999 W 555 E $ Sometown, UT $ USA
-
delete:description
-
delete:telephonenumber
telephonenumber: 1-999-999-9999
-

Deleting entries is done by specifying the distinguished names to be deleted with no leading qualifier, as shown below:

dn: cn=Patrick Milliken, o=Someorg
changetype:delete
dn: cn=Susan Moller, o=Someorg
changetype:delete

document

Document Title:	Using BULKLOAD to mass create users
Document ID:	10022339
Solution ID:	1.0.40455803.2415361
Creation Date:	26Nov1999
Modified Date:	27Sep2002
Novell Product Class:	Beta Groupware NetWare Novell eDirectory

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.