# Integration Properties Details

Last Updated: November 2025

Document Version: 3

This section describes the integration properties. For the integration packages listed below, unless otherwise specified, the properties are now in database. Database properties can be configured via *omxProps-ConfigTool* utility. From Clarity v6.3 and onwards, some properties are also configurable via System Setting.

## Illumina Run Manager (IRM) (v1.0.0 and onwards)

{% hint style="danger" %}
Changes on Illumina Run Manager integration properties take effect upon updates and do not require restart of Clarity.
{% endhint %}

| **Property**                                         | **Description**                                                                                                                                                                                                    | **Configurable via System Setting** |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- |
| integration.illuminaRunManager.pns.privateCaFilePath | <ul><li>⚠ Only applicable for Illumina Run Manager Integration Package v1.0.0.</li><li>Absolute path of private certificate authority (CA) chain file in PEM format.</li><li>Used by integration service</li></ul> | No                                  |

## iScan (v1.2.0 and onwards)

The iScan integration uses the SIS core service. Refer to [SIS Core](#sis-core-v260-and-onwards) for common properties of the SIS core service.

{% hint style="danger" %}
Changes on iScan integration properties take effect upon updates and do not require restart of the SIS core service.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                                  | **Description**                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| integration.iscan.v1.autoCompleteAnalysisWorkflow             | <ul><li>Boolean flag to control on/off analysis workflow auto-completion if the analysis is successful.</li><li>Used by integration service</li><li><strong>Default:</strong> true</li></ul>                                                                                               |
| integration.iscan.v1.autoCompleteWorkflow                     | <ul><li>Boolean flag to control on/off imaging run workflow auto-completion if the run is successful.</li><li>Used by integration service.</li><li><strong>Default:</strong> true</li></ul>                                                                                                |
| integration.iscan.v1.autoCompleteWorkflowUponFailure          | <ul><li>Boolean flag to control on/off imaging run workflow auto-completion if the run is failed</li><li>Used by integration service</li><li><strong>Default:</strong> false</li></ul>                                                                                                     |
| integration.iscan.v1.supportedAnalysisWorkflowStepNamePattern | <ul><li>The regex pattern for analysis step name which is supported by iScan integration.</li><li>Used by integration service.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">^Invoke Infinium Analysis (.\*)$        |
| </code></pre></li></ul>                                       |                                                                                                                                                                                                                                                                                            |
| integration.iscan.v1.supportedImagingWorkflowStepNamePattern  | <ul><li>The regex pattern for imaging step name which is supported by iScan integration.</li><li>Used by integration service.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">^Image Infinium BeadChip on iScan (.\*)$ |
| </code></pre></li></ul>                                       |                                                                                                                                                                                                                                                                                            |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.iscan.v1.ica.api.uri
* integration.iscan.v1.ica.scopes
* integration.iscan.v1.workgroupid
  {% endhint %}

## MiSeq (v8.3.0 and onwards)

Sequencing runs are matched using the reagent cartridge ID and the base name of the sequencing step.

{% hint style="danger" %}
**Do not change the base name**. The sequencing service that captures sequencing run results expects the name. The base name is stored in the *sequenceProcessBaseName* property. If the name is changed without the property being updated, the reagent cartridge ID <-> sequencing step base name matching system fails.\
If you need to rename the step, for example to add a version number, modify the text before or after the base name portion. This part of the name is not used in the matching system. For example, change MiSeq Run (MiSeq v3.2) to Demo-MiSeq Run (MiSeq v3.2)-Updated.
{% endhint %}

{% hint style="danger" %}
Changes on *integration.miseq.v8.seqservice.sequenceProcessBaseName* property take effect upon updates and do not require restart of the integration service. For all remaining properties, integration service has to be restarted for property changes to take effect.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                            | **Description**                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.miseq.v8.seqservice.sequenceProcessBaseName | <ul><li>Sequencing master step base display name. Partial matching is used to look up the master step.<br>This property is added/updated by Illumina Preset Protocols (IPP) during the workflow installation.</li><li><strong>Default:</strong> Sequencing master step name (e.g., MiSeq Run (MiSeq v3.2))</li></ul> |

Other properties installed by the integration:

{% hint style="info" %}
Modify these properties using */opt/gls/clarity/config/configure\_extensions\_miseq\_sequencingservice-v8.sh*:

* integration.miseq.v8.seqservice.eventFileDirectory.1
* integration.miseq.v8.seqservice.eventFileDirectory.99
* integration.miseq.v8.seqservice.eventFileDirectorySuffixes
* integration.miseq.v8.seqservice.ignoreUnmatchedContainerIds
* integration.miseq.v8.seqservice.ignoreUnmatchedContainerIdsWaitDays
* integration.miseq.v8.seqservice.netPathPrefixReplace.1
* integration.miseq.v8.seqservice.netPathPrefixReplace.99
* integration.miseq.v8.seqservice.netPathPrefixSearch.1
* integration.miseq.v8.seqservice.netPathPrefixSearch.99
* integration.miseq.v8.seqservice.netPathPrefixSearchReplaceSuffixes
  {% endhint %}

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.miseq.v8.seqservice.runReportViewsVersion
* integration.miseq.v8.seqservice.synchronizationPeriod
  {% endhint %}

## MiSeq Dx (v1.11.0 and onwards)

The following table lists the properties installed with the Illumina MiSeqDx Integration Package. The following constraints are present when using the properties:

* Sequencing runs are matched using the flow cell ID and the base name of the sequencing step – MiSeqDx Run (MiSeqDx).
* Do not change this name – it is expected by the sequencing service that captures instrument run results. The base name is stored in the *sequenceProcessBaseName* property. If this name is changed without the property being updated, the 'flow cell ID <-> sequencing step base name' matching system will fail.
* If necessary, you may modify the step name by editing or adding to the text after the base name portion. This part of the text is not used in the matching system. For example, you could change MiSeqDx Run (MiSeqDx) 1.2 to MiSeqDx Run (MiSeqDx) v1.2.

{% hint style="danger" %}
Changes on *integration.miseqdx.seqservice.sequenceProcessBaseName* and *integration.miseqdx.seqservice.variantCallingProcessBaseName* properties take effect upon updates and do not require restart of the integration service. For all remaining properties, integration service must be restarted for property changes to take effect.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                                 | **Description**                                                                                                                                                                                               |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.miseqdx.seqservice.sequenceProcessBaseName       | <ul><li>Sequencing master step base display name. Partial matching is used to look up the process type.</li><li><strong>Default:</strong> Sequencing master step name (e.g., MiSeqDx Run (MiSeqDx))</li></ul> |
| integration.miseqdx.seqservice.variantCallingProcessBaseName | <ul><li>Sequencing process type base display name. Partial matching is used to look up the process type.</li><li><strong>Default:</strong> Variant Calling (MiSeqDx)</li></ul>                                |

Other properties installed by the integration:

{% hint style="info" %}
Modify these properties using */opt/gls/clarity/config/configure\_extensions\_miseqdx\_sequencingservice.sh*

* integration.miseqdx.seqservice.eventFileDirectory.1
* integration.miseqdx.seqservice.eventFileDirectory.99
* integration.miseqdx.seqservice.eventFileDirectorySuffixes
* integration.miseqdx.seqservice.ignoreUnmatchedContainerIds
* integration.miseqdx.seqservice.ignoreUnmatchedContainerIdsWaitDays
* integration.miseqdx.seqservice.netPathPrefixReplace.1
* integration.miseqdx.seqservice.netPathPrefixReplace.99
* integration.miseqdx.seqservice.netPathPrefixSearch.1
* integration.miseqdx.seqservice.netPathPrefixSearch.99
* integration.miseqdx.seqservice.netPathPrefixSearchReplaceSuffixes
  {% endhint %}

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.miseqdx.seqservice.runReportViewsVersion
* integration.miseqdx.seqservice.synchronizationPeriod
  {% endhint %}

## MiSeq i100 Series Cloud (v1.0.0 and onwards)

{% hint style="danger" %}
Changes on MiSeq i100 Series (Cloud) integration properties take effect upon updates and do not require restart of the SIS core service.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                                       | **Description**                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.miseqi100series.v1.allowedSequencingContainerTypes     | <ul><li>Supported container type(s) for the integration. Comma-separated.</li><li>Used by integration service.</li><li><strong>Default:</strong> MiSeq i100 Series Dry Cartridge</li></ul>                                                                                                                                                                                      |
| integration.miseqi100series.v1.autocompleteAnalysisStepOnFailure   | <ul><li>When <em>autocompleteAnalysisStepOnFailure</em> is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul>                                                                                               |
| integration.miseqi100series.v1.autocompleteSequencingStep          | <ul><li>When <em>autocompleteSequencingStep</em> is set to true, the integration service will automatically advance and complete the sequencing step upon handling the sequencing complete event.</li><li>Used by integration service.</li><li><strong>Default:</strong> true</li></ul>                                                                                         |
| integration.miseqi100series.v1.autocompleteSequencingStepOnFailure | <ul><li>When <em>autocompleteSequencingStepOnFailure</em> is set to true, the integration service will automatically advance, complete the sequencing step and remove the samples from the sequencing step workflow upon handling the sequencing complete event in the event of failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul> |
| integration.miseqi100series.v1.automatedAnalysisStepNameRegex      | <ul><li>⚠ Only applicable for MiSeq i100 Series Integration Package v1.1.0 and onwards.</li><li>The regex of the protocol step name for automated MiSeq i100 Series analysis run</li><li><strong>Default:</strong> ^AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v\[0-9]+.\[0-9]+)$</li></ul>                                                                         |
| integration.miseqi100series.v1.automatedAnalysisStepNames          | <ul><li>⚠ Only applicable for MiSeq i100 Series Integration Package v1.0.0.</li><li>Used by integration service.</li><li>Master step name(s) for automated analysis run tracking. Comma-separated</li><li><strong>Default:</strong> AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0)</li></ul>                                                                      |
| integration.miseqi100series.v1.automatedSequencingStepNameRegex    | <ul><li>⚠ Only applicable for MiSeq i100 Series Integration Package v1.1.0 and onwards.</li><li>The regex of the protocol step name for automated MiSeq i100 Series sequencing run</li><li><strong>Default:</strong> ^AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v\[0-9]+.\[0-9]+)$</li></ul>                                                                     |
| integration.miseqi100series.v1.automatedSequencingStepNames        | <ul><li>⚠ Only applicable for MiSeq i100 Series Integration Package v1.0.0.</li><li>Master step name(s) for automated sequencing run tracking. Comma-separated</li><li>Used by integration service.</li><li><strong>Default:</strong> AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0)</li></ul>                                                                  |
| integration.miseqi100series.v1.dryCartridgeBarcodeRegex            | <ul><li>Regular expression (Java) for validating Dry Cartridge serial barcode.</li><li>Used by integration service.</li><li><strong>Default:</strong> SC\[0-9]{7}-SC\[0-9]</li></ul>                                                                                                                                                                                            |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.miseqi100series.v1.bssh.api.uri
* integration.miseqi100series.v1.bssh.region
* integration.miseqi100series.v1.cloudAppSessionSlug
* integration.miseqi100series.v1.cloudDemuxStatsFileNameRegex
* integration.miseqi100series.v1.cloudDemuxStatsTopLevelDatasetRegex
* integration.miseqi100series.v1.ica.scopes
* integration.miseqi100series.v1.localAppSessionSlug
* integration.miseqi100series.v1.localDemuxStatsFileNameRegex
* integration.miseqi100series.v1.localDemuxStatsTopLevelDatasetRegex
* integration.miseqi100series.v1.maxWaitingTimeInSeconds
* integration.miseqi100series.v1.workgroupid
  {% endhint %}

