5595N/A<?xml version="1.0" encoding="utf-8"?>
5595N/A<!--
5595N/A ! CDDL HEADER START
5595N/A !
5595N/A ! The contents of this file are subject to the terms of the
5595N/A ! Common Development and Distribution License, Version 1.0 only
5595N/A ! (the "License"). You may not use this file except in compliance
5595N/A ! with the License.
5595N/A !
5595N/A ! You can obtain a copy of the license at
5595N/A ! trunk/opends/resource/legal-notices/OpenDS.LICENSE
5595N/A ! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
5595N/A ! See the License for the specific language governing permissions
5595N/A ! and limitations under the License.
5595N/A !
5595N/A ! When distributing Covered Code, include this CDDL HEADER in each
5595N/A ! file and include the License file at
5595N/A ! trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
5595N/A ! add the following below this CDDL HEADER, with the fields enclosed
5595N/A ! by brackets "[]" replaced with your own identifying information:
5595N/A ! Portions Copyright [yyyy] [name of copyright owner]
5595N/A !
5595N/A ! CDDL HEADER END
5595N/A !
5595N/A !
5595N/A ! Copyright 2011 ForgeRock AS.
5595N/A ! -->
5595N/A<adm:managed-object name="file-based-audit-log-publisher"
5595N/A plural-name="file-based-audit-log-publishers"
5595N/A package="org.opends.server.admin.std" extends="access-log-publisher"
5595N/A xmlns:adm="http://www.opends.org/admin"
5595N/A xmlns:ldap="http://www.opends.org/admin-ldap">
5595N/A <adm:synopsis>
5595N/A <adm:user-friendly-plural-name />
5595N/A publish access messages to the file system.
5595N/A </adm:synopsis>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:object-class>
5595N/A <ldap:name>ds-cfg-file-based-audit-log-publisher</ldap:name>
5595N/A <ldap:superior>ds-cfg-access-log-publisher</ldap:superior>
5595N/A </ldap:object-class>
5595N/A </adm:profile>
5595N/A <adm:property-override name="java-class" advanced="true">
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>
5595N/A org.opends.server.loggers.TextAuditLogPublisher
5595N/A </adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A </adm:property-override>
5595N/A <adm:property name="asynchronous" mandatory="true" advanced="true">
5595N/A <adm:synopsis>
5595N/A Indicates whether the
5595N/A <adm:user-friendly-name />
5595N/A will publish records asynchronously.
5595N/A </adm:synopsis>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>true</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:boolean />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-asynchronous</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="queue-size" advanced="true">
5595N/A <adm:synopsis>
5595N/A The maximum number of log records that can be stored in the
5595N/A asynchronous queue.
5595N/A </adm:synopsis>
5595N/A <adm:description>
5595N/A Setting the queue size to zero activates parallel log writer
5595N/A implementation which has no queue size limit and as such the
5595N/A parallel log writer should only be used on a very well tuned
5595N/A server configuration to avoid potential out of memory errors.
5595N/A </adm:description>
5595N/A <adm:requires-admin-action>
5595N/A <adm:other>
5595N/A <adm:synopsis>
5595N/A The <adm:user-friendly-name /> must be restarted if this property
5595N/A is changed and the asynchronous property is set to true.
5595N/A </adm:synopsis>
5595N/A </adm:other>
5595N/A </adm:requires-admin-action>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>5000</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:integer lower-limit="0" />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-queue-size</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="log-file" mandatory="true">
5595N/A <adm:synopsis>
5595N/A The file name to use for the log files generated by the
5595N/A <adm:user-friendly-name />.
5595N/A The path to the file is relative to the server root.
5595N/A </adm:synopsis>
5595N/A <adm:requires-admin-action>
5595N/A <adm:component-restart />
5595N/A </adm:requires-admin-action>
5595N/A <adm:syntax>
5595N/A <adm:string>
5595N/A <adm:pattern>
5595N/A <adm:regex>.*</adm:regex>
5595N/A <adm:usage>FILE</adm:usage>
5595N/A <adm:synopsis>
5595N/A A path to an existing file that is readable by the server.
5595N/A </adm:synopsis>
5595N/A </adm:pattern>
5595N/A </adm:string>
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-log-file</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="log-file-permissions" mandatory="true">
5595N/A <adm:synopsis>
5595N/A The UNIX permissions of the log files created by this
5595N/A <adm:user-friendly-name />.
5595N/A </adm:synopsis>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>640</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:string>
5595N/A <adm:pattern>
5595N/A <adm:regex>^([0-7][0-7][0-7])$</adm:regex>
5595N/A <adm:usage>MODE</adm:usage>
5595N/A <adm:synopsis>
5595N/A A valid UNIX mode string. The mode string must contain
5595N/A three digits between zero and seven.
5595N/A </adm:synopsis>
5595N/A </adm:pattern>
5595N/A </adm:string>
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-log-file-permissions</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="time-interval" advanced="true">
5595N/A <adm:synopsis>
5595N/A Specifies the interval at which to check whether the log files
5595N/A need to be rotated.
5595N/A </adm:synopsis>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>5s</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:duration base-unit="ms" lower-limit="1" />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-time-interval</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="buffer-size" advanced="true">
5595N/A <adm:synopsis>Specifies the log file buffer size.</adm:synopsis>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>64kb</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:size lower-limit="1" />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-buffer-size</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="auto-flush" advanced="true">
5595N/A <adm:synopsis>
5595N/A Specifies whether to flush the writer after every log record.
5595N/A </adm:synopsis>
5595N/A <adm:description>
5595N/A If the asynchronous writes option is used, the writer is
5595N/A flushed after all the log records in the queue are written.
5595N/A </adm:description>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>true</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:boolean />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-auto-flush</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="append">
5595N/A <adm:synopsis>
5595N/A Specifies whether to append to existing log files.
5595N/A </adm:synopsis>
5595N/A <adm:default-behavior>
5595N/A <adm:defined>
5595N/A <adm:value>true</adm:value>
5595N/A </adm:defined>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:boolean />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-append</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="rotation-policy" multi-valued="true">
5595N/A <adm:synopsis>
5595N/A The rotation policy to use for the
5595N/A <adm:user-friendly-name />
5595N/A .
5595N/A </adm:synopsis>
5595N/A <adm:description>
5595N/A When multiple policies are used, rotation will occur if any
5595N/A policy's conditions are met.
5595N/A </adm:description>
5595N/A <adm:default-behavior>
5595N/A <adm:alias>
5595N/A <adm:synopsis>
5595N/A No rotation policy is used and log rotation will not occur.
5595N/A </adm:synopsis>
5595N/A </adm:alias>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:aggregation parent-path="/"
5595N/A relation-name="log-rotation-policy" />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-rotation-policy</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A <adm:property name="retention-policy" multi-valued="true">
5595N/A <adm:synopsis>
5595N/A The retention policy to use for the
5595N/A <adm:user-friendly-name />
5595N/A .
5595N/A </adm:synopsis>
5595N/A <adm:description>
5595N/A When multiple policies are used, log files are cleaned when
5595N/A any of the policy's conditions are met.
5595N/A </adm:description>
5595N/A <adm:default-behavior>
5595N/A <adm:alias>
5595N/A <adm:synopsis>
5595N/A No retention policy is used and log files are never cleaned.
5595N/A </adm:synopsis>
5595N/A </adm:alias>
5595N/A </adm:default-behavior>
5595N/A <adm:syntax>
5595N/A <adm:aggregation parent-path="/"
5595N/A relation-name="log-retention-policy" />
5595N/A </adm:syntax>
5595N/A <adm:profile name="ldap">
5595N/A <ldap:attribute>
5595N/A <ldap:name>ds-cfg-retention-policy</ldap:name>
5595N/A </ldap:attribute>
5595N/A </adm:profile>
5595N/A </adm:property>
5595N/A</adm:managed-object>