<?xml version="1.0" encoding="UTF-8"?>
|
<!--
|
! CDDL HEADER START
|
!
|
! The contents of this file are subject to the terms of the
|
! Common Development and Distribution License, Version 1.0 only
|
! (the "License"). You may not use this file except in compliance
|
! with the License.
|
!
|
! You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
|
! or http://forgerock.org/license/CDDLv1.0.html.
|
! See the License for the specific language governing permissions
|
! and limitations under the License.
|
!
|
! When distributing Covered Code, include this CDDL HEADER in each
|
! file and include the License file at legal-notices/CDDLv1_0.txt.
|
! If applicable, add the following below this CDDL HEADER, with the
|
! fields enclosed by brackets "[]" replaced with your own identifying
|
! information:
|
! Portions Copyright [yyyy] [name of copyright owner]
|
!
|
! CDDL HEADER END
|
!
|
!
|
! Copyright 2014-2015 ForgeRock AS.
|
! -->
|
<adm:managed-object name="persistit-backend"
|
plural-name="persistit-backends" package="org.opends.server.admin.std"
|
extends="pluggable-backend" xmlns:adm="http://www.opends.org/admin"
|
xmlns:ldap="http://www.opends.org/admin-ldap"
|
xmlns:cli="http://www.opends.org/admin-cli">
|
<adm:synopsis>
|
A <adm:user-friendly-name/> stores application
|
data in a Persistit database.
|
</adm:synopsis>
|
<adm:profile name="ldap">
|
<ldap:object-class>
|
<ldap:name>ds-cfg-persistit-backend</ldap:name>
|
<ldap:superior>ds-cfg-pluggable-backend</ldap:superior>
|
</ldap:object-class>
|
</adm:profile>
|
<adm:property-override name="java-class" advanced="true">
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>
|
org.opends.server.backends.persistit.PitBackend
|
</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
</adm:property-override>
|
<adm:property name="db-directory" mandatory="true">
|
<adm:TODO>Default this to the db/backend-id</adm:TODO>
|
<adm:synopsis>
|
Specifies the path to the filesystem directory that is used
|
to hold the Persistit database files containing the
|
data for this backend.
|
</adm:synopsis>
|
<adm:description>
|
The path may be either an absolute path or a path relative to the
|
directory containing the base of the <adm:product-name /> directory server
|
installation. The path may be any valid directory path in which
|
the server has appropriate permissions to read and write files and
|
has sufficient space to hold the database contents.
|
</adm:description>
|
<adm:requires-admin-action>
|
<adm:component-restart />
|
</adm:requires-admin-action>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>db</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-directory</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-directory-permissions" advanced="true">
|
<adm:synopsis>
|
Specifies the permissions that should be applied to the directory
|
containing the server database files.
|
</adm:synopsis>
|
<adm:description>
|
They should be expressed as three-digit octal values, which is the
|
traditional representation for UNIX file permissions. The three
|
digits represent the permissions that are available for the
|
directory's owner, group members, and other users (in that order),
|
and each digit is the octal representation of the read, write, and
|
execute bits. Note that this only impacts permissions on the
|
database directory and not on the files written into that
|
directory. On UNIX systems, the user's umask controls
|
permissions given to the database files.
|
</adm:description>
|
<adm:requires-admin-action>
|
<adm:server-restart />
|
</adm:requires-admin-action>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>700</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string>
|
<adm:pattern>
|
<adm:regex>^7[0-7][0-7]$</adm:regex>
|
<adm:usage>MODE</adm:usage>
|
<adm:synopsis>
|
Any octal value between 700 and 777 (the owner must always
|
have read, write, and execute permissions on the directory).
|
</adm:synopsis>
|
</adm:pattern>
|
</adm:string>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-directory-permissions</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-cache-percent">
|
<adm:synopsis>
|
Specifies the percentage of JVM memory to allocate to the database cache.
|
</adm:synopsis>
|
<adm:description>
|
Specifies the percentage of memory available to the JVM that
|
should be used for caching database contents. Note that this is
|
only used if the value of the db-cache-size property is set to
|
"0 MB". Otherwise, the value of that property is used instead
|
to control the cache size configuration.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>50</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer lower-limit="1" upper-limit="90" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-cache-percent</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-cache-size">
|
<adm:synopsis>
|
The amount of JVM memory to allocate to the database cache.
|
</adm:synopsis>
|
<adm:description>
|
Specifies the amount of memory that should be used for caching
|
database contents. A value of "0 MB" indicates that the
|
db-cache-percent property should be used instead to specify the
|
cache size.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>0 MB</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:size lower-limit="0 MB" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-cache-size</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-txn-no-sync" advanced="true">
|
<adm:synopsis>
|
Indicates whether database writes should be primarily written to
|
an internal buffer but not immediately written to disk.
|
</adm:synopsis>
|
<adm:description>
|
Setting the value of this configuration attribute to "true" may
|
improve write performance but could cause the most
|
recent changes to be lost if the <adm:product-name /> directory server or the
|
underlying JVM exits abnormally, or if an OS or hardware failure
|
occurs (a behavior similar to running with transaction durability
|
disabled in the Sun Java System Directory Server).
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>true</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:boolean />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-txn-no-sync</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="disk-low-threshold" advanced="true">
|
<adm:synopsis>
|
Low disk threshold to limit database updates
|
</adm:synopsis>
|
<adm:description>
|
Specifies the "low" free space on the disk. When the available
|
free space on the disk used by this database instance falls below the
|
value specified, protocol updates on this database are permitted only
|
by a user with the BYPASS_LOCKDOWN privilege.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>200 megabytes</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:size lower-limit="0" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-disk-low-threshold</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="disk-full-threshold" advanced="true">
|
<adm:synopsis>
|
Full disk threshold to limit database updates
|
</adm:synopsis>
|
<adm:description>
|
When the available free space on the disk used by this database
|
instance falls below the value specified, no updates
|
are permitted and the server returns an UNWILLING_TO_PERFORM error.
|
Updates are allowed again as soon as free space rises above the
|
threshold.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>100 megabytes</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:size lower-limit="0" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-disk-full-threshold</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
</adm:managed-object>
|
