Sun Java System Directory Server Enterprise Edition 6.2 Migration Guide

Changes to the Installed Product Layout

This section summarizes the changes to the installed product layout from Directory Server 5.2. Several files and utilities have been deprecated since Directory Server 5.2, as described in the following sections.

Administration Utilities Previously Under ServerRoot

In Directory Server 6.2 the Administration Server is no longer used to manage server instances.

The following system administration utilities previously located under ServerRoot have therefore been deprecated:

Binaries Previously Under ServerRoot/bin

The following utilities under ServerRoot/bin have been deprecated:

On Solaris SPARC, the ns-slapd daemon is located in install-path/ds6/bin/lib/sparcvSolaris-Version. On platforms other than Solaris SPARC, the ns-slapd daemon is located in install-path/ds6/bin/lib.

Libraries and Plug-Ins Previously Under ServerRoot/lib

Product libraries and plug-ins in Directory Server 5.2 were located under ServerRoot/lib. In Directory Server 6.2, on Solaris SPARC, these libraries and plug-ins are located in install-path/ds6/lib/sparcvSolaris-Version. On platforms other than Solaris SPARC, they are located directly under install-path/ds6/lib.

Online Help Previously Under ServerRoot/manual

Console online help files were previously located under ServerRoot/manual. The console online help files for Directory Server 6.2 are located under opt/SUNWdsee/ds6/dccapp/html.

Plug-Ins Previously Under ServerRoot/plugins

The following tables describes the new location of sample server plug-ins, and header files for plug-in development.

Table 5–5 Support for Plug-Ins

Directory Server 5.2 Plug-In Directory 

Directory Server 6.2 Plug-In Directory 

Remarks 

ServerRoot/plugins/slapd/slapi/examples

install-path/ds6/examples

Sample plug-ins 

ServerRoot/plugins/slapd/slapi/include

install-path/ds6/include

Plug-in header files 

SNMP support is no longer handled within Directory Server. SNMP monitoring is now handled by the Java Enterprise System Management Framework (Java ES MF). All plug-ins and binaries related to SNMP have therefore been deprecated within Directory Server.

These plug-ins include the following:

For information about enabling monitoring Java ES MF monitoring, see Enabling Java ES MF Monitoring in Sun Java System Directory Server Enterprise Edition 6.2 Administration Guide.

Utilities Previously Under ServerRoot/shared/bin

The following tables describes the new location of the administrative tools previously under ServerRoot/shared/bin. Note that as a result of the change to the administrative framework, some of these tools have been deprecated.

Table 5–6 Tools Previously Under ServerRoot/shared/bin

5.2 File 

6.0 File 

Purpose 

ServerRoot/shared/bin/admin_ip.pl

Deprecated 

Change IP address 

ServerRoot/shared/bin/entrycmp

install-path/ds6/bin/entrycmp

Compare entries for replication 

ServerRoot/shared/bin/fildif

install-path/ds6/bin/fildif

Dump filtered LDIF 

ServerRoot/shared/bin/insync

install-path/ds6/bin/insync

Check replication synchronization 

ServerRoot/shared/bin/ldapcompare

/usr/sfw/bin/ldapcompare

Compare attribute value 

In Directory Server 6.2 you must install the SUN-LDAPCSDK-TOOLS package to get this utility

ServerRoot/shared/bin/ldapdelete

/usr/sfw/bin/ldapdelete

Delete directory entry 

In Directory Server 6.2 you must install the SUN-LDAPCSDK-TOOLS package to get this utility

ServerRoot/shared/bin/ldapmodify

/usr/sfw/bin/ldapmodify

Modify directory entry 

In Directory Server 6.2 you must install the SUN-LDAPCSDK-TOOLS package to get this utility

ServerRoot/shared/bin/ldapsearch

/usr/sfw/bin/ldapsearch

Find directory entries 

In Directory Server 6.2 you must install the SUN-LDAPCSDK-TOOLS package to get this utility

ServerRoot/shared/bin/modutil

Deprecated 

Manage PKCS #11 modules 

ServerRoot/shared/bin/uconv

Deprecated 

Convert from ISO to UTF-8 

ServerRoot/shared/bin/repldisc

install-path/ds6/bin/repldisc

Discover replication topology 

Certificate and Key Files

The following table shows the new locations of the certificate and key files in Directory Server 6.2.

Table 5–7 Location of Certificate and Key Files

5.2 File 

6.0 File 

Remarks 

ServerRoot/shared/config/certmap.conf

instance-path/alias/certmap.conf

Configuration file for mapping certificates to directory entries 

ServerRoot/alias/cert8.db

instance-path/alias/cert8.db

Trusted certificate database file 

ServerRoot/alias/key3.db

instance-path/alias/key3.db

Database file containing client keys 

ServerRoot/alias/secmod.db

instance-path/alias/secmod.db

Database file containing security modules such as PKCS#11

Silent Installation and Uninstallation Templates

In Directory Server 5.2, the ServerRoot/setup5 directory contained sample templates for silent installation and uninstallation. Silent installation and uninstallation are no longer needed for Directory Server 6.2 and these files have therefore been deprecated.

Server Instance Scripts Previously Under ServerRoot/slapd-ServerID

The command-line administration scripts previously under ServerRoot/slapd-ServerID have been replaced in the new administration framework and deprecated. These commands and their Directory Server 6.2 equivalents are described in Command Line Changes.

Server Instance Subdirectories

The following table describes the new locations for the configuration, log and backup data previously located under ServerRoot/slapd-instance-name

Table 5–8 Instance-Specific Subdirectories

Version 5 Directory 

Version 6 Directory 

Remarks 

ServerRoot/slapd-ServerID/bak

instance-path/bak

Directory instance database backup 

ServerRoot/slapd-ServerID/confbak

Deprecated 

Administration Server configuration backup 

ServerRoot/slapd-ServerID/conf_bk

instance-path/conf_bk

Directory instance configuration backup 

ServerRoot/slapd-ServerID/config

instance-path/config

Directory instance configuration 

ServerRoot/slapd-ServerID/config/schema

instance-path/config/schema

Directory instance schema 

ServerRoot/slapd-ServerID/db

instance-path/db

Directory instance databases 

ServerRoot/slapd-ServerID/ldif

instance-path/ds6/bin/ldif

Sample LDIF files 

ServerRoot/slapd-ServerID/locks

instance-path/locks

Run time process locks 

ServerRoot/slapd-ServerID/logs

instance-path/logs

Server instance log files 

ServerRoot/slapd-ServerID/tmp

instance-path/tmp

Run time temporary files