Manual Upgrade
This section describes the manual upgrade process from IPP v2.9 to IPP v2.10 to enable the changes described in Illumina Preset Protocols v2.10 Release Notes. If you do not want to upgrade the latest workflow through IPP, then update the workflow configuration manually using the following information.
The manual upgrade instructions include steps for:
Updating the sequencing instrument presets and routing scripts to support the new MiSeq i100 Series cloud, MiSeq i100 Series on-premise and NovaSeq X Series on-premise integrations.
Updating the precision of BP Aliquot Volume (ul) derived sample global field.
ℹ BP Aliquot Volume (ul) field is used in Illumina Genomics Architecture - NovaSeq Sequencing v2.1, NovaSeq 6000 v3.8, NovaSeqDx v1.2 and NovaSeq X Series Sequencing v1.1 protocols in IPP v2.9.
Updating the Library Prep Validation v2.3.4 protocol:
to display an expanded sample table under the Record Details milestone by default.
to route libraries to new instruments. Refer to for updating the routing scripts.
Updating the NovaSeq X Series Sequencing v1.1 protocol in IPP v2.9 to fix bugs. The steps involve updating container definition, step configuration, automations and global step fields. For manual upgrade instructions for the NovaSeq X Series Sequencing workflow, refer to .
Updating the NextSeq 500/550 Sequencing v1.2 protocol in IPP v2.9 to support generation of forward-orientation samplesheet that is compatible with NextSeq 500/550 Control Software Version 4.2 and Local Run Manager (LRM) v4.0 for . For manual upgrade instructions for the NextSeq 500/550 Sequencing workflow, refer to .
1. Update Sequencing Instrument Presets
In IPP v2.10, . New options for the MiSeq i100 Series (cloud), MiSeq i100 Series (on-premise) and NovaSeq X Series (on-premise) integrations have been added.
This can cause a conflict with the Sequencing Instrument derived sample custom field. The following workflows can be affected:
Illumina DNA Prep (M) Tagmentation v1.0.9
Nextera Mate Pair v1.0.10
TruSeq DNA PCR-Free v2.0.10
Force Import Workflows During Installation
When the expected conflicts are encountered during the IPP workflow installation, enter f to import the workflow when prompted. An example of the prompt is as follows.
Add New Options to Sequencing Instrument Global Field
After the workflow is installed, resolve the conflicts as follows.
From Configuration, select the Custom Fields tab, and then select the Global Fields tab.
Search for Sequencing Instrument.
For Additional Options, add the following to the Dropdown Items list:
Update Routing Script Automations
Existing library preparation workflows may include to integrations. These routing scripts have been updated to add new options for the MiSeq i100 Series (cloud), MiSeq i100 Series (on-premise) and NovaSeq X Series (on-premise) integrations. Modify the automation script as follows.
[Optional] If you are using the MiSeq i100 Series (cloud) instrument, add the instrument to the script:
[Optional] If you are using the MiSeq i100 Series (on-premise) instrument, add the instrument to the script:
[Optional] If you are using the NovaSeq X Series (on-premise) instrument, add the instrument to the script:
2. Update BP Aliquot Volume (ul) Global (Derived Sample) Field
Select the Configuration tab, and then select the Custom Fields tab.
Under Global Fields, navigate to the Derived Sample section and update BP Aliquot Volume (ul):
Decimal Places Displayed from 0 to 1
3. Update Library Prep Validation to Display Expanded Sample Table by Default
Select the Configuration tab, and then select the Lab Work tab.
Select Library Prep Validation workflow.
Select Library Prep Validation protocol.
