Differences

This shows you the differences between two versions of the page.

--- tutorial:adm:application_configuration [2018/12/27 16:17]
kotisovam
+++ tutorial:adm:application_configuration [2021/01/07 19:07] (current)
apeterova configuration locations
@@ Line 1: / Line 1: @@
-Configuration - CzechIdM configuration in GUI and files
+===== Configuration - CzechIdM configuration in GUI and config files =====
-===== Configuration file =====
+CzechIdM can be configured by many configuration properties, see [[devel:documentation:application_configuration:dev:backend#configuration_items|the list of configuration items]].
-The CzechIdm configuration is to be found in the file //application.properties//. This configuration is read at the application start. If changed, new options will be applied after application restart.
+You can set the properties in two ways:
+  * [[#application_settings_in_gui|settings in GUI]] - these properties are persisted to the CzechIdM database and they are preferred over the properties in configuration files. This is most handy place to put your configuration that differs from product defaults, but note that it's not accessible when CzechIdM is down.
+  * [[#configuration_file|configuration files]] located on the server where CzechIdM is deployed.
-===== Application settings in GUI =====
+==== Configuration file ====
+There are two locations of the configuration files for CzechIdM. This configuration is read at the application start. If changed, new options will be applied after application restart.
+  * external configuration files - typically the files ''application-production.properties'' and ''quartz-production.properties'' are created during [[tutorial:adm:czechidm_installation#create_czechidm_configuration|CzechIdM installation]] in the folder ''/opt/czechidm/etc/'' on the server (the paths and names may differ in specific installations). These files are most suitable for environment-specific properties (differences between the test and production environment) or properties, that you want to be able to change even if CzechIdM is down (e.g. turning Single-Sign-On on and off).
+  * configuration files bundled with CzechIdM product - ''application.properties'' of core and other CzechIdM modules (''module-XXX.properties''). The product or project developers change the default values in these files during development. It's not recommended to do any changes in the files inside the already built IdM package (idm.war); if you want to change the values, use external configuration files or settings in GUI.
+You can see the values from the configuration files (both external and bundled) in the CzechIdM application: Settings -> Configuration -> Static environment configuration items.
+==== Application settings in GUI ====
 All keys in configuration file can be overridden via GUI in menu Settings -> Configuration. If the configuration property is set, the change takes place instantly.