## MiSeq i100 Series On-Prem (v1.0.0 and onwards)

Properties that are configurable via System Setting

| **Property**                                                                   | **Description**                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.illuminaRunManager.miseqi100series.analysisAutocompleteOnFailure   | <ul><li>Boolean flag to control integration should auto-complete analysis step if the run is failed.</li><li><strong>Default:</strong> false</li></ul>                                                                                                               |
| integration.illuminaRunManager.miseqi100series.analysisStepPatterns            | <ul><li>The regex pattern for AUTOMATED analysis step name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">AUTOMATED - Analysis Run (MiSeq i100 Series On-Prem Sequencing v\[0-9]+.\[0-9]+)     |
| </code></pre></li></ul>                                                        |                                                                                                                                                                                                                                                                      |
| integration.illuminaRunManager.miseqi100series.sequencingAutocompleteOnFailure | <ul><li>Boolean flag to control integration should auto-complete sequencing step if the run is failed.</li><li><strong>Default:</strong> false</li></ul>                                                                                                             |
| integration.illuminaRunManager.miseqi100series.sequencingStepPatterns          | <ul><li>The regex pattern for AUTOMATED sequencing step name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">AUTOMATED - Sequencing Run (MiSeq i100 Series On-Prem Sequencing v\[0-9]+.\[0-9]+) |
| </code></pre></li></ul>                                                        |                                                                                                                                                                                                                                                                      |
| integration.illuminaRunManager.miseqi100series.workflowNamePattern             | <ul><li>The regex pattern for MiSeq i100 Series workflow name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">MiSeq i100 Series On-Prem v\[0-9]+.\[0-9]+                                        |
| </code></pre></li></ul>                                                        |                                                                                                                                                                                                                                                                      |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.illuminaRunManager.miseqi100series.analysisEndedRecipe
* integration.illuminaRunManager.miseqi100series.analysisStartedRecipe
* integration.illuminaRunManager.miseqi100series.handlerMaxAttempts
* integration.illuminaRunManager.miseqi100series.handlerMaxRetryIntervalInSeconds
* integration.illuminaRunManager.miseqi100series.handlerMinRetryIntervalInSeconds
* integration.illuminaRunManager.miseqi100series.sequencingEndedRecipe
* integration.illuminaRunManager.miseqi100series.sequencingStartedRecipe
* integration.illuminaRunManager.miseqi100series.supportedInstrumentTypes
  {% endhint %}

