chap-compatibility.xml revision 51607ea01068c9047391e4c8b46bc9dbd0edb7fd
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! CCPL HEADER START
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! This work is licensed under the Creative Commons
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! To view a copy of this license, visit
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! or send a letter to Creative Commons, 444 Castro Street,
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Suite 900, Mountain View, California, 94041, USA.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! You can also obtain a copy of the license at
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! See the License for the specific language governing permissions
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! and limitations under the License.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! If applicable, add the following below this CCPL HEADER, with the fields
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! enclosed by brackets "[]" replaced with your own identifying information:
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Portions Copyright [yyyy] [name of copyright owner]
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! CCPL HEADER END
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Copyright 2011-2013 ForgeRock AS
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xsi:schemaLocation='http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd'
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>This chapter covers both major changes to existing functionality, and
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark also deprecated and removed functionality.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>Important Changes to Existing Functionality</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>OpenDJ <?eval ${docTargetVersion}?> improves on earlier releases
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark introducing many new features. Also take the following into account.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The upgrade process and <command>upgrade</command> command have
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark changed to facilitate native packaging on more platforms. See
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <link xlink:show="new" xlink:href="install-guide#chap-upgrade"
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xlink:role="http://docbook.org/xlink/role/olink"><citetitle>Upgrading to
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark OpenDJ <?eval ${docTargetVersion}?></citetitle></link> for
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark instructions.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The default DB cache size is now 50%, rather than 10%.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>If you have multiple backends, configure cache sizes
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark accordingly.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The number of LDAP request handlers now defaults to half the CPU
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark count.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The replication purge delay default has increased from one day to
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark three days.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Syntax checking has been added for certificate and country attribute
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark values. This affects applications updating those attribute values.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark Applications updating country attribute values must now use Country String
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark syntax for example, which uses two-character codes from <link
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xlink:show="new" xlink:href="http://www.iso.org/iso/country_codes.htm">ISO
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark 3166</link> such as <literal>US</literal> instead of full names such as
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The following global ACI settings have changed.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>OpenDJ directory server now allows any client to use the LDAP
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark Permissive Modify Request control, <literal>1.2.840.113556.1.4.1413</literal>,
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark by default for newly installed servers.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The "Anonymous read access" global ACI has changed. The list of
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark attributes that are not allowed has been changed to add
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>When you upgrade from earlier versions of OpenDJ, however, the
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark previous <literal>global-aci</literal> settings are not updated. To apply
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark the changes manually, change the relevant <literal>global-aci</literal>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark settings by using the <command>dsconfig</command> command. An example of
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark how to change a <literal>global-aci</literal> property can be found in the
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <citetitle>Administration Guide</citetitle>, <link xlink:show="new"
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xlink:href="admin-guide#access-control-disable-anonymous"
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xlink:role="http://docbook.org/xlink/role/olink"><citetitle>ACI: Disable
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>For the SNMP Connection Handler, the default
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <filename>opendj-snmp.security</filename> (<link xlink:show="new"
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark xlink:href="https://bugster.forgerock.org/jira/browse/OPENDJ-982"
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark >OPENDJ-982</link>), and the upgrade process changes the file name. The
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <literal>community</literal> has also changed to <literal>OpenDJ</literal>.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark If the SNMP Connection Handler fails to start after upgrade, use the
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <command>dsconfig</command> command to make sure that the
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <literal>security-agent-file</literal> property is correctly set for your
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark installation.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark<!-- Not yet
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The <command>ldif-diff</command> command has been renamed
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <command>ldifdiff</command>, and the <option>-\-outputLDIF</option>,
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <option>-\-overwriteExisting</option>, <option>-\-sourceLDIF</option>,
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <option>-\-targetLDIF</option> options have been dropped in favor of a
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark format closer to that of the <command>diff</command> command.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </section>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>OpenDJ <?eval ${docTargetVersion}?> makes use of new environment
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark variables aligned with the project name to use <literal>OPENDJ</literal>.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark Use of the old variables is Deprecated. The old variables are likely to be
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark removed in a future release.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The <command>dsframework</command> command is Deprecated and likely
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark to be removed in a future release.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The following OpenDJ LDAP SDK methods are Deprecated and likely to be
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark removed in a future release.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem><para><literal>org.forgerock.opendj.ldap.LDAPListenerOptions#getTCPNIOTransport</literal></para></listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem><para><literal>org.forgerock.opendj.ldap.LDAPListenerOptions#setTCPNIOTransport</literal></para></listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem><para><literal>org.forgerock.opendj.ldap.LDAPOptions#getTCPNIOTransport</literal></para></listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <listitem><para><literal>org.forgerock.opendj.ldap.LDAPOptions#setTCPNIOTransport</literal></para></listitem>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </section>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Native packages in SVR4 format for Solaris are not provided at this
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark time.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </section>