For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting Sample Sheet will not Load into MiSeq Control Software

Background

Errors when loading a Sample Sheet in the MiSeq Control Software (MCS) can be caused by:

  • MCS unable to find the sample sheet for the run

  • The sample sheet is formatted incorrectly

Sample Sheet errors may also occur during Pre-run checks. Examples of errors include:

  • An error has occurred while reading in the recipe fragments.

  • Chemistry step 'firstReadPreparation' is invalid: Error in PumpToFlowCell Node. Could not find either a reagent name or a solution.

Troubleshooting

Check Sample sheet file location:

  • The sample sheet must be located in the SampleSheets folder.

    • The default sample sheet location is D:\Illumina\MiSeq Control Software\SampleSheets.

    • This can be changed in the Folder Settings tab of Run Options, or specified for a particular run.

    • If the sample sheet is not in this folder, make a copy and place it in the specified folder.

  • Browse directly to a sample sheet if desired.

Check Sample sheet format:

  • The best way to ensure correct formatting is to generate the sample sheet in Local Run Manager (LRM) (MiSeq Control Software v3.1 or later) or Illumina Experiment Manager (IEM) (MiSeq Control Software v2.6.2 or earlier). If these software are not used, the sample sheet must be created as a comma-separated text file (*.csv) according to the format described in the MiSeq Sample Sheet Quick Reference Guide. The file name is typically the same as the serial number from the reagent cartridge, although this is not required.

  • The file extension must be .csv

  • There are several illegal characters that should not be used in a sample sheet or title, including:

? ( ) [ ] / \ = + < > : ; " ' , * ^ | &

These characters prevent the sample sheet from being loaded correctly.

For any feedback or questions regarding this article (Illumina Knowledge Article #1455), contact Illumina Technical Support techsupport@illumina.com.

Last updated

Was this helpful?