## NextSeq 500/550 (v2.4.0 and onwards)

{% hint style="info" %}
Sequencing runs are matched using the reagent cartridge ID and the sequencing steps base name. Do not change the base name. The name is expected by the sequencing service that captures instrument run results. The base name is stored in the *sequenceProcessBaseName* property. If this name is changed without the property being updated, the 'reagent cartridge ID <-> sequencing step base name' matching system fails. If necessary, modify the step name by editing or adding text after the base name portion, as it is not used in the matching system. For example, change NextSeq 500/550 Run (NextSeq 500/550 v1.1) to NextSeq 500/550 Run (NextSeq 500/550 v1.1) v2.
{% endhint %}

{% hint style="info" %}
Changes on *integration.nextseq.v2.seqservice.sequenceProcessBaseName* property take effect upon updates and do not require restart of the integration service. For all remaining properties, integration service has to be restarted for property changes to take effect.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                              | **Description**                                                                                                                                                                                                                  |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.nextseq.v2.seqservice.sequenceProcessBaseName | <ul><li>Sequencing master step base display name. Partial matching is used to look up the master step.</li><li><strong>Default:</strong> Sequencing master step name (e.g. NextSeq 500/550 Run (NextSeq 500/550 v1.1))</li></ul> |

Other properties installed by the integration:

