> For the complete documentation index, see [llms.txt](https://help.connected.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.connected.illumina.com/connected-insights/configure/local-installation-guide/ici-installconnectedinsightssoftware.md). # Install Illumina Administration Console Software The Illumina Illumina Administration Console software installation process can take approximately 10 - 15 minutes based on network speed. ### Install Illumina Administration Console software as follows: 1. Login to DRAGEN server v4 using ssh via root or sudo-er 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](/connected-insights/configure/local-installation-guide/ici-downloaderutility.md)). * If you downloaded directly to DRAGEN server v4 connected to internet, use the command:\ `cd /staging/sw_packages` * If you downloaded to the external storage drive mounted on the DRAGEN server v4 using your personal computer, use the command:\ `cd /mnt//sw_packages` * 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_administration_console_software_.run &` * Note: Replace `` with the version number in the file name (e.g., `1.0.0`). If desired, you may replace `./` with the absolute file path (e.g., `nohup /mnt//sw_packages/<`illumina\_administration\_console\_software`_.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 10-15 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 Administration Console 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 Administration Console software application can be accessed at https:///login` * If the DRAGEN server v4 is configured with a Static IP address:\ `Info: Illumina Illumina Administration Console software application can be accessed at https:///login` > ❗ Ensure you access the application using the URL printed in nohup.out otherwise it might throw blank errors after the page loads. 2. Proceed to [Sign in to Illumina Connected Insights Software](/connected-insights/configure/local-installation-guide/ici-signintoconnectedinsights.md) to create the first Administrator user account and sign in to the application. Note: After the installation is successful, Illumina Administration Console software application software creates the following on the DRAGEN server v4: * `/staging/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/cms` * `/staging/sw_temp` * `/var/log/pods, /var/log/services` > ❗ 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 log 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](/connected-insights/configure/local-installation-guide/ici-installationstatusmsg.md). If you must reinstall, refer to [Software Errors and Corrective Actions](/connected-insights/resources-and-references/troub-overview/troub-error-currectiveaction.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.connected.illumina.com/connected-insights/configure/local-installation-guide/ici-installconnectedinsightssoftware.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.