From 1995c9abe63e16ae4ed2a2446c09c12c8e4aa944 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Fri, 28 Aug 2015 11:56:21 +0000
Subject: [PATCH] OPENDJ-2255 Initial self-edit of the admin guide
---
docs/src/main/docbkx/admin-guide/preface.xml | 210 +++++++++++++++++++++++++++++++++++++++++++++++-----
1 files changed, 190 insertions(+), 20 deletions(-)
diff --git a/docs/src/main/docbkx/admin-guide/preface.xml b/docs/src/main/docbkx/admin-guide/preface.xml
index 903d22c..a1fa712 100644
--- a/docs/src/main/docbkx/admin-guide/preface.xml
+++ b/docs/src/main/docbkx/admin-guide/preface.xml
@@ -30,31 +30,201 @@
xmlns:xinclude='http://www.w3.org/2001/XInclude'>
<title>Preface</title>
- <para>This guide shows you how to configure, maintain, and troubleshoot
- OpenDJ directory services. This guide also describes file layouts, ports
- used, and standards, controls, extended operations, and languages supported
- for OpenDJ installations.</para>
+ <para>
+ This guide shows you how to configure, maintain, and troubleshoot
+ OpenDJ directory services.
+ OpenDJ directory services allow applications to access directory data
+ using Lightweight Directory Access Protocol (LDAP),
+ using Directory Services Markup Language (DSML)
+ over Hypertext Transfer Protocol (HTTP),
+ or using HTTP methods in the Representational State Transfer (REST) style.
+ </para>
+
+ <itemizedlist>
+ <para>
+ In reading and following the instructions in this guide, you will learn how to:
+ </para>
+
+ <listitem>
+ <para>
+ Use OpenDJ administration tools
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Manage OpenDJ server processes
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Import, export, backup, and restore directory data
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Configure OpenDJ server connection handlers for all supported protocols
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Configure administrative privileges and fine-grained access control
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Index directory data, manage schemas for directory data,
+ and enforce uniqueness of directory data attribute values
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Configure data replication between OpenDJ directory servers
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Implement password policies, pass through authentication to another directory,
+ password synchronization with Samba, account lockout, and account status notification
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Set resource limits to prevent unfair use of directory server resources
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Monitor directory servers through logs and alerts and over JMX
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Tune directory servers for best performance
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Secure directory server deployments
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Change directory server key pairs and public key certificates
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Move a directory server to a different system
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Troubleshoot directory server issues
+ </para>
+ </listitem>
+ </itemizedlist>
<section>
- <title>Who Should Read this Guide</title>
+ <title>Using This Guide</title>
- <para>This guide is written for directory integrators and administrators who
- build, deploy, and maintain OpenDJ directory services for your
- organizations.</para>
+ <para>
+ This guide is intended for system administrators
+ who build, deploy, and maintain OpenDJ directory services
+ for their organizations.
+ </para>
- <para>This guide starts by introducing the OpenDJ administrative interfaces
- and tools, and by showing how to manage OpenDJ server processes. It also
- demonstrates how to import and export directory data. This guide continues
- by showing how to configure and monitor the principle features of individual
- OpenDJ servers, and how to configure and monitor replicated server
- topologies for distributed high availability. It then demonstrates how to
- tune, troubleshoot, and move servers.</para>
+ <itemizedlist>
+ <para>
+ This guide starts with an introduction to directory services.
+ The rest of this guide is written with the assumption
+ that you have basic familiarity with the following topics:
+ </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>
+ <listitem>
+ <para>
+ The client-server model of distributed computing
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Lightweight Directory Access Protocol (LDAP),
+ including how clients and servers exchange messages
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Managing Java-based services on operating systems and application servers
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Using command-line tools and reading command-line examples
+ written for UNIX/Linux systems
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Configuring network connections on operating systems
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Managing Public Key Infrastructure (PKI) used to establish secure connections
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <itemizedlist>
+ <para>
+ Depending on the features you use, you should also have basic familiarity
+ with the following topics:
+ </para>
+
+ <listitem>
+ <para>
+ Directory Services Markup Language (DSML),
+ including how clients and servers exchange messages
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Hypertext Transfer Protocol (HTTP),
+ including how clients and servers exchange messages
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Java Management Extensions (JMX) for monitoring services
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Simple Network Management Protocol (SNMP) for monitoring services
+ </para>
+ </listitem>
+ </itemizedlist>
</section>
<xinclude:include href="../shared/sec-formatting-conventions.xml" />
--
Gitblit v1.10.0