{% hint style="info" %}
Modify these properties using */opt/gls/clarity/config/configure\_extensions\_nextseq\_sequencingservice.sh*

* integration.nextseq.v2.seqservice.eventFileDirectory.1
* integration.nextseq.v2.seqservice.eventFileDirectory.99
* integration.nextseq.v2.seqservice.eventFileDirectorySuffixes
* integration.nextseq.v2.seqservice.ignoreUnmatchedContainerIds
* integration.nextseq.v2.seqservice.ignoreUnmatchedContainerIdsWaitDays
* integration.nextseq.v2.seqservice.netPathPrefixReplace.1
* integration.nextseq.v2.seqservice.netPathPrefixReplace.99
* integration.nextseq.v2.seqservice.netPathPrefixSearch.1
* integration.nextseq.v2.seqservice.netPathPrefixSearch.99
* integration.nextseq.v2.seqservice.netPathPrefixSearchReplaceSuffixes
  {% endhint %}

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.nextseq.v2.seqservice.runReportViewsVersion
* integration.nextseq.v2.seqservice.synchronizationPeriod
  {% endhint %}

## NextSeq 1000/2000 Cloud (v2.5.0 and onwards)

NextSeq 1000/2000 integration uses the SIS core service. Refer to [SIS Core](#sis-core-v260-and-onwards) for common properties of the SIS core service.

{% hint style="danger" %}
Changes on NextSeq 1000/2000 integration properties take effect upon updates and do not require restart of the SIS core service.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                               | **Description**                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| integration.nextseq1k2k.v2.allowedSequencingContainerTypes | <ul><li>Supported container type(s) for NextSeq 1000/2000 integration.</li><li>Delimited by comma(,).</li><li>Used by integration service.</li><li><strong>Default:</strong> NextSeq 1000/2000 Reagent Cartridge</li></ul>                                                                                                                                                                                               |
| integration.nextseq1k2k.v2.analysisStepNames               | <ul><li>Master step name(s) for automated NextSeq 1000/2000 analysis run.</li><li>Delimited by comma(,).</li><li>Used by integration service for analysis run tracking.</li><li><strong>Default:</strong> Master step name for analysis run step (e.g., Demultiplexing (NextSeq 1000/2000 Sequencing v2.4))</li></ul>                                                                                                    |
| integration.nextseq1k2k.v2.automatedStepNames              | <ul><li>Master step name(s) for automated NextSeq 1000/2000 sequencing run</li><li>Delimited by comma(,).</li><li>Used by integration service for sequencing run tracking</li><li><strong>Default:</strong> Master step name for sequencing run step (e.g., AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.4))</li></ul>                                                                                    |
| integration.nextseq1k2k.v2.reagentBarcodeRegex             | <ul><li><p>Regular expression (Java)</p><blockquote><p>⚠ It should be less strict than or as strict as the actual reagent barcode regex</p></blockquote></li><li>Used by integration service to validate if the container name is valid before processing the event.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">\[A-Z]{2}\[0-9]{7}-\[A-Z0-9]{4} |
| </code></pre></li></ul>                                    |                                                                                                                                                                                                                                                                                                                                                                                                                          |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.nextseq1k2k.v2.analysis.metricsFilesToZip
* integration.nextseq1k2k.v2.bssh.api.uri
* integration.nextseq1k2k.v2.bssh.region
* integration.nextseq1k2k.v2.cloudAnalysisLocationPropertyName
* integration.nextseq1k2k.v2.cloudAppSessionSlugToMetricsDataset
* integration.nextseq1k2k.v2.cloudRunIdPropertyName
* integration.nextseq1k2k.v2.ica.api.uri
* integration.nextseq1k2k.v2.ica.scopes
* integration.nextseq1k2k.v2.localAppSessionSlugToMetricsDataset
* integration.nextseq1k2k.v2.maxWaitingTimeInSeconds
* integration.nextseq1k2k.v2.workgroupid
  {% endhint %}

