# User Interaction

{% hint style="info" %}
To perform the following actions, Clarity LIMS admin permission is required.
{% endhint %}

## Connect to Instrument

1. Navigate to Illumina Run Manager Integration UI via the following url, `https://{Clarity LIMS server url}/irm`

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-c663186361f8eb912941c1f81566de721caf69f1%2Firm-login.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

2. Login with Clarity LIMS admin credentials.
3. Click "Connect Instrument" button.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-b8d94e7c2e19debb08ded166217880f9c3e28801%2Firm-connected-instrument.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

4. On the "Connect a new instance page", select the appropriate Instrument Platform and enter the Illumina Run Manager instance URL, then click the "Connect" button.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-af6c7f3fe9ef986938da47209d67c1a7de7df780%2Firm-connect-instrument.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

5. Enter Illumina Run Manager credential admin and click Sign In. Screenshot below shows NovaSeq X instrument as an example.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-c5c7fc9754bd5146d91c2feeddc0d26b7fc7f9cd%2Firm-novaseqx-credential.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

6. Upon successful connection, the Illumina Run Manager instance details will populate under the Connected Instances table.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-285f87be5f55cb86821110f99edccff465661915%2Firm-connected-instrument-successful.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

7. On Clarity LIMS UI, the registered instrument can be found under Configuration > Consumables > Instruments.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-02792215a98d6ba81075669670513fb154b5921c%2Firm-clarity-registered-instrument.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

## Disconnect from Instrument

Follow the steps below to disconnect an instrument:

1. Navigate to Illumina Run Manager Integration UI via the following url, `https://{Clarity LIMS server url}/irm`.
2. Login with Clarity LIMS admin credentials.
3. Click on the delete button (trash bin icon under the "Action" column) of the Instrument Instance to be disconnected.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-e371877e3bd4a326c6b092580d659c8c22d369a2%2Firm-connected-instrument-trash-bin.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

4. Click on the "Confirm" button.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-d7cbfd7468f2e1d7516effd66b5dc92db72848cf%2Firm-connected-instrument-confirm-disconnection.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

5. On Clarity LIMS UI, manually rename the instrument (e.g. by appending prefix of "Archived\_").

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-6d598f5c67c856666cabaeca2983a5af80537e2a%2Firm-clarity-archive-instrument.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

> ⚠ The system will throw an error when the user tries to connect to the same instrument again without renaming the instrument.
>
> <img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-a0566a7f8d6e8168c506d0af8a2dedc7a331f95c%2Firm-instrument-exists.png?alt=media" alt="" data-size="original">
>
> <br>

6. \[Optional] Archive the disconnected instrument to avoid confusion of instruments.

   Steps for instrument archival can be found in Instrument Status under Add and Configure Instruments of Clarity LIMS Reference Guide > Configuration > Consumables > Instruments in [Clarity LIMS (Clarity & LabLink Reference Guide) documentation](https://help.claritylims.illumina.com/instruments-and-integrations/irm/broken-reference).

## Reconnect Instrument

{% hint style="info" %}
Reconnecting an instrument is required under some circumstances (e.g., change of instrument domain name, reinstallation of Illumina Run Manager, factory reset of instrument etc.)
{% endhint %}

Follow the steps below to reconnect the instrument:

1. Navigate to Illumina Run Manager Integration UI via the following url, `https://{Clarity LIMS server url}/irm`.
2. Login with Clarity LIMS admin credentials.
3. Click on reconnect button.

{% hint style="info" %}
The reconnect button is only clickable when the instrument status is not connected.
{% endhint %}

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-fb286a693ee3ec76e1060263999e8a255fde01a2%2Firm-reconnect-instrument-button.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

4. On the "Reconnect instance page", enter the Illumina Run Manager instance URL, then click the "Connect" button.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-e88ab0185d90e63fe5036db6920a457259617817%2Firm-reconnect-instrument.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

5. Complete the reconnection process by following steps 5 to 7 in the Connect Instrument section.

## Advance TLS Verification Setting

{% hint style="info" %}
This is applicable to Illumina Run Manager Integration v1.1.0 and onwards. For versions before that, please refer to the version's installation guide.
{% endhint %}

{% hint style="info" %}
By default, TLS Verification will be enabled.
{% endhint %}

When connecting to instrument through Illumina Run Manager Integration, TLS Verification can be enabled or disabled. This will enable or disable TLS Verification when events from Illumina Run Manager is sent to Clarity LIMS.

{% hint style="warning" %}
For testing TLS connections in a development environment, you may consider disabling TLS verification to simplify debugging. However, disabling TLS verification is strongly discouraged in production environments, as it can compromise the security of network connections.
{% endhint %}

To enable or disable TLS Verification when connecting to instrument, follow these steps:

1. Navigate to System Settings on Clarity LIMS.
2. Add the property `integration.illuminaRunManager.pns.disableTlsVerification`:
   * Set value to `false` to enable TLS Verification.
   * Set value to `true` to disable TLS Verification.

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-3305dae2db14458dab3b0283347db70d6692e458%2Firm-disable-tls.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>
