Contents


About This Guide

What You Are Expected to Know

Shell Syntax
Directory Deployment

Organization of This Guide
Documentation Conventions
Where to Find Additional Information
Acknowledgements

Part 1 Getting Started

Chapter 1 Introduction to the iPlanet Directory Server Resource Kit

What's New

New ldapcompare Tool
New ldclt Tool
New create_instance.pl Tool
New replcheck.pl Tool
New Gateway Sample Application
idsktune for Windows
New Password Security
New searchrate Functionality
New modrate Options
New authrate Option
Renamed infadd Options
New logconv.pl Options
viewcore Renamed to viewldbg

Quick Installation
iPlanet LDAP SDK for C
iPlanet Java LDAP SDK
Tools Reference

Directory Access Commands
Performance Evaluation Tools
LDIF Deployment Tools
Maintenance and Debugging Tools
Gateway Application
iPlanet LDAP Administrative Shell

Chapter 2 Installation Guide

Solaris Platforms

Installation Procedure
Removing the Software

Windows NT

Installation Procedure
Removing the Software

Other Platforms

Installation Procedure
Removing the Software

Files and Directories
Release Notes URL

Part 2 Directory Access Commands

Chapter 3 ldapsearch

Command Usage

Syntax
Options

Return Values
Command-Line Examples

Returning All Entries
Narrowing a Search
Searching the Root DSE Entry
Searching the Schema Entry
Using LDAP_BASEDN
Using a Filter File
Specifying Commas in Filters
Using Authentication

Chapter 4 ldapmodify

Command Usage

Syntax
Modification Prerequisites
Options

Return Values
Command-Line Examples

Adding an Entry
Modifying an Entry
Deleting an Entry
Using Authentication

Chapter 5 ldapdelete

Command Usage

Syntax
Options

Return Values
Command-Line Examples

Specifying Commas in DNs
Using the Standard Input
Using a DN File
Using Authentication

Chapter 6 ldapcompare

Command Usage

Syntax
Options

Return Values
Command-Line Examples

Chapter 7 ldapcmp

Command Usage

Syntax
Options

Return Values
Command-Line Examples

Comparing Two Directories
Comparing Entries
Using LDAP_BASEDN
Comparing Directory Configurations

Part 3 Performance Evaluation Tools

Chapter 8 idsktune

System Tuning

OS and Kernel Settings
TCP Settings
Further Information

Command Usage

Syntax
Options

Sample Output

Chapter 9 ldclt

Command Usage

Syntax
Options
Error Handling
Exit Status

Sample Output
Command-Line Examples

Bind Operations
Searches
Adding Entries
Modify Operations
Delete Operations
modRDN Operations

Troubleshooting

No Thread Activity
Exit Status 3
Error 32
Error 65
Error 81
Error 89
Error 91
Undocumented Options

Chapter 10 rsearch

Command Usage

Syntax
Options
Filter File Format
DN and UID File Formats

Sample Output
Command-Line Examples

Measuring Bind and Authentication Operations
Measuring Search Operations
Measuring Bind and Search Operations
Measuring Compare Operations
Measuring Modify Operations
Measuring Delete Operations

Chapter 11 searchrate

Command Usage

Syntax
Options
Random Searches

Sample Output
Command-Line Examples

Simple Search
Open, Bind, and Search Rate
Bind and Search Rate
Search Rate Alone
Complex Searches

Chapter 12 modrate

Command Usage

Syntax
Options
Random Modifications

Sample Output
Command-Line Examples

Open, Bind and Modify Rate
Bind and Modify Rate
Modify Rate Alone

Chapter 13 authrate

Command Usage

Syntax
Options
Random Authentication

Sample Output
Command-Line Examples

Open and Bind Rate
Bind Rate Alone

Chapter 14 infadd

Command Usage

Syntax
Options

Command-Line Examples

Multithreaded Verbose Output
Random Strings and Binary Values

Part 4 LDIF Deployment Tools

Chapter 15 create_instance.pl

Command Usage
Sample Configuration

Chapter 16 dbgen.pl

Command Usage

Syntax
Options

Examples and Sample Output

InetOrgPerson Entries
OrganizationalPerson Entries

Chapter 17 ldifgen

Command Usage

Syntax

Example and Sample Output

Chapter 18 ldifxform

Command Usage

Syntax
Options

Reformatting Commands

LDIF Transformations
Character Set Conversions
Attribute Name Modifications
Ordering of Entries
Directory Statistics

Examples and Sample Output

Chapter 19 mmldif

Command Usage

Syntax
Options

Examples and Sample Output

Merge Statistics
Merge Output File
Change Files

Chapter 20 ldiffer.pl

Command Usage

Syntax

Configuration File Format
Configuration File Example

Part 5 Maintenance and Debugging Tools

Chapter 21 logconv.pl

Command Usage

Syntax
Options

Sample Output

Chapter 22 replcheck.pl

Command Usage

Syntax and Options
Return Values

Example and Sample Output

Chapter 23 migrateSchemaTo5.pl

Command Usage

Syntax
Options

Chapter 24 searchplay

Command Usage

Syntax
Options

Chapter 25 viewldbg

Command Usage

Syntax

Sample Output

Chapter 26 dbscan

Command Usage

Syntax
Options

Chapter 27 Security Tools

Overview of Security Standards
Managing Certificates and Keys

certutil
cmsutil
modutil
pk12util
signtool
signver
ssltap

Other Utilities

Chapter 28 Unsupported Utilities

PerLDAP

Building PerLDAP

Perl Scripts

Part 6 Gateway Application

Chapter 29 jdgw Phone Book

Software Installation

Java 2 Platform, v1.3.1
Tomcat Web Server, v4.0 or Later
JSP Standard Tag Library

File Configuration
Sample HTML Output
Customization

Chapter 30 Tag Library Reference

LDAP Tag Library (ldaptl)
<ldap:add>
<ldap:delete>
<ldap:mod>
<ldap:modify>
<ldap:search>
<ldap:attr>
<ldap:dn>
<ldap:sortControl>
<ldap:sortKey>
<ldap:vlControl>
Utilities Tag Library (util)
<util:importParams>
<util:present>
<util:prop>
<util:encode>
<util:date>
<util:log>
<util:logScopes>
JSP Standard Tag Library (jsptl)
<jx:expr>
<jx:set>
<jx:declare>
<jx:forEach>
<jx:forToken>
<jx:if>
<jx:choose> <jx:when> <jx:otherwise>

Part 7 iPlanet LDAP Administrative Shell

Chapter 31 ilash Overview

Starting the Shell

Syntax
Options
Directory Server Dependencies

The ilash Environment

Navigation
The tclsh Shell
Tcl Quoting
Tcl Resources

Summary of Commands

LDAP Commands
Directory Navigation
Bulk Data Commands

Configuring ilash

Configuration Files
Configuration Parameters
The .lashrc File

Scripting Example

Chapter 32 ilash Command Reference

Common Options

Online Help
LDAP-Specific Options
Display Options
Specifying Target Objects

Command Reference Section
?
dadd
dbind
dbulkclean
dbulkdump
dbulkload
dcd
dcompare
ddelete
ddump
dextension
dhelp
dinfo
dlist
dload
dls
dmod
dmodify
dmodifyrdn
dmodrdn
dmove
dmoveto
dpwd
dquit
drebind
drelocate
drm
dschema
dsearch
dseq
dsequence
dshow
dshowentry
dshown
dshowname
dstatus
dunbind
help
quit

Index