## NextSeq 1000/2000 On-Prem (v1.0.0 and onwards)

{% hint style="danger" %}
Except for the following properties, property updates require the integration service to be restarted to take effect:

* integration.nextseq1k2k-onprem.v1.sequenceStepBaseName
* integration.nextseq1k2k-onprem.v1.demultiplexStepBaseName
* integration.nextseq1k2k-onprem.v1.analysis.metricsFilesToZip
* integration.nextseq1k2k-onprem.v1.sampleSheetDir
  {% endhint %}

| **Property**                                                       | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | **Configurable via System Setting** |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| integration.nextseq1k2k-onprem-v1.analysis.metricsFilesToZip       | <ul><li>The comma-separated list of files that the integration service compresses and zips for upload to the Demultiplexing step in Clarity LIMS.</li><li>These files must be in the same directory as the <em>Demultiplex\_Stats.csv</em> file (for example, /mnt/run\_data/\<run\_name>/Analysis/1/Data/Reports).</li><li>Used by integration service.</li><li><strong>Default:</strong> Adapter\_Metrics.csv,Demultiplex\_Stats.csv,Index\_Hopping\_Counts.csv,Quality\_Metrics.csv,Top\_Unknown\_Barcodes.csv</li></ul> | No                                  |
| integration.nextseq1k2k-onprem-v1.analysis.demultiplexStepBaseName | <ul><li>The substring that the integration service uses to find the semi-automated demultiplexing step.</li><li>Used by integration service.</li><li><strong>Default:</strong> Demultiplexing (NextSeq 1000/2000 On-Prem</li></ul>                                                                                                                                                                                                                                                                                          | No                                  |
| integration.nextseq1k2k-onprem-v1.analysis.sequenceStepBaseName    | <ul><li>The substring that the integration service uses to find the automated sequencing run step.</li><li>Used by integration service.</li><li><strong>Default:</strong> AUTOMATED - Sequencing Run (NextSeq 1000/2000 On-Prem</li></ul>                                                                                                                                                                                                                                                                                   | No                                  |
| integration.nextseq1k2k-onprem-v1.sampleSheetDir                   | <ul><li>The location of the copied generated sample sheet. This location is the same as the sample sheet directory from Prerequisite 2: Clarity LIMS with NAS Share and Mount Points (Refer to Installation guide for the appropriate version of the integration).</li><li>Used by automation script.</li><li><strong>Default:</strong> /mnt/sample\_sheet</li></ul>                                                                                                                                                        | No                                  |

Other properties installed by the integration:

{% hint style="info" %}
Modify these properties using */opt/gls/clarity/config/configure\_nextseq1k2k\_onprem.sh*

* integration.nextseq1k2k-onprem-v1.runFolderParentDir
  {% endhint %}

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.nextseq1k2k-onprem.v1.maxRetryAttempts
* integration.nextseq1k2k-onprem.v1.pollingInterval
* integration.nextseq1k2k-onprem.v1.retryInterval
  {% endhint %}

## NovaSeq 6000 File-Based (v2.6.0 and onwards)

{% hint style="info" %}
Changes on *integration.novaseq.seqservice.sequenceProcessBaseName* property take effect upon updates and do not require restart of the integration service. For all remaining properties, integration service must be restarted for property changes to take effect.
{% endhint %}

| **Property**                                           | **Description**                                                                                                                                                       |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.novaseq.seqservice.sequenceProcessBaseName | <ul><li>Sequencing master step display name. Partial matching is used to lookup the process type.</li><li><strong>Default:</strong> AUTOMATED - NovaSeq Run</li></ul> |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.novaseq.runSetupFolder
* integration.novaseq.sampleSheetPathPrefixReplace.1
* integration.novaseq.sampleSheetPathPrefixReplace.99
* integration.novaseq.sampleSheetPathPrefixSearch.1
* integration.novaseq.sampleSheetPathPrefixSearch.99
* integration.novaseq.sampleSheetPathPrefixSearchReplaceSuffixes
* integration.novaseq.seqservice.maximumRedeliveryAttempts
* integration.novaseq.seqservice.netPathPrefixReplace.1
* integration.novaseq.seqservice.netPathPrefixReplace.99
* integration.novaseq.seqservice.netPathPrefixSearch.1
* integration.novaseq.seqservice.netPathPrefixSearch.99
* integration.novaseq.seqservice.netPathPrefixSearchReplaceSuffixes
* integration.novaseq.seqservice.redeliveryDelay
* integration.novaseq.seqservice.synchronizationPeriod
  {% endhint %}

## NovaSeq X Series Cloud (v1.3.0 and onwards)

{% hint style="danger" %}
Changes on NovaSeq X Series (Cloud) integration properties take effect upon updates and do not require restart of the SIS core service.
{% endhint %}

| **Property**                                                      | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.novaseqxseries.v1.allowedSequencingContainerTypes     | <ul><li>Supported container type(s) for NovaSeq X Series (Cloud) integration.</li><li>Delimited by comma(,).</li><li>Used by integration service.</li><li><strong>Default:</strong> Library 2-tube Strip,Library 8-tube Strip</li></ul>                                                                                                                                                                                                   |
| integration.novaseqxseries.v1.autocompleteAnalysisStepOnFailure   | <ul><li>When <em>autocompleteAnalysisStepOnFailure</em> is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul>                                                                                                                                                         |
| integration.novaseqxseries.v1.autocompleteSequencingStep          | <ul><li>When <em>autocompleteSequencingStep</em> is set to true, the integration service will automatically advance and complete the sequencing step upon handling the sequencing complete event.</li><li>Used by integration service.</li><li><strong>Default:</strong> true</li></ul>                                                                                                                                                   |
| integration.novaseqxseries.v1.autocompleteSequencingStepOnFailure | <ul><li>When <em>autocompleteSequencingStepOnFailure</em> is set to true, the integration service will automatically advance, complete the sequencing step and remove the samples from the sequencing step workflow upon handling the sequencing complete event in the event of failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul>                                                           |
| integration.novaseqxseries.v1.automatedAnalysisStepNameRegex      | <ul><li>The regex of Master step name for automated NovaSeq X Series analysis run</li><li><strong>Default:</strong> ^AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v\[0-9]+.\[0-9]+)$</li></ul>                                                                                                                                                                                                                                   |
| integration.novaseqxseries.v1.automatedSequencingStepNameRegex    | <ul><li>The regex of Master step name for automated NovaSeq X Series sequencing run</li><li><strong>Default:</strong> ^AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v\[0-9]+.\[0-9]+)$</li></ul>                                                                                                                                                                                                                               |
| integration.novaseqxseries.v1.libraryTubeStripRegex               | <ul><li><p>Regular expression (Java)</p><blockquote><p>⚠ It should be less strict than or as strict as the actual library tube strip barcode regex</p></blockquote></li><li>Used by integration service to validate if the container name is valid before processing the event.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">\[A-Za-z]{2}\[0-9]{7}-\[A-Za-z0-9]{3} |
| </code></pre></li></ul>                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                           |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.novaseqxseries.v1.bssh.api.uri
* integration.novaseqxseries.v1.bssh.region
* integration.novaseqxseries.v1.cloudAppSessionSlug
* integration.novaseqxseries.v1.cloudDemuxStatsFileNameRegex
* integration.novaseqxseries.v1.cloudDemuxStatsTopLevelDatasetRegex
* integration.novaseqxseries.v1.cloudHighLevelSummaryFileNameRegex
* integration.novaseqxseries.v1.cloudHighLevelSummaryTopLevelDatasetRegex
* integration.novaseqxseries.v1.ica.api.uri
* integration.novaseqxseries.v1.ica.scopes
* integration.novaseqxseries.v1.localAppSessionSlug
* integration.novaseqxseries.v1.localDemuxStatsFileNameRegex
* integration.novaseqxseries.v1.localDemuxStatsTopLevelDatasetRegex
* integration.novaseqxseries.v1.localHighLevelSummaryFileNameRegex
* integration.novaseqxseries.v1.localHighLevelSummaryTopLevelDatasetRegex
* integration.novaseqxseries.v1.maxWaitingTimeInSeconds
* integration.novaseqxseries.v1.workgroupid
  {% endhint %}

