Preface

This Troubleshooting Guide shows you how to troubleshoot problems with Sun Java System Directory Server Enterprise Edition.

Who Should Use This Book

This guide is intended for advanced administrative users who are troubleshooting problems with Directory Server Enterprise Edition.

Before using this guide, you must be familiar with the following:

• Directory Server functionality

• Specifications for LDAP and related protocols, such as DSML v2

• Internet and World Wide Web technologies

Before You Read This Book

Review pertinent information in the Release Notes for Oracle Directory Server Enterprise Edition.

How This Book Is Organized

Chapter 1, "Overview of Troubleshooting Directory Server Enterprise Edition" describes how to approach troubleshooting problems in Directory Server Enterprise Edition, including how to define the scope of the problem, generic data collection, troubleshooting tools, and a where to get more information.

Chapter 2, "Troubleshooting Installation and Migration Problems" provides information to help you troubleshoot installation and migration problems.

Chapter 3, "Troubleshooting Replication" provides information to help you troubleshoot problems with replication and contains a procedure to help you reinitialize your entire topology.

Chapter 4, "Troubleshooting Directory Proxy Server" provides information to help you troubleshoot problems with Directory Proxy Server.

Chapter 5, "Troubleshooting Directory Server Problems" provides information about how to troubleshoot general problems with Directory Server, including a crash, an unresponsive process, database problems, and memory leaks.

Chapter 6, "Troubleshooting Data Management Problems" provides information to help you troubleshoot data management problems, include operation failures and SSL problems.

Chapter 7, "Troubleshooting Identity Synchronization for Windows" provides information to help you troubleshoot problems you may encounter while using Identity Synchronization for Windows.

Chapter 8, "Troubleshooting DSCC Problems" contains information to help you troubleshoot problems with DSCC.

Chapter 9, "Directory Server Error Log Message Reference" lists messages logged by Directory Server that can serve as a good starting point for resolving common problems.

Chapter 10, "Directory Proxy Server Error Log Message Reference" lists messages logged by Directory Server that can serve as a good starting point for resolving common problems.

Examples Used in This Guide

For consistency, the same example data is used throughout this guide. Replace these values with the appropriate values for your system.

Variable	Values used in examples
Suffix (SUFFIX_DN)	dc=example,dc=com
Instance path (INSTANCE_PATH)	For Directory Server: /local/dsInst/ For Directory Proxy Server: /local/dps/
Hostnames (HOST)	host1, host2, host3
Port (PORT)	LDAP: Default for root: 389. Default for non-root: 1389 SSL default: Default for root: 636. Default for non-root: 1636

Oracle Directory Server Enterprise Edition Documentation Set

This documentation set explains how to use Oracle Directory Server Enterprise Edition to evaluate, design, deploy, and administer directory services. In addition, it shows how to develop client applications for Directory Server Enterprise Edition. The Oracle Fusion Middleware Directory Server Enterprise Edition Documentation Library is available at http://docs.oracle.com/cd/E29127_01/index.htm.

The following table lists the documents that make up the Directory Server Enterprise Edition documentation set.

