1 Directory Server Enterprise Edition File Reference

This chapter describes the files found after you install Directory Server Enterprise Edition, and after you create server instances.

The examples shown in this chapter are for Solaris systems. File extensions and path separators may differ for your operating system. This chapter includes the following sections.

Software Layout for Directory Server Enterprise Edition
Directory Server Instance Default Layout
Directory Proxy Server Instance Default Layout

1.1 Software Layout for Directory Server Enterprise Edition

This section describes the file layout you find after installing Directory Server Enterprise Edition from the zip distribution. All files locations are relative to the path where you installed the product.

install-path/bin/: The directory houses the following files of interest.
install-path/bin/certutil: NSS certificate manipulation command used by other tools, not intended to be used directly.
install-path/bin/dpadm: Directory Proxy Server command for local administration. See dpadm.
install-path/bin/dpconf: Directory Proxy Server command for configuration over LDAP. See dpconf.
install-path/bin/dsadm: Directory Server command for local administration. See dsadm.
install-path/bin/dsccagent: Command to create and manage the Directory Service Control Center agent. See dsccagent
install-path/bin/dsccmon: Command to monitor servers managed through Directory Service Control Center. See dsccmon.
install-path/bin/dsccreg: Command to manage the Directory Service Control Center registry. See dsccreg.
install-path/bin/dsccsetup: Command to set up Directory Service Control Center. See dsccsetup.
install-path/bin/dsconf: Directory Server command for configuration over LDAP. See dsconf.
install-path/bin/dsmig: Directory Server command for migration from version 5.2 to this version of Directory Server. See dsmig.
install-path/bin/dsutil: Directory Server command for activating or inactivating a user or users member of a role. See dsutil.
install-path/bin/entrycmp: Directory Server command for comparing directory entries across replica. See entrycmp.
install-path/bin/fildif: Directory Server command for filtering LDIF content. See fildif.
install-path/bin/insync: Directory Server command for examining replica synchronization. See insync.
install-path/bin/ldif: Directory Server command for formatting input by adding base64 encoding to make it suitable for inclusion in an LDIF file. See ldif
install-path/bin/mmldif: Directory Server command for combining LDIF content. See mmldif.
install-path/bin/pwdhash: Directory Server command for displaying the hashed form of a password value. See pwdhash.
install-path/bin/repldisc: Directory Server command for discovering a replication topology. See repldisc.
install-path/bin/support_tools: Directory that contains Directory Server commands, not intended for use without help of a qualified support personnel.

install-path/dsrk/bin/authrate: Directory Server Resource Kit command to measure authentication rate. See authrate.
install-path/dsrk/bin/dsmlmodify: Directory Server Resource Kit command to add, modify, rename, move, or delete directory entries through Directory Services Markup Language (DSML) v2. See dsmlmodify.
install-path/dsrk/bin/dsmlsearch: Directory Server Resource Kit command to find directory entries through Directory Services Markup Language (DSML) v2. See dsmlsearch.
install-path/dsrk/bin/example_files: Input data for makeldif keywords.
install-path/dsrk/bin/ldapcmp: Directory Server Resource Kit command to compare LDAP entries from two directories. See ldapcmp.
install-path/dsrk/bin/ldapcompare: Directory Server Resource Kit command to perform LDAP compare operations. See ldapcompare.
install-path/dsrk/bin/ldapdelete: Directory Server Resource Kit command to delete directory entries. See ldapdelete.
install-path/dsrk/bin/ldapmodify: Directory Server Resource Kit command to update entries over LDAP. See ldapmodify.
install-path/dsrk/bin/ldappasswd: Directory Server Resource Kit command to change user passwords. See ldappasswd.
install-path/dsrk/bin/ldapsearch: Directory Server Resource Kit command to search a directory. See ldapsearch.
install-path/dsrk/bin/ldapsubtdel: Directory Server Resource Kit command to recursively delete a directory subtree. See ldapsubtdel.
install-path/dsrk/bin/ldifxform: Directory Server Resource Kit command to reformat LDIF content. See ldifxform.
install-path/dsrk/bin/logconv: Directory Server Resource Kit command to analyze Directory Server access logs. See logconv.
install-path/dsrk/bin/makeldif: Directory Server Resource Kit command to generate LDIF content for testing and benchmarking purposes. See makeldif.
install-path/dsrk/bin/modrate: Directory Server Resource Kit command to measure modification performance for an LDAP directory. See modrate.
install-path/dsrk/bin/searchrate: Directory Server Resource Kit command to measure search performance for an LDAP directory. See searchrate.
install-path/dsrk/lib/: Libraries used by Directory Server Resource Kit commands, not intended to be used directly.

install-path/include/: Directory Server plug-in header files.

install-path/jre/: Java Runtime Environment, not intended to be used directly.

