ePages Store Configuration 6.13.3
Created: 6.10.1; Updated: 6.12.0

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

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

Those configuration files were replaced by the configuration directory %EPAGES_CONFIG%\Database.d (Linux: $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.

  notest_cartridges=

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
  BackupHost=myshop.store
  BackupArgs=-compress 4
  RestoreArgs=-compress
  InitialBackupType=-log
  FinalBackupType=-full
  BackupType=-log
  BackupVariant=LVM
  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.
BackupHost
Used only for patching. If unset, no backup/restore is executed. If set to HOSTNAME, backup/restore is only executed on HOSTNAME. If set to localhost, backup/restore is executed if the database server is on the local host. Defaults to localhost.
BackupArgs
Additionally arguments for perl script DE_EPAGES/Database/Scripts/SybaseBackup.pl
RestoreArgs
Additionally arguments for perl script DE_EPAGES/Database/Scripts/SybaseRestore.pl
BackupMySQLArgs
Additionally arguments for backup used by MySQLDumps.pl. It defines additionally arguments for the backup script as e.g. '-snapshotsize 16G -lvmgroup mysql -lvmdata Backup'.
RestoreMySQLArgs
Additionally arguments for restore used by MySQLDumps.pl. It defines additionally arguments for the restore script as e.g. '-restorepath /var/lib/mysql'.
InitialBackupType
Used only for patching. If unset, no initial backup is executed. If set, the value must be either -log (for transaction log dumps) or -full (for full dumps).
FinalBackupType
Used only for patching. If unset, no final backup is executed. If set, the value must be either -log (for transaction log dumps) or -full (for full dumps).
BackupType
Used only for patching. Fallback for InitialBackupType or FinalBackupType if they are not defined.
BackupVariant
Used only for MySQL databases. Defines the perl script that is used for backup/restore: DE_EPAGES/Database/Scripts/MySQL{BackupVariant}Backup.pl resp. DE_EPAGES/Database/Scripts/MySQL{BackupVariant}Restore.pl. Defaults to empty, then DE_EPAGES/Database/Scripts/MySQLBackup.pl (resp. Restore) is used. Possible values are "", "LVM" or "Hot".
MySQLConfigFile
Path to MySQL configuration file (if in unusual place). Default values are /etc/my.cnf (for Linux) or basedir\my.ini (for Windows; SQL statement 'SELECT @@GLOBAL.basedir' returns basedir).
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. For Sybase, default dumpdir is %SYBASE%\dumps.
BinLogSubDir
Used only for MySQL binlog backup. If set, binlogs are saved to DumpDir/binlogs/BinLogSubDir. If not, binlogs are saved to DumpDir/binlogs.

Copyright ePages Software GmbH 2012