<?xml version="1.0" encoding="UTF-8"?>
<!--
! CCPL HEADER START
!
! This work is licensed under the Creative Commons
! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
! To view a copy of this license, visit
! or send a letter to Creative Commons, 444 Castro Street,
! Suite 900, Mountain View, California, 94041, USA.
!
! You can also obtain a copy of the license at
! See the License for the specific language governing permissions
! and limitations under the License.
!
! If applicable, add the following below this CCPL HEADER, with the fields
! enclosed by brackets "[]" replaced with your own identifying information:
! Portions Copyright [yyyy] [name of copyright owner]
!
! CCPL HEADER END
!
! Copyright 2011-2013 ForgeRock AS
!
-->
<chapter xml:id='chap-compatibility'
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>
LDAP SDK ${sdkDocTargetVersion}
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>
<!-- Not yet
<para>The <command>ldif-diff</command> command has been renamed
<command>ldifdiff</command>, and the <option>-\-outputLDIF</option>,
<option>-\-overwriteExisting</option>, <option>-\-sourceLDIF</option>,
<option>-\-targetLDIF</option> options have been dropped in favor of a
format closer to that of the <command>diff</command> command.</para>
-->
</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>