Document Title	Contents
Release Notes for Oracle Directory Server Enterprise Edition	Contains the latest information about Directory Server Enterprise Edition, including known problems.
Evaluation Guide for Oracle Directory Server Enterprise Edition	Introduces the key features of this release. Demonstrates how these features work and what they offer in the context of a deployment that you can implement on a single system.
Deployment Planning Guide for Oracle Directory Server Enterprise Edition	Explains how to plan and design highly available, highly scalable directory services based on Directory Server Enterprise Edition. Presents the basic concepts and principles of deployment planning and design. Discusses the solution life cycle, and provides high-level examples and strategies to use when planning solutions based on Directory Server Enterprise Edition.
Installation Guide for Oracle Directory Server Enterprise Edition	Explains how to install the Directory Server Enterprise Edition software. Shows how to configure the installed software and verify the configured software.
Upgrade and Migration Guide for Oracle Directory Server Enterprise Edition	Provides instructions for upgrading versions 11.1.1.3, 7.x, and 6 installations, and instructions for migrating version 5.2 installations.
Administrator's Guide for Oracle Directory Server Enterprise Edition	Provides command-line instructions for administering Directory Server Enterprise Edition. For hints and instructions about using the Directory Service Control Center, DSCC, to administer Directory Server Enterprise Edition, see the online help provided in DSCC.
Reference for Oracle Directory Server Enterprise Edition	Introduces technical and conceptual foundations of Directory Server Enterprise Edition. Describes its components, architecture, processes, and features.
Man Page Reference for Oracle Directory Server Enterprise Edition	Describes the command-line tools, schema objects, and other public interfaces that are available through Directory Server Enterprise Edition. Individual sections of this document can be installed as online manual pages.
Developer's Guide for Oracle Directory Server Enterprise Edition	Shows how to develop directory client applications with the tools and APIs that are provided as part of Directory Server Enterprise Edition.
Troubleshooting for Oracle Directory Server Enterprise Edition Guide	Provides information for defining the scope of the problem, gathering data, and troubleshooting the problem areas by using various tools.
Release Notes for Identity Synchronization for Windows 6.0	Provides the latest information for installing, migrating, and upgrading Identity Synchronization for Windows 6.0 SP1.
Deployment Planning Guide for Identity Synchronization for Windows 6.0	Provides general guidelines and best practices for planning and deploying Identity Synchronization for Windows.
Installation and Configuration Guide for Identity Synchronization for Windows 6.0	Describes how to install and configure Identity Synchronization for Windows.

For an introduction to Directory Server Enterprise Edition, review the following documents in the order in which they are listed in the following figure.

Description of the illustration docmap.png

Related Reading

The SLAMD Distributed Load Generation Engine is a Java application that is designed to stress test and analyze the performance of network-based applications. This application was originally developed by Sun Microsystems, Inc. to benchmark and analyze the performance of LDAP directory servers. SLAMD is available as an open source application under the Sun Public License, an OSI-approved open source license. To obtain information about SLAMD, go to http://www.slamd.com/. SLAMD is also available as a java.net project. See https://slamd.dev.java.net/.

Java Naming and Directory Interface (JNDI) supports accessing the Directory Server using LDAP and DSML v2 from Java applications. For information about JNDI, see http://www.oracle.com/technetwork/java/jndi/index.html. The JNDI Tutorial contains detailed descriptions and examples of how to use JNDI. This tutorial is at http://download.oracle.com/javase/jndi/tutorial/.

Identity Synchronization for Windows uses Message Queue with a restricted license. Message Queue documentation is available at http://www.oracle.com/technetwork/indexes/documentation/index.html.

Identity Synchronization for Windows works with Microsoft Windows password policies.

