Since ePages version 6.10.0, a new store configuration has been introduced.

Following files/directories are obsolete and do not exist anymore:

  • Database.conf

  • database.ini (in patches from 6.10.1 on)

Those configuration files were replaced by the configuration directory $EPAGES_CONFIG/Database.d/.

Each ePages store has its own configuration file. Directory Database.d contains the configuration files STORE.conf, where STORE is the name of the store (the logical database name).

Obsolete Patch Configuration File database.ini

Starting with patch 6.10.1, database.ini as configuration file for patches does not exist anymore.

  • Sections [sysusages] and [sp_dboption] are moved to prerequisites.ini

  • Sections [NoTestCartridges] is moved to prerequisites.ini as parameter notest_cartridges=

  • Section [StoreType] is moved to Database.d/*.conf as parameter StoreType=

  • Parameters in sections [host HOST] are moved to Database.d/*.conf

Store Configuration File Database.d/STORE.conf

Possible parameters (with example values) of section [Connection] are:

[Connection]
active=1
cache=0
datasource=dbi:mysql:mysql_socket=/var/lib/mysql/mysql.sock
login=usr_storedb
passwd=epages
encpasswd=gfgugga
Database=storedb
StoreType=Store
Backup=Backup
MySQLConfigFile=/etc/my.cnf
DumpDir=_SYBASE_/dumps
BinLogSubDir=mysql1001
active

Defines if the store connection is active or not. If not, the ePages client can’t connect to the store.

cache

Defines if open database connections are reused by the ePages service. If set, database requests are faster. On the other hand, the number of open sockets is limited and a lot of open idle sockets slow down the system. If not existing, set to 0.

datasource

(Required) Connection parameters for the ePages service to connect to the store.

login

(Required) Connect to store with login.

passwd/encpasswd

(Required) Password for store login (plain/encrypted). If both parameters are set encpasswd is used.

Database

(Required) Physical database name of the store.

StoreType

(Required) Type of the store.

Backup

Connection for backup/restore of the database. If set to VALUE, a file VALUE.conf in Database.d must exist with valid connection parameters. If unset, no backup/restore is executed. Typically, the backup connection is named Backup with its configuration file Backup.conf.

MySQLConfigFile

Path to MySQL configuration file (if in unusual place). Default value is /etc/my.cnf (for Linux).

DumpDir

Directory where the database dumps are stored. Here, a token _TOKEN_ is replaced by $ENV{TOKEN} (e.g. _SYBASE_/dumps is expanded to /srv/epages/eproot/Sybase/dumps). For MySQL, default dumpdir is $EPAGES/MySQLDumps.

BinLogSubDir

Used only for MySQL binlog backup. If set, binlogs are saved to DumpDir/binlogs/BinLogSubDir. If not, binlogs are saved to DumpDir/binlogs.