arrow-left

All pages
gitbookPowered by GitBook
1 of 2

Loading...

Loading...

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.

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

triangle-exclamation

Changes on Illumina Run Manager integration properties take effect upon updates and do not require restart of Clarity.

hashtag
iScan (v1.2.0 and onwards)

The iScan integration uses the SIS core service. Refer to for common properties of the SIS core service.

triangle-exclamation

Changes on iScan integration properties take effect upon updates and do not require restart of the SIS core service.

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.iscan.v1.ica.api.uri

  • integration.iscan.v1.ica.scopes

hashtag
MiSeq (v8.3.0 and onwards)

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

triangle-exclamation

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.

triangle-exclamation

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.

Properties that are configurable via System Setting

Other properties installed by the integration:

circle-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

triangle-exclamation

Do not modify the properties in this list:

  • integration.miseq.v8.seqservice.runReportViewsVersion

  • integration.miseq.v8.seqservice.synchronizationPeriod

hashtag
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.

triangle-exclamation

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.

Properties that are configurable via System Setting

Other properties installed by the integration:

circle-info

Modify these properties using /opt/gls/clarity/config/configure_extensions_miseqdx_sequencingservice.sh

  • integration.miseqdx.seqservice.eventFileDirectory.1

  • integration.miseqdx.seqservice.eventFileDirectory.99

triangle-exclamation

Do not modify the properties in this list:

  • integration.miseqdx.seqservice.runReportViewsVersion

  • integration.miseqdx.seqservice.synchronizationPeriod

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

triangle-exclamation

Changes on MiSeq i100 Series (Cloud) integration properties take effect upon updates and do not require restart of the SIS core service.

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.miseqi100series.v1.bssh.api.uri

  • integration.miseqi100series.v1.bssh.region

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

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.illuminaRunManager.miseqi100series.analysisEndedRecipe

  • integration.illuminaRunManager.miseqi100series.analysisStartedRecipe

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

circle-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.

circle-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.

Properties that are configurable via System Setting

Other properties installed by the integration:

circle-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

triangle-exclamation

Do not modify the properties in this list:

  • integration.nextseq.v2.seqservice.runReportViewsVersion

  • integration.nextseq.v2.seqservice.synchronizationPeriod

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

NextSeq 1000/2000 integration uses the SIS core service. Refer to for common properties of the SIS core service.

triangle-exclamation

Changes on NextSeq 1000/2000 integration properties take effect upon updates and do not require restart of the SIS core service.

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.nextseq1k2k.v2.analysis.metricsFilesToZip

  • integration.nextseq1k2k.v2.bssh.api.uri

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

triangle-exclamation

Except for the following properties, property updates require the integration service to be restarted to take effect:

  • integration.nextseq1k2k-onprem.v1.sequenceStepBaseName

Other properties installed by the integration:

circle-info

Modify these properties using /opt/gls/clarity/config/configure_nextseq1k2k_onprem.sh

  • integration.nextseq1k2k-onprem-v1.runFolderParentDir

triangle-exclamation

Do not modify the properties in this list:

  • integration.nextseq1k2k-onprem.v1.maxRetryAttempts

  • integration.nextseq1k2k-onprem.v1.pollingInterval

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

circle-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.

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.novaseq.runSetupFolder

  • integration.novaseq.sampleSheetPathPrefixReplace.1

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

triangle-exclamation

Changes on NovaSeq X Series (Cloud) integration properties take effect upon updates and do not require restart of the SIS core service.

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.novaseqxseries.v1.bssh.api.uri

  • integration.novaseqxseries.v1.bssh.region

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

triangle-exclamation

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.

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • integration.illuminaRunManager.novaseqxseries.analysisEndedRecipe

  • integration.illuminaRunManager.novaseqxseries.analysisStartedRecipe

hashtag
Sequencer-API (v2.7.0 and onwards)

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

triangle-exclamation

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.

The application.yml file is at

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

Properties in Database

Properties that are configurable via System Setting

Other properties installed by the integration:

triangle-exclamation

Do not modify the properties in this list:

  • app.oauth2.sequencer_api.signingKey

  • integration.sequencer_api.v2.novaseq.flowcells

hashtag
SIS Core (v2.6.0 and onwards)

triangle-exclamation

