Sun Java logo     Copyright      Index      Next     

Sun logo
Sun ONE Directory Server Resource Kit 5.2 Tools Reference 

Contents


List of Figures

List of Tables

List of Procedures

List of Code Examples

About This Guide
Audience for This Guide
Directory Server Resource Kit Documentation Set
Tools Reference
Sun ONE LDAP SDK for C Programming Guide
Sun ONE LDAP SDK for Java Programming Guide
Documentation Conventions Used in This Guide
Typographical Conventions
Terminology
Related Sources of Information
Directory Server Documentation
Sources of Information
Third-Party Sources of Information
The Mozilla Project
Perl Development
Tomcat Web Server
Acknowledgements
Documentation Feedback

Part 1 Getting Started

Chapter 1   Introduction
Overview
Command-Line Tools
Directory Access
Performance Evaluation
LDAP v3 Tools
LDIF Deployment
Maintenance and Debugging
LDAP Administrative Shell
Sample Phonebook Application
Java Naming and Directory Interface
Sun ONE Directory Server Plug-In
Sun ONE LDAP SDK for C
Sun ONE LDAP SDK for Java

Chapter 2   Installing the Directory Server Resource Kit
Before Installing
Solaris Operating System (SPARC and x86 Platform Editions)
System Requirements
Installing DSRK on Solaris
Removing DSRK From Solaris
Windows® Operating Systems
System Requirements
Installing DSRK on Windows
Post-Installation for Windows
Changing the Path Variable
Language Interpreters
Removing DSRK From Windows
Additional Platforms
Installing DSRK on Additional Platforms
Removing DSRK From Additional Platforms
Files and Directories

Part 2 Directory Access Tools

Chapter 3   The ldapsearch Tool
Overview
Command Usage
Syntax
Options
Common Options
Input And Output Options
LDAP Controls Options
SSL (Secure Socket Layer) 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
Using Server Authentication
Using Client Authentication

Chapter 4   The ldapmodify Tool
Overview
Command Usage
Syntax
Modification Prerequisites
Options
Common Options
Input And Output Options
SSL (Secure Socket Layer) Options
Return Values
Command-Line Examples
Adding an Entry
Modifying an Entry
Deleting an Entry
Using Authentication
Using Server Authentication
Using Client Authentication

Chapter 5   The ldapdelete Tool
Overview
Command Usage
Syntax
Options
Common Options
Input And Output Options
SSL (Secure Socket Layer) Options
Return Values
Common Use Examples
Using the Command Line
Using the Standard Input
Using a DN File
Using Authentication
Using Server Authentication
Using Client Authentication

Chapter 6   The ldapcompare Tool
Overview
Command Usage
Syntax
Options
Common Options
Input And Output Options
SSL (Secure Socket Layer) Options
Return Values
Command-Line Examples
Comparing a Text Value
Comparing a Binary Value

Chapter 7   The ldapcmp Tool
Overview
Command Usage
Syntax
Options
CommonOptions
Input and Output Options
SSL (Secure Socket Layer) Options
Return Values
Command-Line Examples
Comparing Two Directories
Comparing Two Entries
Using LDAP_BASEDN
Comparing Directory Configurations

Chapter 8   The LDAPSubtdel Tool
Overview
Running LDAPSubtdel
With LDAP SDK Installed
Without LDAP SDK Installed
Options
Example

Chapter 9   Directory Access Tools Using DSML
Overview
Usage
Tools
DsmlSearch
Syntax
DsmlSearch Options
DsmlModify
Syntax
DsmlModify Options
Java Naming and Directory Interface

Part 3 Performance Tools

Chapter 10   The idsktune Optimization Tool
Overview
System Tuning
OS and Kernel Settings
TCP Settings
Further Information
Command Usage
Syntax
Options
Sample Output