install-path/lib/: Libraries shared by Directory Server Enterprise Edition component products, not intended to be used directly.

install-path/resources/dpadm: Localized resource files used by dpadm.
install-path/resources/dsadmin: Localized resource files used by dsadmin
install-path/resources/install/: Directory Server instance installation templates, not intended to be used directly.
install-path/resources/ldif/Example.ldif: Sample Directory Server LDIF content.
install-path/resources/ldif/Example-roles.ldif: Sample Directory Server LDIF content with grouping based on roles.
install-path/resources/ldif/FusionAppsSchema.ldif: Schema definitions that enable you to use ODSEE with Oracle Fusion applications. See "Installation Notes" in Release Notes for Oracle Directory Server Enterprise Edition.
install-path/resources/man/: Directory Server Enterprise Edition online reference manual pages. See also Man Page Reference for Oracle Directory Server Enterprise Edition.
install-path/resources/plugins/: Directory Server plug-in configuration files, not intended to be used directly.
install-path/resources/schema/: Directory Server instance LDAP schema templates, not intended to be used directly.

install-path/var/: Container for runtime files, not intended to be used directly.

1.2 Directory Server Instance Default Layout

This section describes the file layout you find after creating a Directory Server instance. The instance-path is the file system path where you created the instance.

instance-path/alias/

NSS certificate database directory.

instance-path/alias/certmap.conf

NSS certificate mapping configuration file.

instance-path/bak/

Default data backup directory.

Each directory database backup is held in its own file system directory. The name of the backup directory corresponds to the time and date of the backup.

instance-path/config/

Server configuration directory.

instance-path/config/dse.ldif

Server configuration file, not intended to be edited directly.

instance-path/config/schema/

LDAP schema configuration files. See dirserv.

instance-path/db/

Default server database files directory. When a suffix has been created, the following database files are stored in this file system directory.

__db.00x

Files used internally by the database. Do not move, delete, or modify these files.

DBVERSION

File that identifies the version of the database.

guardian

File used to store information about the state of the database, used to determine whether database recovery is required.

log.xxxxxxxxxx

Files used to store the database transaction logs.

suffix

Files that store your directory suffix information. The directory name is derived from the suffix name, such that the database for a suffix identified by DN dc=example,dc=com is stored in a file system directory named example.

For every index defined in the database, the suffix directory contains a file with a name of the form suffix_indexedAttr.db3, such that an index of CNs for dc=example,dc=com has file name example_cn.db3.

Suffix directories also contain a file named suffix_id2entry.db3. The suffix_id2entry.db3 file contains the directory database entries.

If necessary, all index files can be rebuild from the suffix_id2entry.db3 file. To recreate the index files, reindex the suffix.

instance-path/locks/

Lock files directory.

Lock files stored here in subdirectories exports/, imports/, and server/ prevent simultaneous operations from conflicting with each other. The lock mechanisms allow one server instance to run at a time. The lock mechanisms also permit only one dsadm import (offline import) operation at a time. As a result, no export or server instance operations can be run during import.

The lock restriction does not however apply to dsconf import (online import) operations. Multiple online imports can run at the same time.

instance-path/logs/

Default server logs directory. The following files are stored here.

access logs: This file records information about client access to Directory Server. For detail about access logs, see Access Logs.
audit logs: This file records information about modifications to Directory Server data. For detail about audit logs, see Audit Logs.
core files: By default, server core files are dumped here during a crash.
errors logs: This file records errors, warnings, and informational messages logged during Directory Server operation. For detail about errors logs, see Error Logs.
pid file: This file holds the process identifier of the running server.

instance-path/plugins/DSMLv2.xsd

DSMLv2 schema file.

instance-path/plugins/soap-env.xsd

SOAP schema location for DSMLv2.

instance-path/plugins/words-english-big.txt

Default dictionary file used for strong password checks.

instance-path/plugins/signatures/

Plug-in signatures directory, not intended to be used directly.

instance-path/tmp/

Server runtime files directory, not intended to be used directly.

1.3 Directory Proxy Server Instance Default Layout

This section describes the file layout you find after creating a Directory Proxy Server instance. The instance-path is the file system path where you created the instance.

instance-path/alias/

Certificate database files, not intended to be used directly.

instance-path/config/

Server configuration files, not intended to be used directly.

instance-path/etc/

Additional instance configuration, not intended to be used directly.

instance-path/logs/

Default server logs directory. The following files are stored here.

access logs: This file records information about the requests processed by Directory Proxy Server. For detail about access logs, see Access Logs for Directory Proxy Server.
errors logs: This file records errors, warnings, and informational messages logged during Directory Proxy Server operation. For detail about errors logs, see Error Logs for Directory Proxy Server.

instance-path/tmp/

Server runtime files directory, not intended to be used directly.