Properties
==========

Under the :file:`etc/` directory in both the source and the binary
distributions, several files are provided which help to configure
OMERO.server:

::

      etc/omero.properties             - Our central configuration file with all defaults.
      etc/hibernate.properties         - Required by Hibernate since some properties are only configurable 
                                         via a classpath:hibernate.properties file.
      etc/logback.xml                  - Logging configuration
      etc/local.properties.example     - The properties that you will most likely want to change.
                                         This file can be copied to etc/local.properties to being, or 
                                         alternatively you can run "java omero setup"
                                         (Name will change to "…default")
      etc/local.properties             - Local overrides for other properties (used by build only)

The most useful of the properties are listed in a :doc:`glossary
</sysadmins/config>`.

During the build, these files get stored in the ``blitz.jar`` and are
read-only. On creation of an :doc:`/developers/Server/Context`,
the lookup for properties is (first wins):

-  Properties passed into the constructor (if none, then the default
   properties in :source:`config.xml <components/common/resources/ome/config.xml>`)
-  System.properties set via "java -Dproperty=value"
-  Configuration files in order listed.

This ordering is defined for the various components via "placeholder
configurers" in:

-  :source:`components/server/resources/ome/services/services.xml`

Once configured at start, all values declared in one of the mentioned
ways can be used in Spring configurations via the syntax:

::

     <bean id=…>
       <property name="mySetter" value="${property.name}"/>
     </bean>