[CONF] Apache Jackrabbit: Jackrabbit Standalone (page created)

[co...@apache.org]

Jackrabbit Standalone (JCR) created by Jukka Zitting
   http://cwiki.apache.org/confluence/display/JCR/Jackrabbit+Standalone

Content:
---------------------------------------------------------------------

The Jackrabbit Standalone component is a runnable jar that contains everything you need to run Jackrabbit as a standalone server process. The server manages a Jackrabbit content repository and makes it available to clients via [WebDAV|Jackrabbit JCR Server] and [RMI|Jackrabbit JCR-RMI]. You can download the standalone server jar from the [Downloads] page.

h2. Running the standalone server

You only need the version 1.4 or higher of the Java Runtime Environment (JRE) to run the Jackrabbit standalone server. To start the server, simply double-click on the standalone jar file, or invoke it on the command line like this:

{code:sh}
$ java -jar jackrabbit-standalone-1.5.0.jar
Welcome to Apache Jackrabbit!
-------------------------------
Using repository directory jackrabbit
Writing log messages to jackrabbit/log
Starting the server...
Apache Jackrabbit is now running at http://localhost:8080/
^C
Shutting down the server...
-------------------------------
Goodbye from Apache Jackrabbit!
{code}

By default the server will look for a content repository in the {{./jackrabbit}} directory and a repository configuration file in a {{repository.xml}} file within the repository directory. The repository directory is automatically created if it does not already exist, and a configuration file with the default configuration is created if no configuration is found.

Server, access, and repository log messages are written to log files in the {{log}} subdirectory within the repository repository directory.

You can stop the server by pressing Ctrl-C or by sending it a standard termination signal. The server will then shutdown the content repository and exit cleanly.

h2. Command line options

You can customize the operation of the standalone server with the following command line options (with defaults in parenthesis):

{code:sh}
$ java -jar jackrabbit-standalone-1.5.0.jar --help
usage: java -jar jackrabbit-standalone-1.5.0-SNAPSHOT.jar [-?] [-c <arg>]
       [-d] [-f <arg>] [-h <arg>] [-l] [-n] [-p <arg>] [-q] [-r <arg>]
 -?,--help         print this message
 -c,--conf <arg>   repository configuration file
 -d,--debug        enable debug logging
 -f,--file <arg>   location of this jar file
 -h,--host <arg>   IP address of the HTTP server
 -l,--license      print license information
 -n,--notice       print copyright notices
 -p,--port <arg>   TCP port of the HTTP server (8080)
 -q,--quiet        disable console output
 -r,--repo <arg>   repository directory (jackrabbit)
{code}

h2. Drawbacks

The Jackrabbit Standalone server is designed primarily as a quick and easy way to get a content repository up and running for testing and development purposes. For more complex deployment scenarios and configuration options you should look at the [Jackrabbit Web Application] and [Jackrabbit JCA Resource Adapter] packages.

Note also that JCR-RMI layer has not been optimized for performance, so currently the recommendation for accessing the JCR API in performance critical applications is to have the repository running locally in the same process as the client application.


---------------------------------------------------------------------
CONFLUENCE INFORMATION
This message is automatically generated by Confluence

Unsubscribe or edit your notifications preferences
   http://cwiki.apache.org/confluence/users/viewnotifications.action

If you think it was sent incorrectly contact one of the administrators
   http://cwiki.apache.org/confluence/administrators.action

If you want more information on Confluence, or have a bug to report see
   http://www.atlassian.com/software/confluence