## NovaSeq X Series On-Prem (v1.0.0 and onwards)

{% hint style="danger" %}
NovaSeq X Series On-Prem integration requires installation of IRM integration service. Changes on NovaSeq X Series (On-Prem) integration properties take effect upon updates and do not require restart of the IRM integration service.
{% endhint %}

Properties that are configurable via System Setting

| **Property**                                                                  | **Description**                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.illuminaRunManager.novaseqxseries.analysisAutocompleteOnFailure   | <ul><li>When <em>analysisAutocompleteOnFailure</em> is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul>                                                                                               |
| integration.illuminaRunManager.novaseqxseries.analysisStepPatterns            | <ul><li>The regex pattern for AUTOMATED analysis step name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">AUTOMATED - Analysis Run (NovaSeq X Series On-Prem Sequencing v\[0-9]+.\[0-9]+)                                                                                                             |
| </code></pre></li></ul>                                                       |                                                                                                                                                                                                                                                                                                                                                                             |
| integration.illuminaRunManager.novaseqxseries.sequencingAutocompleteOnFailure | <ul><li>When <em>sequencingAutocompleteOnFailure</em> is set to true, the integration service will automatically advance, complete the sequencing step and remove the samples from the sequencing step workflow upon handling the sequencing complete event in the event of failure.</li><li>Used by integration service.</li><li><strong>Default:</strong> false</li></ul> |
| integration.illuminaRunManager.novaseqxseries.sequencingStepPatterns          | <ul><li>The regex pattern for AUTOMATED sequencing step name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">AUTOMATED - Sequencing Run (NovaSeq X Series On-Prem Sequencing v\[0-9]+.\[0-9]+)                                                                                                         |
| </code></pre></li></ul>                                                       |                                                                                                                                                                                                                                                                                                                                                                             |
| integration.illuminaRunManager.novaseqxseries.workflowNamePattern             | <ul><li>The regex pattern for NovaSeq X Series workflow name.</li><li><p><strong>Default:</strong></p><pre class="language-markup" data-overflow="wrap"><code class="lang-markup">NovaSeq X Series On-Prem v\[0-9]+.\[0-9]+                                                                                                                                                 |
| </code></pre></li></ul>                                                       |                                                                                                                                                                                                                                                                                                                                                                             |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.illuminaRunManager.novaseqxseries.analysisEndedRecipe
* integration.illuminaRunManager.novaseqxseries.analysisStartedRecipe
* integration.illuminaRunManager.novaseqxseries.handlerMaxAttempts
* integration.illuminaRunManager.novaseqxseries.handlerMaxRetryIntervalInSeconds
* integration.illuminaRunManager.novaseqxseries.handlerMinRetryIntervalInSeconds
* integration.illuminaRunManager.novaseqxseries.sequencingEndedRecipe
* integration.illuminaRunManager.novaseqxseries.sequencingStartedRecipe
* integration.illuminaRunManager.novaseqxseries.supportedInstrumentTypes
  {% endhint %}

