Troubleshooting network output directory issues after updating to NextSeq 1000/2000 CS v1.5
Last updated
Last updated
© 2023 Illumina, Inc. All rights reserved. All trademarks are the property of Illumina, Inc. or their respective owners. Trademark information: illumina.com/company/legal.html. Privacy policy: illumina.com/company/legal/privacy.html
Updating the NextSeq 1000/2000 Control Software to version v1.5 will sometimes present issues related to mounted network shares used as default Output Folders. See below for error messaging to identify these issues, as well as Troubleshooting Actions to resolve them.
1. Error message: Specify an output folder in a mounted network drive location...
An update was made in the NextSeq 1000/2000 Control Software (NCS) v1.5 that requires all Network Attached Storage (NAS) mounts to be mounted beneath /mnt in the file system in order to be used as a default Output Folder. In NextSeq 1000/2000 Control Software versions 1.4 and earlier, it was possible to output to a NAS mounted anywhere within the file system. This is no longer allowed in v1.5.
If a NAS is not mounted beneath /mnt and user attempts to select it as an Output Folder for a run/analysis, the NextSeq 1000/2000 control software will display the error: Specify an output folder in a mounted network drive location or an external hard drive.
Troubleshooting Actions:
Minimize the Control Software by selecting the dropdown menu in the top left corner, then selecting Minimize Application.
Open a Terminal by right-clicking on the Desktop and then selecting Open Terminal.
If logged in as ilmnuser, input the su ilmnadmin command and then input the ilmnadmin password.
Unmount the network share by entering sudo umount // and pressing Enter.
To find the local share directory path, input the df -Th command in the Terminal, then record the local share path under the 'Mounted on' column for the network share.
Enter sudo mkdir /mnt/ to create the new local share directory under the /mnt directory.
Input sudo gedit /etc/fstab into the Terminal to open the fstab file in Text Editor.
Locate the network share entry (typically the last entry) and edit the local share path to use the new /mnt/
Input the sudo mount -a -vvv command into the Terminal to mount the network share to the new local directory under the /mnt directory.
If the error message persists, contact Illumina Technical Support.
Examples of correct local shares using the /mnt directory:
CIFS/Samba:
/// /mnt/ cifs credentials=/root/.smbcreds,uid=ilmnadmin,gid=ilmnusers,dir_mode=0775,file_mode=0775,_netdev,x-systemd.automount,sec=ntlmssp 0 0
Network File System (NFS):
Server name:/share //mnt/ nfs x-systemd.automount,defaults 0 0
Mounted network file share locations are sometimes removed when updating the NextSeq 1000/2000 Control Software to version 1.5. This will most commonly present as an issue when the Control Software validates the Output Folder during run setup. If it is unable to identify a mounted network share, it will present an error message indicating that the Output Folder is not valid.
Troubleshooting Actions:
Minimize the Control Software by selecting the dropdown menu in the top left corner, then selecting Minimize Application.
Open a Terminal by right-clicking on the Desktop and then selecting Open Terminal.
If logged in as ilmnuser, input the su ilmnadmin command and then input the **ilmnadmin **password.
Input the sudo cat /etc/fstab command into the Terminal and press Enter to print the contents of the Filesystem Table (fstab) file. Review for any typos or entry errors in network share entry.
If the fstab file is as expected, input the sudo mount -a -vvv command to remount the network location.
If prompted, input the ilmnadmin password.
If the command fails with an error indicating the resource is busy or the network location was not found, manually unmount the previous network share by inputting sudo umount /mnt/
The local share directory is the second directory path listed in the network entry in the fstab file and should be under the /mnt directory.
Run the sudo mount -a -vvv command to mount the network share again.
If the mount is successful, return to the Control Software and attempt to continue with run setup.
If the error message persists, contact Illumina Technical Support.
For any feedback or questions regarding this article (Illumina Knowledge Article #7572), contact Illumina Technical Support techsupport@illumina.com. |
2. Error message: The selected Output Folder is invalid. Specify a different folder.
