Web.config configuration settings
Omada recommends using configuration files to configure several of the Enterprise Server (ES) settings. The following configuration files are used across Omada components:
| Component | Configuration file |
|---|---|
| ES | Web.config |
| Timer Service | Omada.OE.Service.exe.config |
| Omada Provisioning Service (OPS) | Omada.OPS.Service.exe.config |
| Role and Policy Engine (RoPE) | Omada.RoPE.EngineExecutor.exe.config (references ConfigFiles\ConnectionStrings.config, ConfigFiles\AppSettings.config, ConfigFiles\EngineConfiguration.config) |
| Data Warehouse (ODW) | Omada ODW ConnectionString.dtsConfig, Omada ODW WebService.dtsConfig |
The Data Warehouse uses Microsoft SQL Server Integration Services (SSIS) configuration files (.dtsConfig) located in the ODW installation folder, rather than the .exe.config format used by other Omada Windows services.
The Web.config file allows you to configure several of the ES settings that can either be set in the config file:
| Setting | Type | Description |
|---|---|---|
PswEncryptionKey | String | Specifies the encryption key used to encrypt and decrypt strings. It is important that the key is the same as you use for OPS. |
ConnStr | String | Specifies the connection string to the ES Structured Query Language (SQL) database. If you host several environments on the same machine, this should point to the master database. |
SolutionName | String | Specifies the value of the solution name presented in the web page title. |
CommandTimeout | Integer | Specifies the timeout (number of seconds) for certain SQL commands. |
LoadBalancerNodeEnabled | Boolean | Specifies the response returned by the Load balancer page. Possible values are True and False. |
SessionTimeout | Integer | Specifies the authentication timeout (number of minutes) for Forms, Security Assertion Markup Language (SAML) and OpenID logon, as well as integrated authentication. |
The settings should be configured as follows:
<appSettings>
<add key="ConnStr" value=""/>
<add key="CommandTimeout" value=""/>
<add key="SolutionName" value=""/>
<add key="LoadBalancerNodeEnabled" value=""/>
<add key="SessionTimeout" value=""/>
<add key="PswEncryptionKey" value=""/>
</appSettings>
These settings can also be set via the Omada.OE.Service.config file for the timer service.
Changing PswEncryptionKey after it has been used to encrypt data should be performed with caution as an incorrect update may lose data or Omada Identity unresponsive.