Installation guide

entries, possibly even entire directory trees, that were valid in Directory Server 8.0 or 8.1 are invalid and

rejected in Red Hat Directory Server 8.2.

As part of the upgrade process (setup-ds-adm in.pl -u), Directory Server runs a script to normalize

and update the DNs in existing directories so that they conform with RFC 4514. Probably the most

common change is escaping characters like quotation marks and commas in cn and ou elements in DNs,

as well as some international characters. For example, replication agreement entries and other mapping

tree entries have suffixes in the DN as one of the cn elements.

In 8.1, a replication entry DN would have the suffix name contained in quotes:

dn: cn=Exam pleAgreement,cn=replica,cn="dc=example,dc=com",cn=mapping

tree,cn=config

If that same entry were created in Directory Server 8.2, there are no quotation marks are removed and

the commas are escaped:

dn: cn=Exam pleAgreement,cn=replica,cn=dc=example\,dc=com,cn=mapping

tree,cn=config

To preserve backward compatibility, migrated entries are stored with special characters encoded in the

DN and entrydn attributes but otherwise preserved. For example, for a DN which was previously

cn="a=abc,x=xyz":

/usr/lib64/m ozldap/ldapsearch -b "dc=example,dc=com " '(cn=\"* \")' entrydn

dn: cn=a\3Dabc\2Cx\3Dxyz,dc=example,dc=com

entrydn: cn=a\3dabc\2cx\3dxyz,dc=example,dc=com

cn: "a=abc,x=xyz"

The DN has the encoded value, but the CN preserves the special characters.

New entries in Directory Server 8.2 use the new DN format.

1.15. Expanded Support for Matching Rules and Attribute Syntaxes

Directory Server 8.2 introduces support for several new matching rules, so that Red Hat Directory Server

now supports almost all of the matching rules listed in RFC 4517, with the exception of the

FirstComponent matching rules.

Support was added for eleven new attribute syntaxes as well:

Numeric String

Bit String

Delivery Method

Enhanced Guide

Facsimile Telephone Number

Fax

Guide

Name and Optional UID

Printable String

Teletex T erminal Identifier

Telex Number

1. New Features in Red Hat Directory Server 8.2