<?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
! http://creativecommons.org/licenses/by-nc-nd/3.0/
! 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
! trunk/opendj3/legal-notices/CC-BY-NC-ND.txt.
! 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
!
-->
<preface xml:id='preface'
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 http://docbook.org/xml/5.0/xsd/docbook.xsd'
xmlns:xlink='http://www.w3.org/1999/xlink'
xmlns:xinclude='http://www.w3.org/2001/XInclude'>
<title>Preface</title>
<para>This guide shows you how to install, upgrade, and remove OpenDJ
software. Unless you are planning a throwaway evaluation or test
installation, read the <link xlink:href="release-notes#release-notes"
xlink:role="http://docbook.org/xlink/role/olink"><citetitle>Release
Notes</citetitle></link> before you get started.</para>
<para>If you want only to try OpenDJ server software, and you
do not plan to store any real or important data that you want to keep,
then you need not read this entire guide. Instead, try <link
xlink:href="install-guide#chap-install-gui"
xlink:role="http://docbook.org/xlink/role/olink"><citetitle>Installing OpenDJ
With the QuickSetup Wizard</citetitle></link>.</para>
<section>
<title>Who Should Read this Guide</title>
<para>This guide is written for anyone installing OpenDJ who plans to
maintain directory services for client applications. Basic OpenDJ
installation, especially using Java WebStart, can be simple and
straightforward, particularly if you are already acquainted with directory
services. Upgrading a running directory service without a single point of
failure that can cause downtime requires at least a little thought
and planning. Also, even in the case of basic installation, you may
find yourself wanting more background about what you are doing.</para>
<para>This guide covers the install, upgrade, and removal (a.k.a. uninstall)
procedures that you theoretically perform only once per version. This guide
aims to provide you with at least some idea of what happens behind the
scenes when you perform the steps.</para>
<para>You do not need to be an LDAP wizard to learn something from this
guide, though a background in directory services and maintaining server
software can help. You do need some background in managing servers and
services on your operating system of choice. You can nevertheless get
started with this guide, and then learn more as you go along.</para>
</section>
<xinclude:include href="/shared/sec-formatting-conventions.xml" />
<xinclude:include href="/shared/sec-accessing-doc-online.xml" />
<xinclude:include href="/shared/sec-joining-the-community.xml" />
</preface>