From 8559d11e971746ba2afabc258f7e71b7bd0a36c1 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Tue, 16 Jul 2013 14:51:34 +0000
Subject: [PATCH] CR-2008 Fix for OPENDJ-1057: dsconfig reference does not accurately explain how 'components' of the 'OpenDJ configuration refence it refers to have to be used
---
opends/src/main/docbkx/admin-guide/man-dsconfig.xml | 63 ++++++++++++++++++++++++++++++-
1 files changed, 60 insertions(+), 3 deletions(-)
diff --git a/opends/src/main/docbkx/admin-guide/man-dsconfig.xml b/opends/src/main/docbkx/admin-guide/man-dsconfig.xml
index a3547a5..6b790e0 100644
--- a/opends/src/main/docbkx/admin-guide/man-dsconfig.xml
+++ b/opends/src/main/docbkx/admin-guide/man-dsconfig.xml
@@ -374,9 +374,66 @@
<listitem><para>set-<replaceable>component</replaceable>-prop</para></listitem>
</itemizedlist>
- <para>Component properties for the <command>dsconfig</command> command are
- covered in the <link xlink:show="new" xlink:href="${configRefBase}"
- ><citetitle>OpenDJ Configuration Reference</citetitle></link>.</para>
+ <para>Here, <replaceable>component</replaceable> names correspond to the
+ names of managed object types referred to as <link xlink:show="new"
+ xlink:href="${configRefBase}ManagedObjectList.html"><citetitle
+ >Components</citetitle></link> in the <citetitle>OpenDJ Configuration
+ Reference</citetitle>, and that have no parent components. (In other words,
+ only the names of components with no parents correspond to subcommands.)
+ Subcommand <replaceable>component</replaceable> names are lower-case,
+ hyphenated versions of the friendly names used in the <citetitle>OpenDJ
+ Configuration Reference</citetitle>. When you act on an actual configuration
+ component, you provide the name of the component as an option argument.</para>
+
+ <itemizedlist>
+ <para>For example, the Log Publisher component has these corresponding
+ subcommands.</para>
+ <listitem><para><command>create-log-publisher</command></para></listitem>
+ <listitem><para><command>list-log-publishers</command></para></listitem>
+ <listitem><para><command>delete-log-publisher</command></para></listitem>
+ <listitem><para><command>get-log-publisher-prop</command></para></listitem>
+ <listitem><para><command>set-log-publisher-prop</command></para></listitem>
+ </itemizedlist>
+
+ <para>When you create or delete Log Publisher components and when you get
+ and set their configuration properties, you provide the name of the actual
+ log publisher, which you can find by using the
+ <command>list-log-publishers</command> subcommand.</para>
+
+ <screen>$ dsconfig
+ list-log-publishers
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --trustAll
+
+Log Publisher : Type : enabled
+------------------------------:------------------------:--------
+File-Based Access Logger : file-based-access : true
+File-Based Audit Logger : file-based-audit : false
+File-Based Debug Logger : file-based-debug : false
+File-Based Error Logger : file-based-error : true
+File-Based HTTP Access Logger : file-based-http-access : false
+Replication Repair Logger : file-based-error : true
+
+$ dsconfig
+ get-log-publisher-prop
+ --publisher-name "File-Based Access Logger"
+ --property rotation-policy
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --trustAll
+Property : Value(s)
+----------------:--------------------------------------------------------------
+rotation-policy : 24 Hours Time Limit Rotation Policy, Size Limit Rotation
+ : Policy</screen>
+
+ <para>To find documentation for specific component properties, also see the
+ <link xlink:show="new" xlink:href="${configRefBase}"><citetitle>OpenDJ
+ Configuration Reference</citetitle></link>.</para>
<para>Many subcommands let you set property values. Notice in the reference
for the subcommands below that specific options are available for handling
--
Gitblit v1.10.0