Install Connected Insights Software

The Connected Insights - Local software installation process can take approximately 45–60 minutes based on network speed.

Install Connected Insights - Local software as follows:

  1. Login to DRAGEN server v4 via root or sudoer user and navigate to the directory where you made the installation files accessible to the DRAGEN server v4. This directory depends on how you downloaded and made the files accessible to the DRAGEN server v4 (as instructed by the section Download Connected Insights - Local software packages).

    • If you downloaded directly to DRAGEN server v4 connected to internet, use the command: cd /staging/icipackages

    • If you downloaded to the external storage drive mounted on the DRAGEN server v4 using your personal computer, use the command: cd /mnt/<Path to the directory that the storage drive is mounted to>/icipackages

    • If you downloaded and copied the files to a USB drive, use the command: cd /media/usbinstall

    • Note: you are in the correct directory if the command ls returns all of the installation files you downloaded.

  2. Start installation: nohup ./illumina_connected_insights_local_<version>.run &

    • Note: Replace <version> with the version number in the file name (e.g., 5.0.0). If desired, you may replace ./ with the absolute file path (e.g., nohup /mnt/ici_mount/icipackages/illumina_connected_insights_local_5.0.0.run &).

  3. After running the command, press Enter.

  4. Run the following command to monitor the progress: tail -f nohup.out

  5. Wait for a success or failure/error message to display in the command prompt and in the log file (nohup.out). This may take 45-60 minutes. Examples of the success and failure messages and next steps are below.

If installation is successful

  1. If the installation is successful, the following 2 messages will display in the command prompt and the log file (nohup.out):

    • Success message: Success: Illumina Connected Insights software installation is successful.

    • URL message: The software generates the URL you can use to access the application via a web browser. There are two forms of this message based on the DNS configuration of the DRAGEN server v4:

      • If the DRAGEN server v4 is configured with a fully qualified Domain Name: Info: Illumina Connected Insights software application can be accessed at https://<FullyQualifiedDomainName>/login

      • If the DRAGEN server v4 is configured with a Static IP address: Info: Illumina Connected Insights software application can be accessed at https://<IP address>/login

❗ Ensure you access the application using the URL printed in nohup.out otherwise it might throw blank errors after the page loads.

  1. On your laptop, open a browser and enter the URL to access the Connected Insights - Local software application to perform the remaining steps by proceeding to Install License File.

    • If you receive a browser message indicating that your connection is not private, disregard and proceed to the URL. This is normal and does not impact anything.

Note: After the installation is successful, Connected Insights - Local software creates the following on the DRAGEN server v4:

  • /staging/ici_analysis_dir

    • This directory will be deleted after the External Storage drive is configured and the data stored here is moved to external storage drive.

  • /staging/ici

  • /staging/ici_temp

  • /var/log/

❗ Do not delete or alter content in these folders or files. If the files are deleted, new cases cannot be processed, or case results may not be available. If the contents of /var/log are deleted, then we will lose the files needed for troubleshooting in case of any failures.

If installation fails

If the installation fails or an error occurs, a message displays that provides information on how to resolve the error. For more information, refer to Installation Status Messages. If you must reinstall, refer to Software Errors and Corrective Actions.

Last updated