
3 Installing Eloquence on Windows
# eloqdb6.cfg
#
# @(#)$Revision: B.07.00.2 $
# This file defines the eloqdb6 configuration and the database
# environment.
# The default location depends on the operating system:
#
# Windows: C:/Program Files/Eloquence/etc/eloqdb6.cfg
#
# This file is read once at eloqdb6 startup.
#
# Format:
#
# The section names are not case sensitive. String values can be
# enclosed in double quotes to protect leading or trailing spaces.
# Everything after a hash (#) character is considered a comment.
### Server configuration
[Server]
# Service The service name (as defined in the services file)
# or the port number where the server should listen
# for requests. The default value is eloqdb.
#
# ServiceHttp The service name (as defined in the services file)
# or the port number where the server should listen
# for HTTP requests. If this is not specified, the
# HTTP status is disabled.
#
#Service = eloqdb
#ServiceHttp = eloqdbhttp
# SyncMode If set, this causes the eloqdb6 server to operate in
# sync write mode. The sync write mode is more resistent
# against operating system and hardware failures. When
# sync mode is disabled (set to 0) the eloqdb6 uses the
# faster async write strategy which performs fewer disk
# writes but could lead to a damaged database environment
# in case of a system failure.
# The default value is 1 (sync write mode enabled).
#SyncMode = 1
# LogFile This defines where log messages are written to.
# This configuration value either specifies a path/file
# or one of the keywords below:
#
# console - log messages are written to the console
# syslog - log messages will be sent to the Windows NT
# Event Log
#
# The default value is "syslog".
#LogFile = syslog
# LogFlags Each log message has an associated origin and
# severity. The log flags define, which messages will
# be logged. The "*" origin matches all message
# origins, so it can be used to setup a default which
# can be overriden for a specific message origin
# (eg. "*1N0"). Default LogFlags are "*0"
#
# The following origin are in use:
# * = All origins
# A = Configuration subsystem
# X = Network transport
# P = Protocol handling
# T = Thread kernel
# I = IMAGE subsystem
# B = BTREE subsystem
# F = FIXREC subsystem
# V = Volume handling
# L = Transaction logging
# C = Page cache
# N = Node handling
# D = The server framework
# O = System catalog
#
# The following severities are in use:
# L_ERROR = 0 - error messages
# L_INFO = 1 - information
# L_DEBUG = 2 - debug
# L_VDEBUG = 3 - verbose debug
#
# When using syslog, the following priorities
# are mapped:
# L_ERROR = LOG_ERR
# L_INFO = LOG_NOTICE
# L_DEBUG = LOG_DEBUG
# L_VDEBUG = LOG_DEBUG
#
# Enabling log messages with L_DEBUG or L_VDEBUG severity
# may result in a huge number of log messages.
# To suppress anything but fatal messages, you can set
# LogFlags to "*0". To enable informational log messages
# you can set the LogFlags to "*1".
#LogFlags = *0
# HTTPUser The eloqdb6 server is able to display status
# information by supporting the HTTP protocol (you can use
# Mozilla or Internet Explorer to monitor the database
# server process, see ServiceHttp above).
# If set, the eloqdb6 HTTP status display will require a
# matching user name (HTTP basic authentification) before
# allowing access to the eloqdb6 HTTP status.
# The default value is empty.
#
# HTTPPswd If set, the eloqdb6 HTTP status display will require a
# matching password (HTTP basic authentification) before
# allowing access to the eloqdb6 HTTP status.
# The default value is empty.
#HttpUser =
#HttpPswd =
# HTTPFrame If set, no link information is output on the HTTP
# status display. So the status page could be used in a
# web frame. Default value is 0.
#HttpFrame = 0
### Data base configuration
[Config]
# Threads Number of threads in the data base server. A separate
# thread is required for each client.
# Default number of threads is 40.
#Threads = 40
# LockConflictingItems If set, predicate locks with
# conflicting items are granted, however any write attempt
# to data where another process owns a lock will result in
# a status error -12. Former Eloquence revisions rejected
# a predicate lock with a conflicting item, because this
# could lead to a situation where two processes own a lock
# on an overlapping subset of data.
# The default value is 0.
#LockConflictingItems = 0
# AllowSecondaryBlockingLock If set, secondary blocking locks
# are allowed. In previous Eloquence versions, secondary
# locks in a blocking mode (odd modes) failed with
# database status -135 ("Second lock is not allowed in
# modes 1,3,5,11,13 and 15.") instead of blocking.
# Current Eloquence versions return the status code -35
# in case a deadlock situation caused by a secondary
# blocking lock is detected. Therefore, this setting is
# enabled by default. To retain the behavior of previous
# Eloquence versions it can be set to 0.
# The default value is 1.
#AllowSecondaryBlockingLock = 1
# BufferCache Size of page cache in megabytes. The page cache is
# used to reduce the number of disc accesses. Large cache
# size will speed up random database access, while a too
# small cache size may cause bad server performance.
# Default cache size is 5 MB.
#BufferCache = 5
# The server performs a checkpoint operation at fixed intervals. This
# flushes all modified buffers (including metadata) to the disk and
# resets log of committed transactions. A checkpoint is a point where
# the server knows all data are in a consistent state. Any data
# modification since the last checkpoint is recorded in the log
# volume.
#
# CheckPtFreq Checkpoint frequency in seconds.
# Default checkpoint frequency is 60 seconds.
#
# CheckPtSize Checkpoint frequency based on accumulated log space
# which would be freed by a checkpoint (in megabytes).
# A zero CheckPtSize value disables size based
# checkpoints. Default checkpoint size is 10 megabytes.
#
# The database server performs a checkpoint operation at a fixed
# interval and optionally in addition when the accumulated log space
# which could be freed by a checkpoint operation reaches a given
# threshold. The frequency of the checkpoint operations has a great
# influence on the size of the log volume since the log volume must
# hold all committed transactions since between checkpoints.
#CheckPtFreq = 60
#CheckPtSize = 10
# The syncer thread flushes modified buffer pages to the disk when
# they are likely to become reused in the near future.
#
# SyncerFreq Syncer thread invocation frequency (in seconds)
# Default interval is 5 seconds.
#SyncerFreq = 5
# SyncerJournalFlushInterval If SyncMode is enabled this
# configuration item specifies the interval (in
# milliseconds) at which the journal of committed
# transactions is synchronized to disk.
# In case of an operating system or hardware failure
# transactions that were not synchronized to disk are
# typically lost.
# A smaller value reduces the amount of transactions
# that might be lost in case of a system crash. However,
# setting this value too low significantly impacts write
# performance.
# Setting this value to 0 reverts to the legacy SyncMode
# behavior where every transaction is immediately
# synchronized. The default value is 500 milliseconds.
#SyncerJournalFlushInterval = 500
### Store/Restore Devices
[Devices]
# This section defines the "server devices" which can be used with
# dbstore and dbrestore. Each entry consists of the device name and
# an associated path.
#
# A "server device" could either be a single file or a directory.
# When no server devices are configured, dbstore and dbrestore
# operation is refused by the server.
#
# The example below defines two server devices. The device "file"
# points to a single file, the device "backup" points to a directory
# which is intended to hold the backup files.
#File = C:/Temp/Backup.dat
#Backup = C:/Backup
### Forward log
[ForwardLog]
# FwLog Configures the file, device or pipe to be used for
# forward-logging. Using the %N token in the file name
# activates automatic file management (not possible for
# devices or pipes).
# By default, forward-logging is inactive.
#
# The examples below configure an automatically managed
# file and a pipe which compresses the data on-the-fly:
#FwLog = /mnt/disk2/data/db-forward-%N.log
#FwLog = |gzip -c >/mnt/disk2/data/db-forward.log.gz
# FwRecovery Configures the file, device or pipe to be used during
# forward-recovery. If not set, the Log setting is used
# by default.
#
# The example below configures a pipe which uncompresses
# the data on-the-fly:
#FwRecovery = |gzip -dc /mnt/disk2/data/db-forward.log.gz
# FwOnFailure Configures the action to be taken in case the
# forward-log cannot be written, e.g. due to insufficient
# disk space. Possible values are disable or panic.
# If set to disable, forward-logging will be disabled on
# failure. As soon as the problem is solved it can be
# manually enabled using dbctl. If set to panic, the
# eloqdb6 server will issue a panic and abort itself.
# The default value is disable.
#FwOnFailure = disable
# FwMaxSize Limits the maximum size of automatically managed
# forward-log files (in megabytes). If not set or set to
# zero, the file size limit is 2 gigabytes.
# The default value is 0 (not set).
#FwMaxSize = 0
### Data base environment
[Volumes]
# List of data base volumes. Initially empty.
# This is usually filled in by dbvolcreate and dbvolextend utilities