## Sequencer-API (v2.7.0 and onwards)

NovaSeq 6000 API-based and NovaSeq 6000 Dx integrations use the Sequencer-API integration service.

{% hint style="danger" %}
Changes on Sequencer-API properties take effect upon updates and do not require restart of the Clarity LIMS except for properties in *application.yml* file. The property names should not be modified.
{% endhint %}

The *application.yml* file is at

{% code overflow="wrap" %}

```markup
opt/gls/clarity/extensions/sequencer-api/*
```

{% endcode %}

All properties are configured automatically during installation, but they can also be configured by editing the *application.yml* file and then restarting Tomcat.

**Properties in application.yml**

| **Property**           | **Description**                                                                                                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| spring.profiles.active | <ul><li>Tells the application that it is running deployed in Tomcat.</li><li><p><strong>Default:</strong> tomcat</p><blockquote><p>⚠ Do not change</p></blockquote></li></ul>               |
| clarity.url            | <ul><li>Base URL that the Sequencer API service uses to contact the Clarity LIMS. The installation script (<em>configure\_sequencer\_api\_application</em>) prompts for this URL.</li></ul> |
| clarity.username       | <ul><li>Username to be used when communicating with Clarity LIMS.</li></ul>                                                                                                                 |
| security.token-expiry  | <ul><li>Specifies (in hours) the expiry period for login tokens issued by the Sequencer API.</li><li><strong>Default:</strong> 88</li></ul>                                                 |

