You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by pa...@apache.org on 2012/10/31 16:15:16 UTC
svn commit: r1404192 - in /directory/site/trunk/content/apacheds/basic-ug:
1.4.3-adding-partition.mdtext 1.4.4-configure-logging.mdtext
Author: pamarcelot
Date: Wed Oct 31 15:15:16 2012
New Revision: 1404192
URL: http://svn.apache.org/viewvc?rev=1404192&view=rev
Log:
Converted tables from HTML to Markdown.
Modified:
directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext
directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext
Modified: directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext?rev=1404192&r1=1404191&r2=1404192&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext Wed Oct 31 15:15:16 2012
@@ -46,7 +46,7 @@ For the examples in the following sectio
and select the _Partitions_ tab :
-
+
Add another jdbmPartition element for the sevenSeas partition, just below the _example_ partition:
@@ -117,52 +117,11 @@ Here is the sample code to create a new
Here is a list of the used attributes, their default values and meaning :
-<div class="table-wrap">
- <table class="confluenceTable">
- <tbody>
- <tr>
- <th class="confluenceTh"> Property </th>
- <th class="confluenceTh"> Description </th>
- <th class="confluenceTh"> Default value </th>
- <th class="confluenceTh"> Required </th>
- </tr>
- <tr>
- <td class="confluenceTd"> ads-partitionId </td>
- <td class="confluenceTd"> uniquely identifies the partition </td>
- <td class="confluenceTd"> N/A </td>
- <td class="confluenceTd"> yes </td>
- </tr>
- <tr>
- <td class="confluenceTd"> ads-partitionSuffix </td>
- <td class="confluenceTd"> a DN ("dc=example, dc=com", for instance) </td>
- <td class="confluenceTd"> N/A </td>
- <td class="confluenceTd"> yes </td>
- </tr>
- <tr>
- <td class="confluenceTd"> ads-contextEntry </td>
- <td class="confluenceTd"> The context entry </td>
- <td class="confluenceTd"> Will be automatically deduced <br/>
- if no value is provided </td>
- <td class="confluenceTd"> no </td>
- </tr>
- <tr>
- <td class="confluenceTd"> optimizerEnabled </td>
- <td class="confluenceTd"> Tells the server to turn on the optimizer</td>
- <td class="confluenceTd"> true </td>
- <td class="confluenceTd"> no </td>
- </tr>
- <tr>
- <td class="confluenceTd"> ads-partitionCacheSize </td>
- <td class="confluenceTd"> The cache size (only for JDBM partitions) </td>
- <td class="confluenceTd"> -1 (no cache) </td>
- <td class="confluenceTd"> no </td>
- </tr>
- <tr>
- <td class="confluenceTd"> ads-partitionSyncOnWrite </td>
- <td class="confluenceTd"> sync disks on every write operation </td>
- <td class="confluenceTd"> true </td>
- <td class="confluenceTd"> no </td>
- </tr>
- </tbody>
- </table>
-</div>
+| Property | Description | Default Value | Required |
+|:-:|:-:|:-:|:-:|
+| ads-partitionId | Uniquely identifies the partition | N/A | yes |
+| ads-partitionSuffix | A DN ("dc=example, dc=com", for instance | N/A | yes |
+| ads-contextEntry | The context entry | Will be automatically deduced if no value is provided | no |
+| ads-optimizerEnabled | Tells the server to turn on the optimizer | true | no |
+| ads-partitionCacheSize | The cache size (only for JDBM partitions) | -1 (no cache) | no |
+| ads-partitionSyncOnWrite | Syncs disks on every write operation | true | no |
Modified: directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext?rev=1404192&r1=1404191&r2=1404192&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext Wed Oct 31 15:15:16 2012
@@ -64,37 +64,12 @@ The name of the _RollingFileAppender_ is
In this file "R" is configured like this:
-<div class="table-wrap">
- <table class="confluenceTable">
- <tbody>
- <tr>
- <th class="confluenceTh"> Property name </th>
- <th class="confluenceTh"> Value in file above </th>
- <th class="confluenceTh"> Meaning </th>
- </tr>
- <tr>
- <td class="confluenceTd"> File </td>
- <td class="confluenceTd"> apacheds-rolling.log </td>
- <td class="confluenceTd"> path to the output log file, in our case relative to <em>var/log</em> </td>
- </tr>
- <tr>
- <td class="confluenceTd"> MaxFileSize </td>
- <td class="confluenceTd"> 1024KB </td>
- <td class="confluenceTd"> maximum size that the output file is allowed to reach before being rolled over to backup files </td>
- </tr>
- <tr>
- <td class="confluenceTd"> MaxBackupIndex </td>
- <td class="confluenceTd"> 5 </td>
- <td class="confluenceTd"> number of backup files kept </td>
- </tr>
- <tr>
- <td class="confluenceTd"> layout.ConversionPattern </td>
- <td class="confluenceTd"> [%d{HH:mm:ss}] %p [%c] - %m%n </td>
- <td class="confluenceTd"> format string for logging events </td>
- </tr>
- </tbody>
- </table>
-</div>
+| Property name | Value in file above | Meaning |
+|:-:|:-:|---|
+| File | apacheds-rolling.log | Path to the output log file, in our case relative to _var/log_ |
+| MaxFileSize | 1024KB | Maximum size that the output file is allowed to reach before being rolled over to backup files |
+| MaxBackupIndex | 5 | Number of backup files kept |
+| layout.ConversionPattern | [%d{HH:mm:ss}] %p [%c] - %m%n | Format string for logging events |
If the default logging does not meet your requirements, you can easily adjust the configuration to your needs.
@@ -122,36 +97,13 @@ On Windows you can use the configuration
The following log levels from log4j are used for messages within ApacheDS:
-<div class="table-wrap">
- <table class="confluenceTable">
- <tbody>
- <tr>
- <th class="confluenceTh"> Level </th>
- <th class="confluenceTh"> Description from log4j documentation </th>
- </tr>
- <tr>
- <td class="confluenceTd"> DEBUG </td>
- <td class="confluenceTd"> designates fine-grained informational events that are most useful to debug an application </td>
- </tr>
- <tr>
- <td class="confluenceTd"> INFO</td>
- <td class="confluenceTd"> designates informational messages that highlight the progress of the application at coarse-grained level </td>
- </tr>
- <tr>
- <td class="confluenceTd"> WARN</td>
- <td class="confluenceTd"> designates potentially harmful situations </td>
- </tr>
- <tr>
- <td class="confluenceTd"> ERROR</td>
- <td class="confluenceTd"> designates error events that might still allow the application to continue running </td>
- </tr>
- <tr>
- <td class="confluenceTd"> FATAL </td>
- <td class="confluenceTd"> designates very severe error events that will presumably lead the application to abort </td>
- </tr>
- </tbody>
- </table>
-</div>
+| Level | Description from log4j documentation |
+|:-:|---|
+| DEBUG | Designates fine-grained informational events that are most useful to debug an application |
+| INFO | Designates informational messages that highlight the progress of the application at coarse-grained level |
+| WARN | Designates potentially harmful situations |
+| ERROR | Designates error events that might still allow the application to continue running |
+| FATAL | Designates very severe error events that will presumably lead the application to abort |
The default (global) log level in the configuration is _WARN_. All messages of level WARN and more severe (ERROR, FATAL) are written to the rolling log file. The easiest way to get finer log messages is to change it like this
@@ -194,36 +146,13 @@ Some examples lines within the log file,
The pattern uses the following conversion characters:
-<div class="table-wrap">
- <table class="confluenceTable">
- <tbody>
- <tr>
- <th class="confluenceTh"> Character </th>
- <th class="confluenceTh"> Outputs </th>
- </tr>
- <tr>
- <td class="confluenceTd"> %d </td>
- <td class="confluenceTd"> date of the logging event in the given format. like "12:29:05" for %d{HH:mm:ss} </td>
- </tr>
- <tr>
- <td class="confluenceTd"> %p </td>
- <td class="confluenceTd"> priority (level) of the logging event, like "INFO" or "WARN" </td>
- </tr>
- <tr>
- <td class="confluenceTd"> %c </td>
- <td class="confluenceTd"> category of the logging event, like "org.apache.directory.server.Service" </td>
- </tr>
- <tr>
- <td class="confluenceTd"> %m </td>
- <td class="confluenceTd"> application supplied message associated with the logging event </td>
- </tr>
- <tr>
- <td class="confluenceTd"> %n </td>
- <td class="confluenceTd"> platform dependent line separator </td>
- </tr>
- </tbody>
- </table>
-</div>
+| Character | Output |
+|:-:|---|
+| %d | Date of the logging event in the given format. like "12:29:05" for %d{HH:mm:ss} |
+| %p | Priority (level) of the logging event, like "INFO" or "WARN" |
+| %c | Category of the logging event, like "org.apache.directory.server.Service" |
+| %m | Application supplied message associated with the logging event |
+| %n | Platform dependent line separator |
The [javadoc of log4j](http://logging.apache.org/log4j/docs/api/org/apache/log4j/PatternLayout.html) contains a table with all valid %-characters and their meaning.