# Integration Properties

Last Updated: July 2024

Integration-related properties may reside in database or property files. Updates of some properties require restart of the integration services to take effect. Refer to [Integration Properties Details](https://help.connected.illumina.com/clarity-lims/instruments-and-integrations/integration-properties-update/integration-properties-details) for more information.

{% hint style="danger" %}
Clarity v6.3 introduces a new feature (System Setting) for configuring properties (including some integration properties).
{% endhint %}

Refer to table below on the recommended methods of property configuration for different scenarios.

| **Scenario**                                                                                                                             | **Configuring Properties**                                                                                                                                                                                                                                                                                                               | **Remarks**                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Fresh installation of integration packages on Clarity v6.2                                                                               | <ul><li>Properties in database: configure via <em>omxProps-ConfigTool</em> utility</li><li>Properties in files: edit property files directly</li></ul>                                                                                                                                                                                   | Applicable to any integration packages released together with or after Clarity v6.2                                                                                                                                                                                                                                                                                                              |
| Fresh installation of integration packages (released with or after Clarity v6.3) on Clarity v6.3                                         | <ul><li><p>Properties exposed in System Setting: configure via System Setting</p><blockquote><p>ℹ Property updates do not require restart of integration service</p></blockquote></li><li>Properties in database: configure via <em>omxProps-ConfigTool</em> utility</li><li>Properties in files: edit property files directly</li></ul> | For integration packages released with or after Clarity v6.3, some of the database can be configured via System Setting page (Available from Clarity v6.3 or above).                                                                                                                                                                                                                             |
| Fresh installation of integration packages (released before Clarity v6.3) on Clarity v6.3                                                | <ul><li>N.A.</li></ul>                                                                                                                                                                                                                                                                                                                   | <blockquote><p>⚠ Integration configuration scripts are not compatible with Clarity v6.3. Integration properties must be updated using <em>omxProps-ConfigTool</em> utility</p></blockquote><p>Users are recommended to install the latest integration package to avoid issues with configuration scripts and to leverage the new System Setting page for configuring integration properties.</p> |
| <p>Upgrade scenario:</p><ul><li>Upgrade Clarity v6.2 to Clarity v6.3</li><li>Continue to use previously installed integrations</li></ul> | <ul><li>Properties in database: configure via <em>omxProps-ConfigTool</em> utility</li><li>Properties in files: edit property files directly</li></ul>                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p>Upgrade scenario:</p><ul><li>Upgrade Clarity v6.2 to Clarity v6.3</li><li>Upgrade integrations to latest versions</li></ul>           | <ul><li><p>Properties exposed in System Setting: configure via System Setting</p><blockquote><p>ℹ Property updates do not require restart of integration service</p></blockquote></li><li>Properties in database: configure via <em>omxProps-ConfigTool</em> utility</li><li>Properties in files: edit property files directly</li></ul> |                                                                                                                                                                                                                                                                                                                                                                                                  |