mirror of https://github.com/OpenIdentityPlatform/OpenDJ.git

Mark Craig
10.28.2013 695493c1ac74e69eeb6315a6a1cada566b304421
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<?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>