From 48e7d13b50b57c71eff6b3ca7b471e6346501675 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Tue, 28 May 2013 07:00:50 +0000
Subject: [PATCH] Fix for OPENDJ-944: Mention the need to enable HTTP log handler
---
opendj3/src/main/docbkx/admin-guide/chap-listeners.xml | 43 ++++++++++++++++++++++++++++++++++++-------
1 files changed, 36 insertions(+), 7 deletions(-)
diff --git a/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml b/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
index 437564f..ec841ef 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
@@ -24,11 +24,11 @@
!
-->
<chapter xml:id='chap-listeners'
- 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'>
+ 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'
+ >
<title>Configuring Servers For Client Application Access</title>
<indexterm><primary>Ports</primary><secondary>Configuring</secondary></indexterm>
<para>This chapter shows you how to configure OpenDJ directory server to
@@ -858,7 +858,9 @@
configuration is described in the appendix, <link xlink:show="new"
xlink:href="admin-guide#appendix-rest2ldap"
xlink:role="http://docbook.org/xlink/role/olink"><citetitle>REST LDAP
- Configuration</citetitle></link>.</para>
+ Configuration</citetitle></link>. The default mapping works out of the box
+ with default Example.com data and with <link xlink:show="new"
+ xlink:href="http://opendj.forgerock.org/Example.ldif">Example.ldif</link>.</para>
<step>
<para>Enable the connection handler.</para>
@@ -873,11 +875,38 @@
--set enabled:true
--no-prompt
--trustAll</screen>
+ </step>
+
+ <step>
+ <para>Enable the HTTP access log.</para>
+
+ <screen>$ dsconfig
+ set-log-publisher-prop
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --publisher-name "File-Based HTTP Access Logger"
+ --set enabled:true
+ --no-prompt
+ --trustAll</screen>
+
+ <para>This enables the HTTP access log,
+ <filename>opendj/logs/http-access</filename>. For details on the
+ format of the HTTP access log, see the section on <link xlink:show="new"
+ xlink:href="admin-guide#logging"
+ xlink:role="http://docbook.org/xlink/role/olink"><citetitle>Server
+ Logs</citetitle></link>.</para>
+ </step>
+
+ <step performance="optional">
+ <para>Try reading a resource.</para>
<para>The HTTP connection handler paths start by default at the root
context, as shown in the following example.</para>
- <screen>$ curl http://opendj.example.com:8080/users/bjensen?_prettyPrint=true
+ <screen>$ curl http://bjensen:hifalutin@opendj.example.com:8080/users/bjensen
+ ?_prettyPrint=true
{
"_rev" : "00000000315fb731",
"schemas" : [ "urn:scim:schemas:core:1.0" ],
--
Gitblit v1.10.0