Do not modify the properties in this list:

  • integration.sis.v2.maxNumberOfMessages

  • integration.sis.v2.receiveMessageWaitTimeSeconds

hashtag
Revision History

integration.iscan.v1.workgroupid

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

  • 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

    • âš  Only applicable for MiSeq i100 Series Integration Package v1.1.0 and onwards.

    • The regex of the protocol step name for automated MiSeq i100 Series sequencing run

    • Default: ^AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v[0-9]+.[0-9]+)$

    integration.miseqi100series.v1.automatedSequencingStepNames

    • âš  Only applicable for MiSeq i100 Series Integration Package v1.0.0.

    • Master step name(s) for automated sequencing run tracking. Comma-separated

    • Used by integration service.

    integration.miseqi100series.v1.dryCartridgeBarcodeRegex

    • Regular expression (Java) for validating Dry Cartridge serial barcode.

    • Used by integration service.

    • Default: SC[0-9]{7}-SC[0-9]

  • 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

  • integration.illuminaRunManager.miseqi100series.handlerMaxAttempts

  • integration.illuminaRunManager.miseqi100series.handlerMaxRetryIntervalInSeconds

  • integration.illuminaRunManager.miseqi100series.handlerMinRetryIntervalInSeconds

  • integration.illuminaRunManager.miseqi100series.sequencingEndedRecipe

  • integration.illuminaRunManager.miseqi100series.sequencingStartedRecipe

  • integration.illuminaRunManager.miseqi100series.supportedInstrumentTypes

  • 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

  • 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

  • integration.nextseq1k2k-onprem.v1.demultiplexStepBaseName
  • integration.nextseq1k2k-onprem.v1.analysis.metricsFilesToZip

  • integration.nextseq1k2k-onprem.v1.sampleSheetDir

  • integration.nextseq1k2k-onprem.v1.retryInterval

  • 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

    • Regular expression (Java)

      âš  It should be less strict than or as strict as the actual library tube strip barcode regex

    • Used by integration service to validate if the container name is valid before processing the event.

  • 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

  • integration.illuminaRunManager.novaseqxseries.handlerMaxAttempts

  • integration.illuminaRunManager.novaseqxseries.handlerMaxRetryIntervalInSeconds

  • integration.illuminaRunManager.novaseqxseries.handlerMinRetryIntervalInSeconds

  • integration.illuminaRunManager.novaseqxseries.sequencingEndedRecipe

  • integration.illuminaRunManager.novaseqxseries.sequencingStartedRecipe

  • integration.illuminaRunManager.novaseqxseries.supportedInstrumentTypes

  • 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

  • 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.

    Property

    Description

    Configurable via System Setting

    integration.illuminaRunManager.pns.privateCaFilePath

    • âš  Only applicable for Illumina Run Manager Integration Package v1.0.0.

    • Absolute path of private certificate authority (CA) chain file in PEM format.

    • Used by integration service

    No

    Property

    Description

    integration.iscan.v1.autoCompleteAnalysisWorkflow

    • Boolean flag to control on/off analysis workflow auto-completion if the analysis is successful.

    • Used by integration service

    • Default: true

    integration.iscan.v1.autoCompleteWorkflow

    • Boolean flag to control on/off imaging run workflow auto-completion if the run is successful.

    • Used by integration service.

    • Default: true

    integration.iscan.v1.autoCompleteWorkflowUponFailure

    • Boolean flag to control on/off imaging run workflow auto-completion if the run is failed

    • Used by integration service

    • Default: false

    integration.iscan.v1.supportedAnalysisWorkflowStepNamePattern

    • The regex pattern for analysis step name which is supported by iScan integration.

    • Used by integration service.

    • Default:

    integration.iscan.v1.supportedImagingWorkflowStepNamePattern

    • The regex pattern for imaging step name which is supported by iScan integration.

    • Used by integration service.

    • Default:

    Property

    Description

    integration.miseq.v8.seqservice.sequenceProcessBaseName

    • Sequencing master step base display name. Partial matching is used to look up the master step. This property is added/updated by Illumina Preset Protocols (IPP) during the workflow installation.

    • Default: Sequencing master step name (e.g., MiSeq Run (MiSeq v3.2))

    Property

    Description

    integration.miseqdx.seqservice.sequenceProcessBaseName

    • Sequencing master step base display name. Partial matching is used to look up the process type.

    • Default: Sequencing master step name (e.g., MiSeqDx Run (MiSeqDx))

    integration.miseqdx.seqservice.variantCallingProcessBaseName

    • Sequencing process type base display name. Partial matching is used to look up the process type.

    • Default: Variant Calling (MiSeqDx)

    Property

    Description

    integration.miseqi100series.v1.allowedSequencingContainerTypes

    • Supported container type(s) for the integration. Comma-separated.

    • Used by integration service.

    • Default: MiSeq i100 Series Dry Cartridge

    integration.miseqi100series.v1.autocompleteAnalysisStepOnFailure

    • When autocompleteAnalysisStepOnFailure is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.

    • Used by integration service.

    • Default: false

    integration.miseqi100series.v1.autocompleteSequencingStep

    • When autocompleteSequencingStep is set to true, the integration service will automatically advance and complete the sequencing step upon handling the sequencing complete event.

    • Used by integration service.

    • Default: true

    integration.miseqi100series.v1.autocompleteSequencingStepOnFailure

    • When autocompleteSequencingStepOnFailure 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.

    • Used by integration service.

    • Default: false

    integration.miseqi100series.v1.automatedAnalysisStepNameRegex

    • âš  Only applicable for MiSeq i100 Series Integration Package v1.1.0 and onwards.

    • The regex of the protocol step name for automated MiSeq i100 Series analysis run

    • Default: ^AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v[0-9]+.[0-9]+)$

    integration.miseqi100series.v1.automatedAnalysisStepNames

    • âš  Only applicable for MiSeq i100 Series Integration Package v1.0.0.

    • Used by integration service.

    • Master step name(s) for automated analysis run tracking. Comma-separated

    • Default: AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0)

    Property

    Description

    integration.illuminaRunManager.miseqi100series.analysisAutocompleteOnFailure

    • Boolean flag to control integration should auto-complete analysis step if the run is failed.

    • Default: false

    integration.illuminaRunManager.miseqi100series.analysisStepPatterns

    • The regex pattern for AUTOMATED analysis step name.

    • Default:

    integration.illuminaRunManager.miseqi100series.sequencingAutocompleteOnFailure

    • Boolean flag to control integration should auto-complete sequencing step if the run is failed.

    • Default: false

    integration.illuminaRunManager.miseqi100series.sequencingStepPatterns

    • The regex pattern for AUTOMATED sequencing step name.

    • Default:

    integration.illuminaRunManager.miseqi100series.workflowNamePattern

    • The regex pattern for MiSeq i100 Series workflow name.

    • Default:

    Property

    Description

    integration.nextseq.v2.seqservice.sequenceProcessBaseName

    • Sequencing master step base display name. Partial matching is used to look up the master step.

    • Default: Sequencing master step name (e.g. NextSeq 500/550 Run (NextSeq 500/550 v1.1))

    Property

    Description

    integration.nextseq1k2k.v2.allowedSequencingContainerTypes

    • Supported container type(s) for NextSeq 1000/2000 integration.

    • Delimited by comma(,).

    • Used by integration service.

    • Default: NextSeq 1000/2000 Reagent Cartridge

    integration.nextseq1k2k.v2.analysisStepNames

    • Master step name(s) for automated NextSeq 1000/2000 analysis run.

    • Delimited by comma(,).

    • Used by integration service for analysis run tracking.

    • Default: Master step name for analysis run step (e.g., Demultiplexing (NextSeq 1000/2000 Sequencing v2.4))

    integration.nextseq1k2k.v2.automatedStepNames

    • Master step name(s) for automated NextSeq 1000/2000 sequencing run

    • Delimited by comma(,).

    • Used by integration service for sequencing run tracking

    • Default: Master step name for sequencing run step (e.g., AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.4))

    integration.nextseq1k2k.v2.reagentBarcodeRegex

    • Regular expression (Java)

      âš  It should be less strict than or as strict as the actual reagent barcode regex

    • Used by integration service to validate if the container name is valid before processing the event.

    • Default:

    Property

    Description

    Configurable via System Setting

    integration.nextseq1k2k-onprem-v1.analysis.metricsFilesToZip

    • The comma-separated list of files that the integration service compresses and zips for upload to the Demultiplexing step in Clarity LIMS.

    • These files must be in the same directory as the Demultiplex_Stats.csv file (for example, /mnt/run_data/<run_name>/Analysis/1/Data/Reports).

    • Used by integration service.

    • Default: Adapter_Metrics.csv,Demultiplex_Stats.csv,Index_Hopping_Counts.csv,Quality_Metrics.csv,Top_Unknown_Barcodes.csv

    No

    integration.nextseq1k2k-onprem-v1.analysis.demultiplexStepBaseName

    • The substring that the integration service uses to find the semi-automated demultiplexing step.

    • Used by integration service.

    • Default: Demultiplexing (NextSeq 1000/2000 On-Prem

    No

    integration.nextseq1k2k-onprem-v1.analysis.sequenceStepBaseName

    • The substring that the integration service uses to find the automated sequencing run step.

    • Used by integration service.

    • Default: AUTOMATED - Sequencing Run (NextSeq 1000/2000 On-Prem

    No

    integration.nextseq1k2k-onprem-v1.sampleSheetDir

    • 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).

    • Used by automation script.

    • Default: /mnt/sample_sheet

    No

    Property

    Description

    integration.novaseq.seqservice.sequenceProcessBaseName

    • Sequencing master step display name. Partial matching is used to lookup the process type.

    • Default: AUTOMATED - NovaSeq Run

    Property

    Description

    integration.novaseqxseries.v1.allowedSequencingContainerTypes

    • Supported container type(s) for NovaSeq X Series (Cloud) integration.

    • Delimited by comma(,).

    • Used by integration service.

    • Default: Library 2-tube Strip,Library 8-tube Strip

    integration.novaseqxseries.v1.autocompleteAnalysisStepOnFailure

    • When autocompleteAnalysisStepOnFailure is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.

    • Used by integration service.

    • Default: false

    integration.novaseqxseries.v1.autocompleteSequencingStep

    • When autocompleteSequencingStep is set to true, the integration service will automatically advance and complete the sequencing step upon handling the sequencing complete event.

    • Used by integration service.

    • Default: true

    integration.novaseqxseries.v1.autocompleteSequencingStepOnFailure

    • When autocompleteSequencingStepOnFailure 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.

    • Used by integration service.

    • Default: false

    integration.novaseqxseries.v1.automatedAnalysisStepNameRegex

    • The regex of Master step name for automated NovaSeq X Series analysis run

    • Default: ^AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v[0-9]+.[0-9]+)$

    integration.novaseqxseries.v1.automatedSequencingStepNameRegex

    • The regex of Master step name for automated NovaSeq X Series sequencing run

    • Default: ^AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v[0-9]+.[0-9]+)$

    Property

    Description

    integration.illuminaRunManager.novaseqxseries.analysisAutocompleteOnFailure

    • When analysisAutocompleteOnFailure is set to true, the integration service will automatically advance and complete the analysis step upon secondary analysis failure.

    • Used by integration service.

    • Default: false

    integration.illuminaRunManager.novaseqxseries.analysisStepPatterns

    • The regex pattern for AUTOMATED analysis step name.

    • Default:

    integration.illuminaRunManager.novaseqxseries.sequencingAutocompleteOnFailure

    • When sequencingAutocompleteOnFailure 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.

    • Used by integration service.

    • Default: false

    integration.illuminaRunManager.novaseqxseries.sequencingStepPatterns

    • The regex pattern for AUTOMATED sequencing step name.

    • Default:

    integration.illuminaRunManager.novaseqxseries.workflowNamePattern

    • The regex pattern for NovaSeq X Series workflow name.

    • Default:

    Property

    Description

    spring.profiles.active

    • Tells the application that it is running deployed in Tomcat.

    • Default: tomcat

      âš  Do not change

    clarity.url

    • Base URL that the Sequencer API service uses to contact the Clarity LIMS. The installation script (configure_sequencer_api_application) prompts for this URL.

    clarity.username

    • Username to be used when communicating with Clarity LIMS.

    security.token-expiry

    • Specifies (in hours) the expiry period for login tokens issued by the Sequencer API.

    • Default: 88

    Property

    Description

    integration.sequencer_api.v2.novaseq.sequenceStepNames

    • List of NovaSeq sequencing run step names for which the integration can find samples queued.

      • Names must be an exact match to the name of the step in Clarity LIMS (not the master step/process type).

      • Each line must be indented to the same point and start with a dash (-).

    • Default: Sequencing run step names. Example given below.

      • - "AUTOMATED - NovaSeq Run (NovaSeq 6000 v3.8)"

      • - "AUTOMATED - NovaSeqDx Run (NovaSeqDx v1.1)"

    integration.sequencer_api.v2.run.autoComplete

    • Determines whether the sequencing run step must be completed automatically after parsing the run metrics on a run along with run.autoCompleteOnlyAtSuccess.

      ℹ For more information, refer to Configuring autoComplete Properties section in Configuration guides for NovaSeq 6000 API-based or NovaSeq 6000Dx API-based integrations.

    • Default: true

    integration.sequencer_api.v2.run.autoCompleteOnlyAtSuccess

    • Determines which of the following options that the sequencing run step must be:

      • Autocompleted when the run status is RunCompletedSuccessfully (if autoCompleteOnlyAtSuccess is true)

      • Autocompleted regardless of the run status (if autoCompleteOnlyAtSuccess is false).

      ℹ For more information, refer to Configuring autoComplete Properties section in Configuration guides for NovaSeq 6000 API-based or NovaSeq 6000Dx API-based integrations.

    • Default: true

    Version

    Changes

    3

    • Updated properties of MiSeq i100 Series (cloud) and Illumina Run Manager.

    2

    • Added properties of Illumina Run Manager, NovaSeq X Series (cloud and on-premise), MiSeq i100 Series (cloud and on-premise).

    • Updated properties of existing integrations to only reflect details of properties that can be configured by user.

    • Reordered sections in alphabetical order of integration.

    1

    • Initial release.

    SIS Core
    SIS Core

    integration.miseqi100series.v1.automatedSequencingStepNameRegex

    integration.novaseqxseries.v1.libraryTubeStripRegex

    ^Invoke Infinium Analysis (.*)$
    ^Image Infinium BeadChip on iScan (.*)$
    AUTOMATED \- Analysis Run \(MiSeq i100 Series On-Prem Sequencing v[0-9]+\.[0-9]+\)
    AUTOMATED \- Sequencing Run \(MiSeq i100 Series On-Prem Sequencing v[0-9]+\.[0-9]+\)
    MiSeq i100 Series On-Prem v[0-9]+\.[0-9]+
    AUTOMATED \- Analysis Run \(NovaSeq X Series On-Prem Sequencing v[0-9]+\.[0-9]+\)
    AUTOMATED \- Sequencing Run \(NovaSeq X Series On-Prem Sequencing v[0-9]+\.[0-9]+\)
    NovaSeq X Series On-Prem v[0-9]+\.[0-9]+
    opt/gls/clarity/extensions/sequencer-api/*
    Default: AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0)
    Default:
    [A-Z]{2}[0-9]{7}-[A-Z0-9]{4}
    [A-Za-z]{2}[0-9]{7}-[A-Za-z0-9]{3}

    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 for more information.

    triangle-exclamation

    Clarity v6.3 introduces a new feature (System Setting) for configuring properties (including some integration properties).

    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

    • Properties in database: configure via omxProps-ConfigTool utility

    • Properties in files: edit property files directly

    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

    • Properties exposed in System Setting: configure via System Setting

      ℹ Property updates do not require restart of integration service

    • Properties in database: configure via omxProps-ConfigTool utility

    • Properties in files: edit property files directly

    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

    • N.A.

    âš  Integration configuration scripts are not compatible with Clarity v6.3. Integration properties must be updated using omxProps-ConfigTool utility

    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.

    Upgrade scenario:

    • Upgrade Clarity v6.2 to Clarity v6.3

    • Continue to use previously installed integrations

    • Properties in database: configure via omxProps-ConfigTool utility

    • Properties in files: edit property files directly

    Upgrade scenario:

    • Upgrade Clarity v6.2 to Clarity v6.3

    • Upgrade integrations to latest versions

    • Properties exposed in System Setting: configure via System Setting

      ℹ Property updates do not require restart of integration service

    • Properties in database: configure via omxProps-ConfigTool utility

    • Properties in files: edit property files directly