• Information about password policies for Windows 2003, is available in the Microsoft documentation (http://technet.microsoft.com/en-us/windowsserver/default.aspx) online.

• Information about the Microsoft Certificate Services Enterprise Root certificate authority, is available in the Microsoft support documentation (http://support.microsoft.com/default.aspx?scid=kb;en-us;247078) online.

• Information about configuring LDAP over SSL on Microsoft systems, is available in the Microsoft support documentation (http://support.microsoft.com/default.aspx?scid=kb;en-us;321051) online.

Redistributable Files

Directory Server Enterprise Edition does not provide any files that you can redistribute.

Default Paths and Command Locations

This section explains the default paths used in documentation, and provides locations of commands on different operating systems and deployment types.

Default Paths

The table in this section describes the default paths that are used in this document. For complete descriptions of the files installed, see Chapter 1, Directory Server Enterprise Edition File Reference, in Reference for Oracle Directory Server Enterprise Edition.

Placeholder	Description	Default Value
install-path	Represents the base installation directory for Directory Server Enterprise Edition software.	When you install from a zip distribution using unzip, the install-path is the current-directory/dsee7.
instance-path	Represents the full path to an instance of Directory Server or Directory Proxy Server. Documentation uses /local/dsInst/ for Directory Server and /local/dps/ for Directory Proxy Server.	No default path exists. Instance paths must nevertheless always be found on a local file system. On Solaris systems, the /var directory is recommended:
serverroot	Represents the parent directory of the Identity Synchronization for Windows installation location	Depends on your installation. Note that the concept of a serverroot no longer exists for Directory Server and Directory Proxy Server.
isw-hostname	Represents the Identity Synchronization for Windows instance directory	Depends on your installation
/path/to/cert8.db	Represents the default path and file name of the client's certificate database for Identity Synchronization for Windows	current-working-dir/cert8.db
serverroot/isw-hostname/linebreaklogs/	Represents the default path to the Identity Synchronization for Windows local log files for the System Manager, each connector, and the Central Logger	Depends on your installation
serverroot/isw-hostname/linebreaklogs/central/	Represents the default path to the Identity Synchronization for Windows central log files	Depends on your installation

Command Locations

The table in this section provides locations for commands that are used in Directory Server Enterprise Edition documentation. To learn more about each of the commands, see the relevant man pages. See also "Sofware Layout for Directory Server Enterprise Edition" in the Reference for Oracle Directory Server Enterprise Edition.

Command	Zip Distribution
certutil	install-path/bin/certutil
dpadm	install-path/bin/dpadm
dpconf	install-path/bin/dpconf
dsadm	install-path/bin/dsadm
dsccagent	install-path/bin/agent
dsccmon	install-path/bin/dsccmon
dsccreg	install-path/bin/dsccreg
dsccsetup	install-path/bin/dsccsetup
dsconf	install-path/bin/dsconf
dsmig	install-path/bin/dsmig
dsutil	install-path/bin/dsutil
entrycmp	install-path/bin/entrycmp
fildif	install-path/bin/fildif
idsktune	At the root of the unzipped zip distribution
insync	install-path/bin/insync
ldapmodify	install-path/dsrk/bin/ldapmodify
ldapsearch	install-path/dsrk/bin/ldapsearch
repldisc	install-path/bin/repldisc

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Typeface	Meaning	Example
AaBbCc123	The names of commands, files, and directories, and onscreen computer output	Edit your .login file. Use ls a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with onscreen computer output	machine_name% su Password:
aabbcc123	Placeholder: replace with a real name or value	The command to remove a file is rm filename.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX system prompt and superuser prompt for shells that are included in the Oracle Solaris OS. Note that the default system prompt that is displayed in command examples varies, depending on the Oracle Solaris release.

Shell	Prompt
Bash shell, Korn shell, and Bourne shell	$
Bash shell, Korn shell, and Bourne shell for superuser	#
C shell	machine_name%
C shell for superuser	machine_name#

Symbol Conventions

The following table explains symbols that might be used in this book.

Symbol	Description	Example	Meaning
[ ]	Contains optional arguments and command options.	ls [-l]	The -l option is not required.
{ | }	Contains a set of choices for a required command option.	-d {y|n}	The -d option requires that you use either the y argument or the n argument.
${ }	Indicates a variable reference.	${com.sun.javaRoot}	References the value of the com.sun.javaRoot variable.
-	Joins simultaneous multiple keystrokes.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	Press the Control key, release it, and then press the subsequent keys.
>	Indicates menu item selection in a graphical user interface.	File > New > Templates	From the File menu, choose New. From the New submenu, choose Templates.

Documentation, Support, and Training

See the following web sites for additional resources:

• Documentation (http://www.oracle.com/technetwork/indexes/documentation/index.html)

• Support (http://www.oracle.com/us/support/systems/index.html)

• Training (http://education.oracle.com)

Oracle Software Resources

Oracle Technology Network (http://www.oracle.com/technetwork/index.html) offers a range of resources related to Oracle software:

• Discuss technical problems and solutions on the ODSEE Discussion Forum (http://forums.oracle.com/forums/forum.jspa?forumID=877) and the Directory Services blog (http://blogs.oracle.com/directoryservices/).

• See the latest announcements on the Directory Services blog (http://blogs.oracle.com/directoryservices/).

• Download ODSEE 11g Example Files (http://www.oracle.com/technetwork/middleware/id-mgmt/learnmore/odsee11113-examples-350399.zip).

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.