Author: fmeschbe
Date: Sat May 19 17:17:04 2012
New Revision: 1340518
URL: http://svn.apache.org/viewvc?rev=1340518&view=rev
Log:
SLING-2002 some more properties
Modified:
sling/site/trunk/content/the-sling-engine/sling-properties.mdtext
Modified: sling/site/trunk/content/the-sling-engine/sling-properties.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/the-sling-engine/sling-properties.mdtext?rev=1340518&r1=1340517&r2=1340518&view=diff
==============================================================================
--- sling/site/trunk/content/the-sling-engine/sling-properties.mdtext (original)
+++ sling/site/trunk/content/the-sling-engine/sling-properties.mdtext Sat May
19 17:17:04 2012
@@ -2,15 +2,44 @@
This table lists properties which have known functionality in the OSGi and
Sling frameworks.
-| Property | Default Value | Description | Owner |
-|-|-|-|
+With the exception of the Sling setup properties (`sling.home`,
`sling.launchpad`, and `sling.properties`) all properties can be set on the
command line using the `-D` command line option or in the `sling.properties`
file. Properties defined on the command line or in the `web.xml` file always
overwrite properties in the `sling.properties` file.
+
+## Sling Setup Properties
+
+| Property | Default Value | Description |
+|---|---|---|
| `sling.home` | `sling` | Path to the main Sling Directory; relative path is
resolved against current working directory as defined in the `user.dir` system
property. Can also be set with the `-c` command line option. | Launchpad |
| `sling.launchpad` | `${sling.home}` | Location for the Sling launchpad JAR
file and the startup folder containing bundles to be installed by the Bootstrap
Installer. Can also be set with the `-i` command line option. | Launchpad |
| `sling.properties` | `${sling.home}/sling.properties` | Path to the
`sling.properties` file; relative path is resolved against `${sling.home}` |
Launchpad |
-| `sling.control.socket` | `c` | Specification of the control port. Can also
be set with the `-j` command line option. This property is only used by the
Standalone Sling Application. | Launchpad |
+
+## Server Control Port Properties
+
+| Property | Default Value | Description |
+|---|---|---|
+| `sling.control.socket` | `127.0.0.1:0` | Specification of the control port.
Can also be set with the `-j` command line option. This property is only used
by the Standalone Sling Application. | Launchpad |
| `sling.control.action` | -- | Action to execute. This is the same as
specifying `start`, `status`, or `stop` on the command line. This property is
only used by the Standalone Sling Application. | Launchpad |
-| `org.apache.felix.http.context_path` | `/` | The servlet context path for
the Http Service of the embedded servlet container. This property requires
support by the Http Service bundle. | Http Service Bundle |
-| `org.apache.felix.http.host` | `0.0.0.0` | The host interface to bind the
HTTP Server to. This property requires support by the Http Service bundle. |
Http Service Bundle |
-| `org.osgi.service.http.port` | 8080 | The port to listen on for HTTP
requests. This property requires support by the Http Service bundle. | Http
Service Bundle |
-With the exception of the first three properties (`sling.home`,
`sling.launchpad`, and `sling.properties`) all properties can be set on the
command line using the `-D` command line option or in the actual
`sling.properties` file.
\ No newline at end of file
+## Logging Configuration
+
+Logging configuration defined by these properties sets up initial
configuration for the Sling Commons Log bundle. This configuration is used as
long as there is no configuration from the Configuration Admin Service for the
service PID `org.apache.sling.commons.log.LogManager`.
+
+| Property | Default Value | Description |
+|---|---|---|
+| `org.apache.sling.commons.log.level` | `INFO` | Sets the initial logging
level of the root logger. This may be any of the defined logging levels
`DEBUG`, `INFO`, `WARN`, or `ERROR`. This property can also be set with the
`-l` command line option. |
+| `org.apache.sling.commons.log.file` | `${sling.home}/logs/error.log` | Sets
the log file to which log messages are written. If this property is empty or
missing, log messages are written to System.out. This property can also be set
with the `-f` command line option. |
+| `org.apache.sling.commons.log.file.number` | `5` | The number of rotated
files to keep. |
+| `org.apache.sling.commons.log.file.size` | `'.'yyyy-MM-dd` | Defines how the
log file is rotated (by schedule or by size) and when to rotate. See the
section [Log File
Rotation](http://sling.apache.org/site/logging.html#Logging-LogFileRotation)
for full details on log file rotation. |
+| `org.apache.sling.commons.log.pattern` | `{0,date,dd.MM.yyyy HH:mm:ss.SSS}
*{4}* [{2}] {3} {5}` | The MessageFormat pattern to use for formatting log
messages with the root logger. |
+| org.apache.sling.commons.log.julenabled | `false` | Enables the
java.util.logging support. |
+
+See [Logging](http://sling.apache.org/site/logging.html) for full information
on configuring the Sling Logging system.
+
+
+## Http Service Properties
+
+| Property | Default Value | Description |
+|---|---|---|
+| `org.apache.felix.http.context_path` | `/` | The servlet context path for
the Http Service of the embedded servlet container. This property requires
support by the Http Service bundle. |
+| `org.apache.felix.http.host` | `0.0.0.0` | The host interface to bind the
HTTP Server to. This property requires support by the Http Service bundle. |
+| `org.osgi.service.http.port` | 8080 | The port to listen on for HTTP
requests. This property requires support by the Http Service bundle. |
+