Chapter 11   The ldclt Stress Test Tool
Overview
Command Usage
Syntax
Options
General Options
Bind Options
Target Object Options
Operation-specific Options
Exit Status
Error Handling
Allowing Error Occurences
Ignoring Error Occurences
Sample Output
Performance Statistics
Global Statistics
Command-Line Examples
Bind Operations
Random Binding
SSL Authentication
Searches
Anonymous Searches
Wildcard Searches
Random Filters and RDNs
Adding Entries
Random Base DNs
Create Missing Nodes
Random Entry Generation
To generate simple inetorgperson entries, use the following command:
Generating LDIF Files
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 12   The rsearch Search Tool
Overview
Command Usage
Syntax
Options
Filter File Format
DN and UID File Formats
Sample Output
Command-Line Examples
Measuring Bind and Authentication Operations
Anonymous Bind Rate
Random DN Authentication Rate
Random UID Authentication Rate
Root DN Bind Rate
Measuring Search Operations
Simple Search
Search Rate Using Anonymous Bind
Search Rate Using DN Bind
Specific Attribute Search Rate
Measuring Bind and Search Operations
Anonymous Bind and Search Rate
Random DN Bind and Search Rate
Random UID Bind and Search Rate
Measuring Compare Operations
Compare Rate
Bind and Compare Rate
Measuring Modify Operations
Indexed Attribute Modify Rate
Non-Indexed Attribute Modify Rate
Measuring Delete Operations
Delete Rate
Bind and Delete Rate

Part 4 LDAP v3 Tools

Chapter 13   The Search Performance Measurement Tool
Overview
Command Usage
Syntax
Options
Randomly Generated Numbers
Syntax
Substitution Rules
Input File
Sample Output
Command-Line Examples
Simple Search
Search Using an Input File
Open, Bind, and Search Rate
Bind and Search Rate
Search Rate Alone
Complex Searches

Chapter 14   The Modify Performance Measurement Tool
Overview
Command Usage
Syntax
Options
Randomly Generated Target Entries
Syntax
Substitution Rules
Input File
Sample Output
Command-Line Examples
Open, Bind and Modify Rate
Searches with an Input File
Bind and Modify Rate
Modify Rate Alone

Chapter 15   The Rate of Authentication Measurement Tool
Overview
Command Usage
Syntax
Options
Randomly Generated Bind DNs
Syntax
Substitution Rules
Sample Output
Command-Line Examples
Open and Bind Rate
Bind Rate Alone

Chapter 16   The Add Performance Measurement Tool
Overview
Command Usage
Syntax
Options
Command-Line Examples
Multithreaded Verbose Output
Random Strings and Binary Values

Part 5 LDIF Deployment Tools

Chapter 17   The Directory Server 4.x Instance Creation Tool
Overview
Command Usage
Configuration Information
General Information
New Directory Instance Information
Administration Information
Base Information

Chapter 18   The Standard Schema LDIF Generator Tool
Overview
Accompanying Data Files
Customizing the Script
Command Usage
Syntax
Options
Sample Output
InetOrgPerson Entries
OrganizationalPerson Entries

Chapter 19   The Custom Schema LDIF Generator Tool
Overview
Command Usage
Syntax
Options
Sample Output

Chapter 20   The Java-based LDIF Generator Utility
Overview
Command Usage
Syntax
Options
Customizing the Template File
Global Replacement Definitions
Branch Entry Definitions
Basic Structure of Branch Entry Definition
SubordinateTemplate Definition Entries
Global Replacement Variables In Branch Definition Entries
Template Definitions
Tokens Supported in Template Definitions
Subordinate Templates in Template Definitions
Inheritance in Template Definitions
Additional Information

Chapter 21   The LDIF Transformation Tool
Overview
Command Usage
Syntax
Options
Reformatting Operations
LDIF Transformations
Character Set Conversions
Attribute Modifications
LDAP Entry Presorting
Directory Analysis
Command-Line Examples
Transforming LDIF to a List
Statistical Output

Chapter 22   The LDIF Merge Tool
Overview
Command Usage
Syntax
Options
Command-Line Examples
Merge Statistics
Merge Output File
Produce Change Files

