Versions Compared

Key

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

Starting with version 4.1.0 of OpenEMPI, the configuration information for your instance is maintained in the embedded graph database instead of in the mpi-config.xml file. The Settings page allows you to modify the configuration parameters that were previously stored in the mpi-config.xml file. It is important that you thoroughly understand what these settings do before you change them since some of them can have considerable impact on your instance.

Global Identifier

The Global Identifier tab is used to control whether OpenEMPI assigns global identifiers to records on your instance. The default value for this setting is to assign global identifiers since that is the desired behavior in most cases. When you enable global identifier assignment, you must also specify the identifier domain that will be associated with the global identifiers. The default value is “OpenEMPI” since it makes it clear that identifier was assigned to a record by OpenEMPI itself but you can set the identifier domain for the global identifier to any domain.

...

Miscellaneous Settings

The Miscellaneous Settings tab manages the values of various parameters that control the operation of your instance. Although some of the parameters on this tab should be modified to reflect the preferences for your site, others control internal parameters for the instance and should only be changed either through direction of the OpenEMPI support team or if you fully understand the impact of the change. You will need to restart your OpenEMPI instance for these changes to take effect.

...

  • File Repository Directory: the directory where OpenEMPI places files that are uploaded to the server such as data files or entity schemas. This is also the directory where exported data will be placed in.

  • Data Directory: the directory where the embedded databases for each entity are created and maintained in.

  • Session Duration: the number of seconds that the session is kept alive before it expires. The session identifiers generated upon successful authentication by the REST API will be kept alive if inactive by the amount specified by this parameter.

  • Consumer Queue Wait Time: the number of seconds that some background processes such as the blocking re-indexing process will wait for records retrieved from the database to become available for processing before the process will assume that all the work has completed. This parameter may need to be increased if the instance has many records (tens of millions) and a slow file system which may cause the retrieval of batches of records to be delayed).

  • Date Format: date format used internally to parse dates (should not be changed aside from very special situations).

  • Null Value String: special value used by the REST API to set the value of a parameter to null through an update operation (should not be changed aside from very special situations).

  • Instance Name: name of the specific instance of OpenEMPI in a clustered deployment.

  • Enable Identifier Update Notifications: enables the identifier update notification mechanism which will cause the system to queue up entries of events where the global identifier assigned to a record has changed. These notifications can be retrieved using the REST API using the Notification resource. When you enable this feature you will need to select the username of the user that will be able to retrieve these notification events through the REST API, the amount of time that these events will be preserved on the server before they are deleted (only if the process to delete expired events is enabled on the instance), and the identifier domain that is used to track identifier changes. The domain selected here should always match the identifier domain that is used in assigning global identifiers specified in the Global Identifier tab.

  • Autostart PIX/PDQ Service: indicates whether the listeners for the PIX/PDQ service (HL7v2 bindings) should be started when the server starts or not. The default behavior is to start these listeners.

  • Enable Transitive Closure Behavior: enabling this feature will cause the system to generate links between records using transitive closure even though the matching rules may not support these links. For example, if there is a link between records A and B and between records A and C, then when this feature is enabled, the system will also link records B and C even though their association may not be supported by the configuration of the matching algorithm.

  • Remember Manual Classification Decisions: when this feature is enabled, the system will memorize classification decisions made manually by the user and reapply them if the same record pair is evaluated by the matching algorithm in the future. For example, if record pair (A,B) is placed in the review pair queue because the pair was classified as a probable match, when the user reviews the pair and resolves the probable match into a non-match, the system will remember this decision. If an update operation causes a change in one of the two records A or B and the matching algorithm reevaluates the pair as a probable link, the pair will be classified as a non-match automatically since this manual decision had been memorized.

Scheduled Tasks

The Scheduled Tasks tab controls which periodic processes are enabled on your instance for background processing of work. These tasks can be scheduled to run periodically to perform maintenance work on your instance. When you enable one of these tasks, you need to specify a number of parameters that control their behavior.

...