Repository Configuration

The base repository configuration through a number of XML files.

Introduction

The repository configuration file is an XML file that specifies the components and configuration of the content repository. Hippo Repository by default ships with a repository.xml configuration file. You only need to know about this configuration file if you need a non-default PersistenceManager, AccessManager, LoginModule or SearchIndex.

The standard repository configuration for Jackrabbit can be found at http://jackrabbit.apache.org/jackrabbit-configuration.html. This page refers to that page for parts that are the same, and elaborates on those parts that are specific for Hippo Repository.

The repository configuration file consists of:

The configuration file has the following overall outline:

<Repository> <FileSystem class="...">...</FileSystem> <Security> <AccessManager class="...">...</AccessManager> [ <LoginModule class="...">...</LoginModule> ] </Security> <Workspaces rootPath="..." defaultWorkspace="..."/> <Workspace name="..."> <FileSystem class="...">...</FileSystem> <PersistenceManager class="...">...</PersistenceManager> [ <SearchIndex class="..."> ... [ <FileSystem class="...">...</FileSystem> ] </SearchIndex> ] </Workspace> <Versioning rootPath="..."> <FileSystem class="...">...</FileSystem> <PersistenceManager class="...">...</PersistenceManager> </Versioning> </Repository>

The XML attribute values in the configuration file are interpreted as plain strings except for a few special variables, namely ${rep.home}, ${wsp.name} and ${wsp.home}.

See the Jackrabbit documentation for more information.

FileSystem element

The virtual file system used by the repository to persist global state such as registered namespaces, custom node types, etc.

See the Jackrabbit documentation for more information.

Security element

The Security element specifies the name of the app-entry in the JAAS configuration and the access manager. Hippo Repository by default uses the following configuration:

<Security appName="Jackrabbit"> <AccessManager class="org.hippoecm.repository.security.SimpleAccessManager"> </AccessManager> <LoginModule class="org.hippoecm.repository.security.HippoLoginModule"> <param name="anonymousId" value="anonymous"/> </LoginModule> </Security>

SimpleAccessManager is the Hippo Repository default access manager implementation, and HippoLoginModule the default login implementation.

See Authentication and Users for more information.

Workspaces element

Configures the location of the workspaces root directory and the name of the default workspace.

<Workspaces rootPath="${rep.home}/workspaces" defaultWorkspace="default"/>

Workspace element

The Workspace element is used as a template for separate workspace configuration files created for each new workspace.

See Workspace configuration for more information.

SearchIndex element

Search index for content that is shared repository wide (/jcr:system tree, contains mainly versions).

See Search Index configuration for more information.

Versioning element

Used for configuring versioning related settings. Versioning is not yet implemented.

Hippo Europe: +31 (0)20 5224466
Hippo North America: +1 (707) 773-4646