Chapter 23   The LDAP Compare and Modify Tool
Overview
Using the Script
Customizing the Script
Command Usage
Output Files
configFile.timestamp.action.log
configFile.timestamp.debug.log
Configuration File
Configuration File Syntax
Global Parameters
Sequential and Random Parameters
Connection Parameters
Comparison Parameters
Action Parameters
Unmatched Entry Parameters
Configuration File Use Scenario
Working With ldifxform

Part 6 Maintenance and Debugging Tools

Chapter 24   The Log Analyzer Tool
Overview
Statistics for Display
Tool Performance
Customizing the Script
Command Usage
Syntax
Options
Command-Line Examples
Error Code Listing
Verbose Output

Chapter 25   The Replication Checker Tool
Overview
Tool Dependencies
Command Usage
Return Values
Command-Line Example

Chapter 26   The Schema Migration Tool
Overview
Command Usage
Syntax
Options

Chapter 27   The Search Operations Audit Tool
Overview
Command Usage
Syntax
Options

Chapter 28   The Core File Analyzer Tool
Overview
Command Usage
Syntax
Command-Line Example

Chapter 29   The Database File Analyzer Tool
Overview
Command Usage
Syntax
Options

Chapter 30   Network Security Services
Overview
Security Standards
Managing Certificates and Keys
certutil
cmsutil
modutil
pk12util
signtool
signver
ssltap
Format Conversion Commands
atob
btoa
Other Utilities

Chapter 31   Unsupported Utilities
PerLDAP
Perl Scripts

Part 7 LDAP Administrative Shell

Chapter 32   ilash: The LDAP Administrative Shell
Overview
The ilash Environment
Navigation
Specifying Target Objects
The Location Stack
‘The World’
The Sequence
The tclsh Shell
Tcl Quoting
Tcl Resources
Directory Server Dependencies
Importing the Directory Schema
Multithreading
Command Usage
Other Commands
Exiting ilash
Configuring ilash
Configuration Files
Global Parameters
DN Aliases
Command Defaults
Server Specifications
User Specifications
The .lashrc File
Summary of Commands
LDAP Commands
Directory Navigation
Bulk Data Commands
Bulk Data Scripting Example

Chapter 33   ilash Command Reference
Overview
Common Options
Online Help
LDAP-Specific Options
Display Options
Modifying Default Behavior
Command Reference

Part 8 Sample Phonebook Application

Chapter 34   JSP Directory Gateway Phonebook
Overview
Apache Software
LDAP Tag Libraries
LookMeUp Application Files
Software Installation
Java 2 Platform, v1.3.1
Tomcat Web Server, v4.0 or Later
Starting the Server
Testing the Server and Accessing Tomcat Documentation
JSP Standard Tag Library
Viewing the JSPTL Documentation
Post-Installation Configuration
LookMeUp Configuration
Tomcat Server Configuration
Accessing LookMeUp

Chapter 35   Tag Library Reference
Overview
LDAP Tag Library
Summary
Utilities Tag Library
JSP Standard Tag Library

Part 9 Additional Tools and Information

Chapter 36   NameFinder Application
Overview
Deploying NameFinder
Configuring NameFinder
Server Configuration Attributes
LDAP Attribute Configurations
Name and Contact Information
Location Information
Calendar Information
Miscellaneous Information
Predefined Attribute Fields
Search Parameters

Chapter 37   Java Naming and Directory Interface
Overview
JNDI Service Provider for DSML
JNDI Booster Pack for LDAP Service Provider
Additional Information
The JNDI Tutorial
JNDI page for Java Developers
XML page for Java Developers
Javadocs for JNDI 1.2.1

Chapter 38   Attribute Value Uniqueness Plug-In
Overview
Networking Plug-Ins
Distributed Hash Tables
Limitations
Using UID Uniqueness Plug-In
No Signature File
Multi-Master Replication Topology
Unavailability at Startup
Performance Considerations
Single Point of Failure
Deploying the Plug-In
Creating the Plug-In Instance
Configuring the Plug-In Using the Console
Configuring the Plug-In From the Command-Line

Index


Copyright      Index      Next     


Copyright 2004 Sun Microsystems, Inc. All rights reserved.