Eloquera Configuration

 

Configure the Eloquera by editing a single file called Eloquera.config, located in the Eloquera server's installation folder (normally at %ProgramFiles%\Eloquera\Eloquera Server).

 

Eloquera.config can be modified directly or via UI

 

 

 

If required, you can modify the file using any text editor like Notepad.

 

WARNING: Do not use Microsoft Word or similar text formatting software.  

 

 

 The default settings should look like this:

 

<?xml version="1.0"?>

<Eloquera xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <Cache IndexCacheSize="10000"

         WriteThru="false"

         IndexCleanerPeriod="100"

         IndexCleanerBatchSize="100"

         CleanerPeriod="100"

         CleanerBatchSize="2000"

         CommitSequenceMaxLength="2000"

         ShallowReadThreshold="1000"

         ShallowReadAhead="1000"

         ReadAhead="20"

         SaturationThreshold="10000"

         MemoryFootPrint="1000"/>

  <MemoryManager Mode="1" />

  <Server ServerPort="43962"

          DatabasePath="c:\dev\db"

          Trace="true"

          InMemoryAllowed="true"

          Secure="false"

          AllowUsers=""

          AllowGroups="Everyone"

          SNMPAddress = "net.tcp://localhost:8523/SNMP"

          AutoRecovery="false"

          CallbackEnabled="false"

          VarSectorSize="512"

          IndexNodeSize="64"

          StoredProceduresPath = ""/>

  <SmartRuntime Smart="true" />

  <UserLogin Enabled="false"

             PasswordHash="l+on1aCwDrcZ5bGlv+fyyIlYkbuFIOxZFlFwIGKlms0CCwoGn9TZvM0E3Uksjwx64+/yv8nsaUajWLz1kyKG7A==" />

</Eloquera>

 

 

 Let's look at the <Server> element.

 Here are some of its attributes and their descriptions:

 

Attribute

Description

ServerPort

Allows setting any available TCP port for a server to listen at. It is possible to install multiple copies of the Eloquera server at the same machine, with different ports they serve.

Default value for this attribute is “43962” (0xABBA).

 

DatabasePath

Shows a path to a folder to store database files at.

It is recommended to store database files on a physical disk different to the system disk for higher performance.

Default path points to the Database folder within the Eloquera server installation folder.

 

IpAddress

Setting the value of this attribute to an IP address available on the server will force the Eloquera server to accept connections only from the network the specified IP address belongs to.

Omitting the attribute or setting its value to empty will let the server to accept connections on any available interface from any (routable) TCP network.

Default value is “” (an empty string).

 

Secure

Specifies if all connections to the server should be authenticated and the traffic between the Eloquera server and clients should be encrypted.

Default value for the attribute is “true”, which stands for secure connection.

 

AllowUsers

This attribute contains a list of user names (separated by “;”), which are granted access to the current installation of the Eloquera server.

Names should be specified in ‘DOMAIN\UserName’ format.

Default value is “” (an empty string).

 

AllowGroups

The attribute lists all groups that granted access to the current installation of the Eloquera server. Groups are separated by “;” (semicolon).

 

There are a few reserved names, which are system language-independent:

·         Administrators

·         Users

·         Backup operators

·         Guests

·         Power Users

·         Replicator

·         Print Operators

·         Account Operators

·         System Operators

 

The groups matching to these names are determined by Windows automatically.

 

The default value is “Administrators”.

 

InMemoryAllowed

True if inmemory database is allowed, false otherwise

 

WriteThru

If database works in a volatile environment it is recommended to set WriteThru = true to prevent database from corruption because of power failure or any other sudden switch off

 

MemoryFootPrint

Value less or equals to 100 represents % of memory that system cache can use. Value greater than 100 represents amount of memory in KB that cache can use.

 

 

All changes in the configuration file take effect only after restarting the Eloquera server.