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