**Properties in Database**

Properties that are configurable via System Setting

| **Property**                                                | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| integration.sequencer\_api.v2.novaseq.sequenceStepNames     | <ul><li><p>List of NovaSeq sequencing run step names for which the integration can find samples queued.</p><ul><li>Names must be an exact match to the name of the step in Clarity LIMS (not the master step/process type).</li><li>Each line must be indented to the same point and start with a dash (-).</li></ul></li><li><p><strong>Default:</strong> Sequencing run step names. Example given below.</p><ul><li>- "AUTOMATED - NovaSeq Run (NovaSeq 6000 v3.8)"</li><li>- "AUTOMATED - NovaSeqDx Run (NovaSeqDx v1.1)"</li></ul></li></ul>                                             |
| integration.sequencer\_api.v2.run.autoComplete              | <ul><li><p>Determines whether the sequencing run step must be completed automatically after parsing the run metrics on a run along with <em>run.autoCompleteOnlyAtSuccess</em>.</p><blockquote><p>ℹ For more information, refer to Configuring autoComplete Properties section in Configuration guides for NovaSeq 6000 API-based or NovaSeq 6000Dx API-based integrations.</p></blockquote></li><li><strong>Default:</strong> true</li></ul>                                                                                                                                                |
| integration.sequencer\_api.v2.run.autoCompleteOnlyAtSuccess | <ul><li><p>Determines which of the following options that the sequencing run step must be:</p><ul><li>Autocompleted when the run status is RunCompletedSuccessfully (if <em>autoCompleteOnlyAtSuccess</em> is true)</li><li>Autocompleted regardless of the run status (if <em>autoCompleteOnlyAtSuccess</em> is false).</li></ul><blockquote><p>ℹ For more information, refer to Configuring autoComplete Properties section in Configuration guides for NovaSeq 6000 API-based or NovaSeq 6000Dx API-based integrations.</p></blockquote></li><li><strong>Default:</strong> true</li></ul> |

Other properties installed by the integration:

{% hint style="danger" %}
Do not modify the properties in this list:

* app.oauth2.sequencer\_api.signingKey
* integration.sequencer\_api.v2.novaseq.flowcells
* integration.sequencer\_api.v2.novaseq.reagents
* integration.sequencer\_api.v2.novaseq.useReagentValidation
* integration.sequencer\_api.v2.novaseq.useSerialNumberForReagentLotNumber
* integration.sequencer\_api.v2.recipe.udfNames
* integration.sequencer\_api.v2.recipe.sampleSheet.outputName
* integration.sequencer\_api.v2.recipe.sampleSheet.notAvailableValue
* integration.sequencer\_api.v2.run.stepUdfNames
* integration.sequencer\_api.v2.run.metricUdfNames
  {% endhint %}

## SIS Core (v2.6.0 and onwards)

{% hint style="danger" %}
Do not modify the properties in this list:

* integration.sis.v2.maxNumberOfMessages
* integration.sis.v2.receiveMessageWaitTimeSeconds
* integration.sis.v2.maxMessageHandlingRetryTimes
* integration.sis.v2.sqsPollingInterval

In the event that the properties are updated, SIS core service must be restarted for updated property values to take effect.
{% endhint %}

## Revision History

| **Version** | **Changes**                                                                                                                                                                                                                                                                                                                               |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 3           | <ul><li>Updated properties of MiSeq i100 Series (cloud) and Illumina Run Manager.</li></ul>                                                                                                                                                                                                                                               |
| 2           | <ul><li>Added properties of Illumina Run Manager, NovaSeq X Series (cloud and on-premise), MiSeq i100 Series (cloud and on-premise).</li><li>Updated properties of existing integrations to only reflect details of properties that can be configured by user.</li><li>Reordered sections in alphabetical order of integration.</li></ul> |
| 1           | <ul><li>Initial release.</li></ul>                                                                                                                                                                                                                                                                                                        |
