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:
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.
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 &
).
After running the command, press Enter.
Run the following command to monitor the progress:
tail -f nohup.out
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
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.
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