<?xml version="1.0" encoding="UTF-8"?>

<chapter xml:id='chap-compatibility'

xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'

xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'

xsi:schemaLocation='http://docbook.org/ns/docbook

xmlns:xlink='http://www.w3.org/1999/xlink'>

<title>OpenDJ Compatibility</title>

<para>

This chapter covers both major changes to existing functionality,

and also deprecated and removed functionality.

</para>

<section xml:id="changed-functionality">

<title>Important Changes to Existing Functionality</title>

<para>

Take the following changes into account

when upgrading to OpenDJ ${docTargetVersion}.

</para>

<itemizedlist>

<listitem>

<para>

TODO: Update for next release

</para>

</listitem>

<listitem>

<para>

Improvements that allow OpenDJ directory server

to use alternative backends have resulted in incompatible updates

to some backup archives:

</para>

<itemizedlist>

<listitem>

<para>

Configuration, schema, and task backend backup archives now all

have backup archives named

<filename>backup-<replaceable>backend-id</replaceable>-<replaceable>backup-id</replaceable></filename>.

</para>

</listitem>

<listitem>

<para>

The backup archive content for schema backends has changed.

</para>

</listitem>

</itemizedlist>

<para>

Rather than using a backup archive with the <command>backup</command> command,

use a file system backup if you must revert an upgrade to ${docTargetVersion}.

After successful upgrade, do not restore backup archives generated

with older versions of the <command>backup</command> command.

</para>

</listitem>

<listitem>

<para>

LDAP SDK ${sdkDocTargetVersion}

<filename>makeldif.template</filename> files

are not backwards-compatible

with the OpenDJ directory server <command>make-ldif</command> command.

</para>

<para>

When specifying a branch in LDAP SDK <command>makeldif</command> templates,

you must now also specify the object classes for the branch.

Server <command>make-ldif</command> templates require branch specifications

that do not specify the object classes for the branch.

</para>

</listitem>

<listitem>

<para>The following global ACI settings have changed.</para>

<itemizedlist>

<listitem>

<para>The attribute <literal>debugsearchindex</literal> has also been

added to the list of attributes that are not allowed in the "Anonymous

read access" global ACI.</para>

</listitem>

</itemizedlist>

<para>

When you upgrade from earlier versions of OpenDJ, however,

the previous <literal>global-aci</literal> settings are not updated.

To apply the changes manually,

change the relevant <literal>global-aci</literal> settings

by using the <command>dsconfig</command> command.

An example of how to change a <literal>global-aci</literal> property

can be found in the <citetitle>Administration Guide</citetitle> section,

<link

xlink:show="new"

xlink:href="admin-guide#access-control-disable-anonymous"

xlink:role="http://docbook.org/xlink/role/olink"

><citetitle>ACI: Disable Anonymous Access</citetitle></link>.

</para>

</listitem>

</itemizedlist>

</section>

<section xml:id="deprecated-functionality">

<title>Deprecated Functionality</title>

<para>

TODO: Update for next release

</para>

</section>

<section xml:id="removed-functionality">

<title>Removed Functionality</title>

<para>

TODO: Update for next release

</para>

<para>

Native packages in SVR4 format for Solaris are not provided at this time.

</para>

</section>

</chapter>