LogoLogo
Illumina KnowledgeIllumina SupportSign In
  • Home
  • Overview
    • Welcome
    • What's New
      • Cloud Software Update
      • Local Software Update
  • Configure
    • Configuration
      • Custom Case Data
      • Pipeline and QC Configuration
      • Preferred Transcripts
      • Custom Annotations
      • Disease Configuration
      • Variant Filters
      • Variant Flag Groups
      • Actionability Classifications
      • Report Templates
        • Customizations
      • Report Automation
      • Test Definitions
      • Data Upload
        • Data Upload from User Storage (Connected Insights - Cloud and Connected Insights - Local)
        • Data Upload from ICA or BSSH (Connected Insights - Cloud)
        • Supported Pipelines
          • DRAGEN TruSight Oncology 500 Analysis Software v2.6.0 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.6.0
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.3 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.3
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.2 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.2
          • DRAGEN TruSight Oncology 500 Analysis Software v2.1.1 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.1.1
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.6.1
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.6.0
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.5.0
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.1.1
          • DRAGEN Amplicon v4.3
          • DRAGEN Amplicon v4.2
          • DRAGEN Amplicon v4.1
          • DRAGEN RNA v4.3
          • DRAGEN RNA v4.2
          • DRAGEN RNA v4.1
          • DRAGEN Enrichment v4.3
          • DRAGEN Enrichment v4.2
          • DRAGEN Enrichment v4.1
          • DRAGEN for Illumina cfDNA Prep with Enrichment v4.0.3
          • DRAGEN Somatic Whole Genome v4.3
          • DRAGEN Somatic Whole Genome v4.2
          • DRAGEN Somatic Whole Genome v4.1
          • TruSight Tumor 170 Local App v2.0.1
          • Local Run Manager TruSight Tumor 15 Analysis Module v2.1
        • Custom Pipeline Configuration
          • VCF Input Requirement
          • TMB, MSI, GIS Input Requirement
        • Custom Case Data Upload
    • Upload Assertions
    • Local Installation Guide
      • Overview
      • Prerequisites
      • Download Connected Insights Package
      • Install Connected Insights Software
      • Install License File
      • Sign In to Connected Insights
      • Installation Status Messages
      • Local Configurations
      • Administration Console (Connected Insights - Local)
      • Configure External Storage (Connected Insights - Local)
  • Manage cases
    • Cases Page
    • Cases List
      • Case Metadata Upload
  • Interpret and report
    • Case Page
    • Case Details
      • Merge Cases
    • Overview Tab
      • Classification & Risk Stratification Prediction
    • Visualize Tab
    • Variants Tab
      • Modify Columns
      • Apply Variant Filters
        • Filter by Variant Category
        • Variant Details Filters
        • Variant Quality Filters
        • Functional Impact Filters
        • Disease Association Filters
        • Variant Frequency Filters
        • Flags Filter
        • Filtering Logic
      • IGV Visualizations
    • Lab QC Tab
    • Report Tab
    • View Biomarker Details
      • Biological Classification
      • Actionability
      • Clinical Trials
      • Oncogenicity Prediction
      • Visualize
      • Variant Overview
      • Gene Overview
      • Cancer Datasets
      • Computer Predictors
      • Population
    • Interpret a Biomarker
      • Create Clinical Trials
      • Create Gene Descriptions
      • Manage Assertions
    • Variant Transcripts
    • Add Variant
  • Resources and References
    • Glossary
    • APIs
      • Ingest Cloud Analysis Data API (Connected Insights - Cloud Only)
      • Case APIs
      • Report APIs
      • Audit Log APIs
    • Troubleshooting
      • Overview
      • Audit Log
      • Data Backup (Connected Insights - Local)
      • Software Errors and Corrective Actions
      • How To
      • Technical Assistance
    • Pricing and Usage
    • Security and Compliance
    • Release Notes
Powered by GitBook
On this page
  • Install Connected Insights - Local software as follows:
  • If installation is successful
  • If installation fails

Was this helpful?

Export as PDF
  1. Configure
  2. Local Installation Guide

Install Connected Insights Software

PreviousDownload Connected Insights PackageNextInstall License File

Last updated 17 hours ago

Was this helpful?

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

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

    • 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

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 .

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 . If you must reinstall, refer to .

Download Connected Insights - Local software packages
Install License File
Installation Status Messages
Software Errors and Corrective Actions