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

Was this helpful?

Export as PDF
  1. Configure
  2. Local Installation Guide

Configure External Storage (Connected Insights - Local)

PreviousAdministration Console (Connected Insights - Local)NextCases Page

Last updated 17 hours ago

Was this helpful?

image

Configure and Monitor Storage Drive

The Storage Drives page allows you to configure the mounted external storage drive. It also displays the current disk space availability on the DRAGEN server v4 (in /staging) and external storage drives. Only Connected Insights - Local software users with an Administrator role have access. To view this page, login to Connected Insights - Local software, click your username in the top right of any page, select Administration Console, then Storage Drives.

Connected Insights - Local software uses DRAGEN server v4 local storage /staging to store resource files and databases required to process and display case results. The resource files are stored at following locations:

  • /staging/ici

  • /staging/ici_temp

Connected Insights - Local software uses an external storage drive directory to read the secondary analysis output data and to write analysis output data and backup files.

Configuring the external storage drive is an essential, one-time step setup during the initial installation process. Case ingestion will be blocked until external storage is configured. Below are the minimum requirements of the external storage which shall be mounted on the DRAGEN server v4:

  • Required: Configuration with CIFS/SMB or NFS protocols only.

  • Recommended: Use NFS v4.0 or CIFS/SMB v3.1 or higher versions for data security. Illumina also recommends an encrypted data storage drive to safeguard your data.

  • Required: 100 gigabytes (GB) of available storage space.

  • Recommended: 10 Gb (Gigabits) per second of network speed.

  • Required: External storage drive is always connected and accessible to the DRAGEN server v4 during the time of configuration setup.

Add External Storage configuration

To enable external storage drive access to the Connected Insights - Local software, refer to below instructions:

  1. From any page, click your username in the top right, select Administration Console, then Storage Drives. The Administration Console page is only accessible by Connected Insights - Local software users with an Administration role.

  2. Click Add under the External storage section.

  3. Provide the external storage mounted path, UID and GID of the user who has read write access to the external storage.

  4. Click Save.

  5. A confirmation pop up will be displayed indicating the application will be inaccessible while configuration is in progress.

  6. Click OK on the confirmation pop up.

    The application checks for below conditions and saves the settings only when the validations are successful:

    • The provided mounted path exists and is not a local directory.

    • The provided UID and GID are valid and that user has permission to the read and write in the mounted external storage drive.

    • The external storage drive directory has minimum of 100 GB free space.

  7. While the configuration is in progress, Connected Insights - Local software will be inaccessible and takes approximately 20 to 25 minutes to complete the configuration. A maintenance page will be displayed to prevent user from performing any action on the application. The application will redirect to the login screen upon successful completion.

    After the storage drive is successfully added, the application creates the following folders. In these folders, the application will write case output files with the UID and GID provided above:

    • /mnt/<External_storage_mounted_path>/d53e4b2d-0428-4b3e-92bf-955f7153c360

    • /mnt/<External_storage_mounted_path>/ici_<Server host name or IP address>

    • /mnt/<External_storage_mounted_path>/ici_report_temp

    • Notification: "One or more required packages are not installed. Go to Administration Console > Software Update to install."

Edit External Storage configuration

Connected Insights - Local software allows you to only change the UID and GID of mounted external storage drive. The mounted storage path cannot be changed or altered.

To edit the existing storage drive UID and GID configuration, refer to below instructions:

  1. From any page, click your username in the top right, select Administration Console, then Storage Drives. The Administration Console page is only accessible by Connected Insights - Local software users with an Administration role.

  2. Click Edit under the existing External storage section.

  3. Provide the UID and GID of the user with read write access to the external storage.

  4. Click Save.

  5. A confirmation pop up will be displayed indicating the application will be inaccessible while the configuration is in progress.

  6. Click OK on the confirmation pop up.

  7. While the configuration is in progress, Connected Insights - Local software will be inaccessible and a maintenance page will be displayed to prevent user from performing any action on the application (approximately 20 to 25 minutes).

The application checks for the condition below and saves the settings only when the validations are successful:

  • The provided UID and GID are valid and that user has permission to the read and write in the mounted external storage drive.

Storage Drive Notifications

Connected Insights - Local software displays the following error notifications and to prevent you from using one or more features when the following conditions are met:

  • When the configured storage drive is inaccessible, the following notification appears in the Cases, Overview, and Storage Drives pages. New case ingestion is blocked. External storage drive is not accessible. Data Upload, variant details, reports and visualization feature will not be available

  • To ingest a new case, it is required to have a minimum of 50 GB free space on the external storage drive and 150 GB free space on the DRAGEN server v4 (in /staging). When the requirement is not met, this notification displays in the Cases page. Case ingestion is blocked. Insufficient disk space on the DRAGEN server v4 and/or External storage drives. Case ingestion has been stopped. Please free up space to resume Case ingestion or contact Administrator.

  • When the configured external storage drive UID and/or GID permissions are altered from its configured settings, the following notification appears in the Cases, Overview, and Storage Drives pages. External storage drive permissions have been changed from their configured settings. Data upload, variant details, reports and visualization features will not be available.

Disk space usage

The Storage Drives page allows you to monitor storage utilization. The page displays information on Connected Insights - Local software usage, other usage, and available space for both the DRAGEN server v4 (in /staging) and the external storage drive.

Required: Previously mounted the external storage drive directory to the DRAGEN server v4 and knowledge of the UID and GID of a user with read and write access in that directory. For instructions on and find the .

❗ Instructions in this section can only be performed after mounting an external storage drive directory to the DRAGEN server v4. You must also know the UID and GID of a user with read and write access in that directory. For instructions on mounting and finding the UID and GID, see section Get the UID:GID.

Upon sign in, if you see the notification below about missing software packages, click the hyperlink to the Software Update page in notification, and then install all the required packages by following the instructions in .\

❗ It is not recommended to use this feature frequently as it impacts the existing data permissions generated by the application. This is because editing the current UID/GID will modify the permission of the existing data to the new UID/GID. Before performing this action, review the instructions on mounting with the new UID and GID under Get the UID:GID.

Software Update
how to mount external storage
UID and GID
How To section
How To section