3 Installing Eloquence on Windows

Default eloqdb6.cfg file

# 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

Eloquence Installation and Configuration - 29 OCT 2004