Working with ELMA configuration files

ELMA configuration file is an XML with the settings that determine how the system operates. It is called configuration.config. By default, ELMA configuration files are located in ../ELMA installation folder/UserConfig folder.

ELMA can only work with 1 configuration at the same time. You can change the current configuration in connection.config file from the ../ELMA installation folder/Web. To do that, you need to specify the path to the configuration you want to use:

<add name="ConfigurationFile" connectionString="C:\ELMA3-Enterprise\UserConfig\configuration.config"/>

After you change the path, you will have to restart ELMA server to apply the changes.

Configuration of ELMA Standard edition

Database settings

<connectionStrings> tag determines the database connection settings:

<add name="MainDB" connectionString="Data Source=MySQLServer; Initial Catalog=ELMA3; Integrated Security=true; "/>

  • Integrated Security parameter determines if SSO is used to connect to the database. If this parameter is set to true, then ELMA will try to authorize in MS SQL Server from the account that is specified as an identity of ELMA application pool in IIS / Cassini. If the parameter is set to false, ELMA will try to authorize in MS SQL Server from the account that is specified in the database connection string as follows: <add name="MainDB" connectionString="Data Source=(local);Initial Catalog=ELMA3;Integrated Security=false;UserID=UserName;Password=pass"/>
  • Data Source parameter determines the name/address of MS SQL Server. Initial Catalog parameter determines the name of the database from this server.
  • In our case, we use the database with ELMA3 name. If you want to connect to other databases, simply change its name and restart ELMA server.

 <main connectionStringName="MainDB" type="EleWise.ELMA.Extensions.MSSQL.MSSQLProvider, EleWise.ELMA.Extensions.MSSQL" backupEnabled="false" commandTimeOut="1000"/> string defines if ELMA needs to create a backup copy of the database when the server is started. Also, here we can determine the timeout for MS SQL server.

  • commandTimeOut parameter determines the MS SQL server timeout in seconds. By default, this value is set to 30 seconds. To disable the timeout, set this parameter to 0.
  • backupEnabled defines if ELMA needs to create a backup copy of database when the server is started. It may have different values:
    • backupEnabled="false" – no backup copy will be created.
    • backupPath = “” – the backup copy will be created and saved to the default folder according to MS SQL server settings. Usually, this folder is ~\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Backup.
    • backupPath = “C:\MyBackups” – the backup copy will be created and saved to the folder you specified.

File storage settings

<add name="FSProvider" type="EleWise.ELMA.Runtime.Providers.Impl.FileSystemFileStoreProvider, EleWise.ELMA.SDK" filesPath="Files"/> string determines the path to Files folder. This folder contains files that users upload to ELMA (e.g. profile avatars, document templates, document versions). By default, this folder is located in the configuration folder (../ELMA installation folder/UserConfig). To change the path, you need to specify it in the filesPath parameter: e.g. filesPath="C:\MyELMAFiles"

Attention
If you store ELMA files remotely, you must specify the absolute network path to the folder: e.g. \\RemoteServer\ELMAfiles. You must also ensure, that the account that is specified as an identity of ELMA application pool in IIS / Cassini has the access to this folder.

Configuration of ELMA Express edition

Database settings

<connectionStrings> tag determines the database connection settings:

<add name="MainDB" connectionString="Data Source=127.0.0.1;Initial Catalog={CONFIGDIR}\elma3-express.fdb;User ID=sysdba;Password=masterkey;Port=3056;Dialect=3;ServerType=0"/>

  • Data Source parameter determines the name/address of Firebird server.
  • Initial Catalog parameter determines the name of database from the server. Squiggle brackets determines the path to database. You can replace CONFIGDIR with your custom path.
  • User ID and Password parameters determine the account details of the database user.
  • Port parameter determines the port for connection to Firebird server. Default port is 3056.
  • ServerType parameter determines the type of Firebird server. For ELMA to work, this parameter must be set to 0.

 File storage settings

<add name="FSProvider" type="EleWise.ELMA.Runtime.Providers.Impl.FileSystemFileStoreProvider, EleWise.ELMA.SDK" filesPath="Files"/> string determines the path to Files folder. This folder contains files that users upload to ELMA (e.g. profile avatars, document templates, document versions). By default, this folder is located in the configuration folder (../ELMA installation folder/UserConfig). To change the path, you need to specify it in the filesPath parameter: e.g. filesPath="C:\MyELMAFiles"

Attention
If you store ELMA files remotely, you must specify the absolute network path to the folder: e.g. \\RemoteServer\ELMAfiles. You must also ensure, that the account that is specified as an identity of ELMA application pool in IIS / Cassini has the access to this folder.