Versions Compared

Old Version 20

changes.mady.by.user Dimitri R

Saved on

compared with

New Version 21

changes.mady.by.user Olara Moses

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

This page is outdated and no longer receives updates!

Runtime Properties

These properties are loaded when a webapp is started. It is used to specify database connection settings, custom look and feel per installation, sensitive data, etc.

...

Tip

In the following descriptions, {WEBAPP NAME} is used in place of your web applications name (the name of the war file you loaded). Often this will be openmrs.

Tip

Do not use {APPDATA} in your path. OpenMRS will not render it. It is only used here as an example. In Windows 7+ this is C:\Users\currentuserrunningtomcat\AppData\Roaming\OpenMRS. In Windows XP and below this is C:\Docs and Settings\currentuserrunningtomcat\Application Data\

In some versions of windows, this can be found at C:\Windows\System32\config\systemprofile\Application Data\OpenMRS

While in some others, it can be found at C:\Windows\SysWOW64\config\systemprofile\Application Data\OpenMRS

As of version 1.8, OpenMRS will look for the runtime properties file in this order:

  1. The current directory:

    Code Block
    ./{WEBAPP NAME}-runtime.properties

  2. Using the environment variable

    Code Block
    {WEBAPP NAME}_RUNTIME_PROPERTIES_FILE

  3. User's home directory

    • Windows:

      Code Block
      {APPDATA}/OpenMRS/{WEBAPP NAME}-runtime.properties

    • *Linux:

      Code Block
      ~/.OpenMRS/{WEBAPP NAME}-runtime.properties

      (NOTE: On Linux, in some occasions, it is still necessary to set the

      Code Block
      {WEBAPP NAME}_RUNTIME_PROPERTIES_FILE

      environment variable to point to your file in order to get OpenMRS to read it.)

  4. In the current directory

Note

Prior to version 1.8 the "current directory" was the last location searched for the runtime properties

...