PromethION 24/48 user manual

概要

This guide will help you install, check and configure your PromethION 24, PromethION 48 or PromethION 24/48 A-Series.

Our PromethION 24/48 FAQs are located here.

For Research Use Only.

Document version: PIC_1013_v1_revZ_12Nov2019

1. Device information

The PromethION 24 and 48

The PromethION is a benchtop device designed to run up to 24 (for PromethION 24 and PromethION 24 Combined) or 48 (for PromethION 48) flow cells. Each flow cell is independently addressable, meaning that experiments can be run concurrently or individually. Integrated compute in the PromethION enables real-time data streaming and analysis.

Image of DAU SQU P48

Technical specification

Component Specification
Size and weight PromethION 24 Sequencing Unit:
H190 x W590 x D430 mm
Weight 23 kg
PromethION 48 Sequencing Unit:
H190 x W590 x D430 mm
Weight 30 kg
Data Acquisition Unit:
H470 x W178 x D440 mm
Weight 26 kg
Power 2x for Data Acquisition Unit
C13 cables included with device
Mains supply voltage: 200-240 VAC (50/60 Hz)
Peak power consumption: 2,450 W
1x for Sequencing Unit
C13 cable included with device
Mains supply voltage: 100-240 VAC (50/60 Hz)
Peak power consumption: 1,200 W
Compute specification PromethION P24: 30 TB SSD Storage, 384 GB RAM
PromethION P48: 60 TB SSD Storage, 384 GB RAM
PromethION 24/48 A100: 60 TB SSD Storage, 512 GB RAM, 4x Ampere-Series GPUs
Common features: Intel CPU for Ubuntu OS and basecalling orchestration
PromethION Accelerator
Pre-loaded software Ubuntu OS, PromethION OS, MinKNOW
Environmental conditions Designed to sequence at +18ºC to +22ºC*

*Functional range of electronics +5ºC to +40ºC

FAQs

Our PromethION 24/48 FAQs are located here.

2. What's in the box

PromethION 24/PromethION 48 packaging

PromethION 24/48 A-Series

This device ships to most countries worldwide. The device is shipped in two separate boxes: one for the Data Acquisition unit and one for the Sequencing Unit. The devices are stored and shipped at ambient temperature (15–25°C).

PromethION 24 Combined

This device ships to selected countries worldwide. The Data Acquisition Unit and Sequencing Unit that make up The PromethION 24 Combined are shipped in one box. The device is stored and shipped at ambient temperature (15–25°C). The PromethION 24 Combined must only be unpacked and installed by an Oxford Nanopore Technologies Field Service Engineer.

What's in the box - PromethION 24

  1. PromethION 24 Sequencing Unit
  2. PromethION 24 Data Acquisition Unit
  3. 3x Country-specific C13 cables
  4. 24x Configuration Test Cells (CTCs)
  5. 2x PCIe cables
  6. 2x USB-A/Mini USB cable
  7. 1x USB-A/USB B cable
  8. 1x MiniDP/Display port cable
  9. 1x USB-A stick (ISO reset image)
  10. 1x USB-C/USB-A adapter

What's in the box - PromethION 48

What’s in the box: 1. PromethION 48 Sequencing Unit 2. PromethION 48 Data Acquisition Unit 3. 3x Country-specific C13 cables 4. 48x Configuration Test Cells (CTCs) 5. 3x PCIe cables 6. 3x USB-A/Mini-USB cable 7. 1x USB-A/USB-B cable 8. 1x MiniDP/Display port cable 9. 1x USB-A stick (ISO reset image) 10. 1x USB-C/USB-A adapter

3. Installing and powering on the device

Preparing for installation

The following should be available before installing the device: - SFP+ modules and cabling for 2x 10 Gbps fibre OR cabling for 2x 10 Gbps Copper (Ethernet - Cat6a or above) - A single Copper cable for hardware check

  • Fibre OR Copper ports providing: - IP address through DHCP - Outbound-only access to the internet over ports 80 and 443
  • 1x VGA-capable monitor (for original PromethION 24/48 Data Acquisition Unit)
  • 1x VGA-capable/DisplayPort-capable monitor (for new PromethION A-Series Data Acquisition Unit)
  • 1x VGA cable
  • 1x USB connected keyboard
  • 1x USB connected mouse
  • 3x Power supplies/wall sockets for the PromethION Data Acquisition Unit and Sequencing Unit - 1x Power supply/wall socket for a monitor
  • Optional: UPS solution with C14 cables

Recommended laboratory location

  • Place the device on a strong, clean laboratory bench. If you are using a PromethION 24 Combined, the device needs to be installed with the Sequencing and Data Acquisition units next to each other. The bench space required for a PromethION installation is 167 cm x 75 cm
  • Ensure power, Ethernet and/or Fibre connectors are in close proximity
  • Ensure power socket is easily accessible should a disconnection be required in case of emergency
  • Sequencing should be carried out at a room temperature of +18°C to +22°C with device doors closed prior to sequencing beginning
  • Allow 30 cm clearance to rear and sides of the device to ensure correct airflow
  • Do not cover any ventilation grills
  • WARNING - The rear of the device will heat up during operation

Unpack the device and place it on the bench where it is to be run.

Place the Sequencing Unit on the bench where it is to be run and the Data Acquisition Unit within two meters of the Sequencing Unit.

If you are using the PromethION 24 Combined, the device must only be unpacked and installed by an Oxford Nanopore Technologies Field Service Engineer. Once your device has been correctly installed, proceed from step 9.

PromethION 24 Sequencing and Data Acquisition Units

PromethION P24 glamour shot form word doc 1.0.tif

PromethION 48 Sequencing and Data Acquisition Units

Image of DAU SQU P48

オプショナルステップ

Optional: insert the SFP+ modules into the ports shown below.

If the fibre optic cables are to be used, then you must insert your chosen SFP+ modules into the ports on the rear of the Data Acquisition Unit.

SFP+ modules image 2.0

Connect the data cabling into the appropriate port shown below.

For the hardware check, a single copper cable should be used and connected to a port with a DHCP service running.

Download the latest software, then complete full network configuration after the hardware check.

See the Network configuration section in this document to set up single vs dual connectivity and copper vs fibre connections.

Data cabling - 2.0 24 Oct 19

This is the first step of the inter-unit connections. Connect the PCIe cables between your Sequencing Unit and Data Acquisition Unit.

PromethION 24 Connect the PCIe cables to the rear of the Sequencing Unit and the rear of the Data Acquisition Unit.

Note There is a port-to-cable colour requirement on both units.

P24 PCIe labelled

PromethION 48 Connect the PCIe cables to the rear of the Sequencing Unit and the rear of the Data Acquisition Unit.

Note There is a port-to-cable colour requirement on both units.

PCIe cable coloured ports 1.0

This is the second step of the inter-unit connections. Connect the USB cables between the Data Acquisition Unit and Sequencing Unit.

PromethION 24 Connect:

  1. 2x USB A – Mini USB
  2. 1x USB A to USB B from the Data Acquisition Unit to the Sequencing Unit (see the diagram below): P24 USB labelled

PromethION 48 Connect:

  1. 3x USB A – Mini USB
  2. 1x USB A to USB B from the Data Acquisition Unit to the Sequencing Unit (see the diagram below): USB connections on SQU and DAU 2.0 24 Oct 19

Connect peripheral devices to the appropriate ports.

Plug in the following:

1a. Monitor VGA cable (if using original PromethION 24/48 Data Acquisition Unit) 1b. Monitor VGA/miniDP cable* (if using the PromethION A-Series Data Acquisition Unit) 2. USB keyboard 3. USB mouse into the remaining USB A port.

* Use either the miniDP output or the VGA output. It is not possible to use both outputs simultaneously.

VGA 2.0

Two C13 power cables will plug into the Data Acquisition Unit and one C13 power cable will plug into the Sequencing Unit.

Insert two of the supplied C13 cables into the top of the Data Acquisition Unit, and the third into the Sequencing Unit. Connect all to a mains power supply.

Note: You will be provided with at least three C13 cables with plugs for your country of use.

Turn on the power at the mains supply. Then turn on the PromethION units in the order below:

  1. Turn on the Sequencing Unit SQU power on 2.0
  2. Wait for 3 minutes
  3. Turn on the Data Acquisition Unit DAU power on 2.0

Double-click the MinKNOW icon located on the desktop to open the MinKNOW UI.

Icon 1

We recommend users to log into the MinKNOW software using their Community credentials.

To log in, you must be connected to the internet.

From here, you can also change the language in the user interface in the bottom right corner.

Login

You will be prompted to enter your email address and Nanopore password:

Okta 2 email address login page

Okta 3 password page external users

If you experience login issues, please visit the Community Support channel (https://community.nanoporetech.com/support) and use Continue as guest for temporary use.

Select the sequencing device in the Connection Manager to connect to the computer.

prom 48

You will be taken to the Sequencing Overview, displaying the connected flow cells.

21

4. Network settings and connection

注意

Changing your network configuration

The network parameters for your PromethION 24 or PromethION 48 must be suited to your local network.

WARNING! Changing the network parameters on your PromethION may leave your device non-functional.

If you are uncertain about which parameters to use to configure your PromethION network settings, please contact your IT department.

Networking requirements

Your PromethION can use copper or fibre interfaces for connecting to your local infrastructure. The type of port is labelled on the diagram of the back of the PromethION below:

Copper v fibre ports

This connection will be used for:

  • Sending telemetry* information to Oxford Nanopore Technologies
  • Receiving software and firmware updates to the device
  • Streaming biological sequence data to your local storage infrastructure

To implement the PromethION into the local infrastructure, *all appropriate cabling must be provided by the customer.

* Telemetry contains metadata about the settings and conditions of a sequencing run. Nothing specific about the genomic content of individual reads is included - only generic information is logged, such as sequence length and q-score.

Copper or fibre data transfer connections can be used - but not both.

You can run with copper or fibre connections for your data transfer. We do not recommend one over the other, however, it is down to your local network environment for which connectivity you may prefer to use.

Note: Please only attach copper or fibre cables. Using both is not supported and will cause networking issues.

A summary of the connectivity options is shown in the diagram below. Please consult the instructions below to ensure the PromethION network connections are set up correctly.

DUAL SINGL COPPE FIBRE 2.0

Instructions for setting up a copper connection

Single copper port on DHCP service

  1. Open a Terminal window and enter the following command:
ont-network-settings --dhcp --interfaces eno2 --overwrite

2. Power cycle the PromethION.

Connections: Use only the lower RJ45 port for this configuration. single copper

Dual copper ports on DHCP service

  1. Open a Terminal window and enter the following command:
ont-network-settings --dhcp --interfaces copper --bond failover --overwrite

2. Power cycle the PromethION.

Note: If using LACP/Cisco/802.3ad, then enter:

--bond lacp

Connections: Use both RJ45 ports for this configuration. Dual copper

Dual copper ports with a static IP address

  1. Open a Terminal window and enter the following command:
ont-network-settings --address 1.1.1.1 --subnet 255.255.255.0 --gateway 1.1.1.254 --dns 1.1.1.2,1.1.1.3 --search mycompany.local --bond failover --interfaces copper --overwrite

2. Power cycle the PromethION.

Note: You must change the IP addresses above according to your site's network configuration.

Connections: Use both RJ45 ports for this configuration; however, the configuration will also function with only the bottom port occupied. Dual copper

Instructions for setting up a fibre connection

Single fibre port on DHCP service

  1. Open a Terminal window and enter the following command:
ont-network-settings --dhcp --interfaces enp129s0f1 --overwrite

2. Power cycle the PromethION.

Connections: Use the right fibre port for this configuration:

single fibre

Dual fibre ports on DHCP service

  1. Open a Terminal window and enter the following command:
ont-network-settings --dhcp --interfaces fibre --bond failover --overwrite

2. Power cycle the PromethION.

Note: If using LACP/Cisco/802.3ad, then enter:

  --bond lacp

Connections: Use both fibre ports for this configuration. dual fibre

Dual fibre ports with a static IP address

  1. Open a Terminal window and enter the following command:
ont-network-settings --address 1.1.1.1 --subnet 255.255.255.0 --gateway 1.1.1.254 --dns 1.1.1.2,1.1.1.3 --search mycompany.local --bond failover --interfaces fibre --overwrite

2. Power cycle the PromethION.

Note: You must change the IP addresses above according to your site's network configuration.

Connections: Use both fibre ports for this configuration; however, the configuration will also function with only the right port port occupied. dual fibre

Validate the IP address

You can use the command: ifconfig to validate that the IP address has been set correctly using a static or DHCP address.

The returned information will contain the IP address for the Ethernet link, as below:

prom@PRO00001:~$ ifconfig
docker0: flags=4099<UP,BROADCAST,MULTICAST>  mtu 1500
        inet 172.17.0.1  netmask 255.255.0.0  broadcast 172.17.255.255
        ether 02:42:35:39:60:40  txqueuelen 0  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
eno1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.150.60.13  netmask 255.255.255.0  broadcast 10.150.60.255
        inet6 fe80::78cf:8a5c:26ec:4611  prefixlen 64  scopeid 0x20<link>
        ether 3c:7c:3f:be:02:81  txqueuelen 1000  (Ethernet)

5. Changing the default password and hostname

Navigate to the host settings to open Device settings.

Click Reset password in the System box.

Grid password 1

In the Change Password dialogue box, enter your current password, followed by the new password.

Password change dialogue

Click Reset Password to confirm password change.

(Advanced) Changing the default hostname

  • If you need to update the hostname of the device, run the following command and replace the <new_hostname> portion with your desired hostname (omitting the angle bracket characters <>):

sudo -S hostnamectl set-hostname <new_hostname>

  • Power cycle the device by shutting down with the following command, then press the physical power button to turn the device back on:

sudo shutdown -h now

6. (Advanced) Updating the timezone and setting a local NTP server

To update the timezone:

First find the correct timezone name by typing the command:

sudo timedatectl list-timezones

Then change the timezone using the following commands:

sudo su -
Timezone="Europe/London"
timedatectl set-timezone $Timezone
systemctl restart systemd-timesyncd

To set a local NTP server:

Note: this requires NTP/port 123 access if using an external internet time server.

Enter the following commands:

NTPserver="ntp.ubuntu.com" timedatectl set-ntp false cat << EOF > /etc/systemd/timesyncd.conf # See timesyncd.conf(5) for details.[Time] NTP=$NTPserver EOF systemctl stop ntp ntpdate $NTPserver systemctl disable ntp timedatectl set-ntp true hwclock --systohc timedatectl set-local-rtc 0

Some error messages may appear, however these can be ignored. You can check that the process has worked by typing:

timedatectl status

Note: it may take several minutes to sync with the NTP server.

7. Hardware check

重要

Hardware check

A hardware check must be performed on all new devices or when software has been upgraded.

Load all the CTCs that came with the device into the flow cell positions.

All the strips should be loaded with CTCs.

Note:

  • A PromethION 24 has three strips that contain a total of 24 flow cell positions.
  • A PromethION 48 has six strips that contain a total of 48 flow cell positions.

Loading a CTC or flow cell P24 P48 2.0

The MinKNOW UI recognises the CTCs as they are loaded, and the LED adjacent to the flow cell will first show blue (initialising), followed by green (ready).

Close all of the doors on the top of the Sequencing Unit once the CTCs are loaded.

重要

Correct insertion of PromethION CTCs

Note that regular flow cells are shown in the images, however the recommendations apply equally to CTCs.

Line up the CTC with the connector (horizontally and vertically) and smoothly insert it into position.

Flow cells all2

Press the CTC down firmly into the loader, and ensure that the latch engages.

Flow cells side by side

Insertion of the CTC at the wrong angle can damage the pins on the PromethION:

Screenshot 2021-04-08 at 12.08.37

Once the flow cells are correctly loaded into the PromethION, the flow cells undergo an automatic hardware check:

  • Green tick: flow cell has passed
  • Red tick: flow cell needs to be re-inserted Prom pass fail

Navigate to the start homepage and click 'Hardware check'.

Hardware check 1

Select all the CTCs in the UI and click Start for the check to begin.

prom hardware check

You will be automatically navigated to the Sequencing Overview page.

A loading bar appears under the flow cell during the checks.

This example is a Flongle CTC (loading bar highlighted in red). Hardware check progress bar

最終ステップ

The hardware check will complete after approximately one minute.

Hardware check pass is indicated by a green check icon.

Prom hardware check pass

A fail is indicated by an orange check icon.

If the hardware check fails, remove and reinsert the CTC, and run a hardware check again. If the check fails for a second time, please contact Technical Support via email (support@nanoporetech.com) or via LiveChat in the Nanopore Community.

重要

Do not store the CTCs in the flow cell positions when the platform/position is not in use.

Do not leave the CTCs in the Sequencing Unit flow cell positions once the unit is powered down, and do not insert the CTCs until the Sequencing Unit is powered on and the position is required for a Hardware check.

Store the CTCs in dry conditions at room temperature.

8. Flow cell check

消耗品
  • PromethION Flow Cell
装置
  • PromethION sequencing device

Flow cell check

We strongly recommend performing a flow cell check before loading a DNA or RNA library to assess the number of pores available.

Oxford Nanopore Technologies will replace any flow cell that falls below the warranty number of active pores within three months of purchase, provided that you report the results within two days of performing the flow cell check and you have followed the storage recommendations.

Flow cell Minimum number of active pores covered by warranty
Flongle Flow Cell (FLO-FLG001) 50
MinION/GridION Flow Cell 800
PromethION Flow Cell 5000
重要

After taking flow cells out of the fridge, wait 20 minutes before inserting the flow cell into the PromethION for the flow cell to come to room temperature. Condensation can form on the flow cell in humid environments. Inspect the gold connector pins on the top and underside of the flow cell for condensation and wipe off with a lint-free wipe if any is observed. Ensure the heat pad (black pad) is present on the underside of the flow cell.

Load the flow cells to be run into the docking ports of the PromethION.

Insert the chip connector fully into the docking port. Take note to ensure the latch to hold the chip in place clicks in.

重要

Correct insertion of PromethION flow cells into a PromethION 24/48 device

Line up the flow cell with the connector (horizontally and vertically) and smoothly insert it into position.

Flow cells all2

Press the flow cell down firmly into the loader, and ensure that the latch engages.

Flow cells side by side

Insertion of the flow cell at the wrong angle can damage the pins on the PromethION and affect your sequencing results. If you find the pins on a PromethION position damaged, please contact support@nanoporetech.com for assistance.

Screenshot 2021-04-08 at 12.08.37

Once the flow cells are correctly loaded into the PromethION, the flow cells undergo an automatic hardware check:

  • Green tick: flow cell has passed
  • Red tick: flow cell needs to be re-inserted Prom pass fail

Navigate to the start homepage and click 'Flow cell check'.

Flow cell check

When you see the flow cell type and flow cell IDs recognised, click Start to begin.

prom flow cell check

You will be automatically navigated to the Sequencing Overview page.

A loading bar appears under the flow cell during the checks.

This example is a Flongle CTC (loading bar highlighted in red). Hardware check progress bar

Flow cell health indicators

The quality of the flow cell will be shown as one of the three outcomes:

  1. Yellow exclamation mark (Flongle flow cell): The number of sequencing pores is below warranty. Take the flow cell out of the device, re-insert it and run a flow cell check again. If the flow cell is still below warranty, contact support@nanoporetech.com

  2. Green tick (MinION flow cell): The number of sequencing pores is above warranty.

  3. Question mark (PromethION flow cell): A flow cell check has not been run on the flow cell during this MinKNOW session.

Flow cell check icon all devices

Note: The indicator of quality will only remain visible during a MinKNOW session. Once the MinKNOW session has ended, the status of the flow cell will be erased.

9. Sequencing and monitoring the experiment

For instructions on how to set up a sequencing experiment and how to monitor the progress of the experiment, refer to the MinKNOW protocol in the Nanopore Community.

To run a sequencing experiment, you will need your DNA or RNA sample purified and a sequencing library prepared. For more information about sample preparation, refer to the Prepare section of our Documentation.

You can access the MinKNOW protocol by following this link.

10. Data management

From MinKNOW version 21.02 onwards, we have added new functionality to enable smoother data transfer off the box during a sequencing run. The instructions below are an example method to mount an external NFS and transfer data. Please consult your local IT department before implementing any code to ensure it is compatible with the local infrastructure and the correct permissions are in place.

Mount your local NFS file system on the device (note that Linux mounts a remote filesystem into a directory locally). Below is an example setup through the terminal:

prom@PCT0001:~$ sudo su - prom@PCT0001:~$ apt install autofs prom@PCT0001:~$ echo -en “+auto.master\n/nfs /etc/auto.ont\n” > /etc/auto.master prom@PCT0001:~$ echo -en "NETWORKSTORAGE -nfsvers=3,rw,bg,async,actimeo=300,soft,intr,noatime,tcp,nolock IPADDRESS:/PATH/TO/SHARE" > /etc/auto.ont prom@PCT0001:~$ ln -s /nfs/NETWORKSTORAGE /media/NETWORKSTORAGE prom@PCT0001:~$ ls -al /media/NETWORKSTORAGE/*

Install the latest version of the MinKNOW software:

prom@PCT0001:~$ sudo apt update prom@PCT0001:~$ sudo apt install ont-promethion-release

Make a source directory that your experiments will be saved to in /data/ , for example:

prom@PCT0001:~$ mkdir /data/data-offload

Make a destination directory on your networked storage. This also tests that the ‘prom’ user can write to the networked storage:

prom@PCT0001:~$ mkdir /media/mounted_drive/destination_directory/

As root, edit /etc/systemd/ont-platform-data-offload.conf to set the SOURCE_DIR and DESTINATION_DIR variables. SOURCE_DIR is the directory the PromethION software writes to, and DESTINATION_DIR is on your networked storage.

prom@PCT0001:~$ sudo vi /etc/systemd/ont-platform-data-offload.conf

Picture1

A log of the actions taken by the script will be written to /data/data-offload.log

Start your sequencing in the MinKNOW UI, setting the output location to SOURCE_DIR set above.

data offload example

We currently recommend manually controlling the service, as the data offload activity could affect active runs.

To start the offload service as root:

sudo systemctl start ont-platform-data-offload

To stop the offload service as root:

sudo systemctl stop ont-platform-data-offload

To check that the service is running, run the following command:

sudo systemctl status ont-platform-data-offload

重要

Data transfer speeds will depend on local network infrastructure. Oxford Nanopore recommends a 10 Gbps (PromethION) connection is used to maximise transfer speeds.

重要

Initially, write the data directly to the internal SSD drives. Writing to a networked drive is not currently supported.

11. Shutting down

Shutting down your PromethION 24/48

The PromethION Data Acquisition Unit requires a stepwise, processed shut down, otherwise you may face problems e.g. when recognising flow cells.

Follow the instructions in this section to ensure you do not face errors with your PromethION from incorrectly shutting down your device.

Remove all flow cells from the device.

Navigate to Device Settings in the admin interface.

Device settings 1

Select Shutdown.

Click Shut Down in the pop-up to confirm.

shut down

ヒント

Do not click on Reboot, as this will lead to errors in recognising the flow cells when starting an experiment.

Switch off the Sequencing Unit using the switch on the back of the device.

SQU power on 2.0

Turn off the device at the mains supply, if you are using mains power.

12. Updating the software via the UI

重要

Updating the software

Oxford Nanopore Technologies will post a release note when new software or updates go out via the Nanopore Community.

We urge you to update as soon as reasonably possible after the release has been made available.

Please note, you will not be able to update your device if connected remotely or if a sequencing run is in progress.

Open the MinKNOW UI via the desktop icon and the auto-updater will automatically check for updates when connected to the device.

A dialogue box will open when a new update is available.

Select Get Update to update the device software automatically.

Updates may be skipped. However, we recommend to update the device as soon as updates are available. Some updates will be mandatory to use the device and are unable to be skipped.

36

Note: For MinION Mk1B, clicking Get Update will open the Software Downloads page on the connected computer for you to download the updated MinION software.

You can also update the device from the Software page of the Host settings.

Navigate to Software in the Host settings and click Get Update to open the installer window.

An update button will only appear when a new version of the software is available to download.

Note: For MinION Mk1B devices, clicking Get Update will open the Software Downloads page on the connected computer for you to select and download the updated MinION software.

Software update 1

Click Install Update in the installer window to download the new update.

A change log for the update is available in this dialogue box.

Installer 1

Wait for the software to update; this may take several minutes.

Installer 2

The installer window will notify you when the update is complete.

Installer 3

After the update has completed successfully, complete a full power cycle to reboot the device.

重要

Re-installing MinKNOW

In some cases (e.g. if there is a problem with the version of MinKNOW that you are using), it may be necessary to re-install the software. To do this, first do a full uninstall of the current version by following the instructions in the Support article: How to uninstall MinION Software for Mk1B and P2 Solo

13. (Advanced) Updating the software via the Terminal

Obtain the latest updates

After successfully checking the hardware, you should update to the latest software release. To do this, enter the following commands into the terminal:

sudo apt clean
sudo apt update
sudo apt install ont-promethion-release

The default sudo password is __prom__; change this to ensure the security of your device. Once these commands have completed successfully with no errors, turn off the device using the following command. ``` sudo poweroff ```
Then turn the device on again to complete a full power cycle.

Updating the device in the future

Oxford Nanopore Technologies will post a release note in the Nanopore Community when new software or updates to the device go out.

We urge users to update as soon as reasonably possible after the release has been made available.

Keep the device up-to-date with Linux security updates, in line with advice from your local IT department.

Note: It is specifically required that you make outbound-only access to the internet over port 443 to enable updates through your network Firewall.

14. Downloading the ISO image and burning it to a USB drive

Overview

The below instructions can be used to create a bootable USB drive that can be used to rebuild the OS on your device.

These instructions are for users who did not receive a USB drive with the ISO image. If you have received a USB drive, proceed to the next step: "How to boot from USB".

重要

We strongly recommend transferring your data to backup storage even if you select an option that keeps the data. This is because ISO rebuilds can be corrupted halfway through (e.g. due to a USB disconnection, power cut etc.).

Download the ISO image from the link below:

Burning the ISO image to a USB drive

Appropriate software for burning the ISO image is:

Note: The alternate ISO burning tool balenaEtcher does not work for our ISO image. You will need access to a computer running Windows and may need Administrator rights to install the Rufus software.

Rufus

When burning the ISO image, use the below settings (it must use an EFI/GPT boot):

  • Partition scheme: GPT
  • Target system: UEFI

The USB drive should have the below specification:

  • Must be 32 GB or larger
  • USB 3.0 recommended
  • UEFI boot option must be used

Note: We recommend flashing two USB drives with a different vendor as a backup. Common USB drives can fail to reimage devices with no obvious root cause.

15. Preparing the PromethION for UEFI boot

The PromethION must be configured for UEFI Hard disk boot before you begin the rebuild process.

Power down the Data Acquisition Unit if it is switched on.

Insert the bootable USB into the USB port with the blue interior on the back of the device.

Note: If using an A-series/A100 Data Acquisition Unit, you may need to remove one of the USB firmware update cables connected to the sequencer.

Power on the Data Acquisition Unit, then when the below screen appears, press Delete to enter setup.

On A100/A-series Data Acquisition Units, ensure you are using the VGA output.

Nanopore wheel image correct

Once in setup, press the Right cursor key until Boot is highlighted.

Picture13

Within Boot, configure the following settings:

  • Boot mode select: UEFI
  • Boot Option #1: UEFI Hard Disk
  • Boot option #2: UEFI USB Hard Disk

Picture14

Use the cursor keys to navigate to Save & Exit, then select Save Changes and Reset.

Picture15

16. How to boot from USB

Power off the Data Acquisition Unit.

Power on the Data Acquisition Unit.

When the below screen appears, press F11 to enter the Boot Menu.

Nanopore wheel image correct

Choose the UEFI USB boot option using the cursor keys.

In the below example the USB drive is called SanDisk. If the system has not been prepared to boot from UEFI, this will not work. See the section Preparing the PromethION for UEFI boot for how to configure this.

Picture6

Press Enter once the UEFI option is chosen, then highlight Customer Factory Reset, and press Enter. This option will detect your installation and try to keep network configurations, hostname and /data partition. We recommend backing up data prior to proceeding with this step wherever possible.

Make sure to connect your device to the network if configured to run online.

Option What it does When to use option
Customer Factory Reset - Keeps network configuration
- Keeps hostname (i.e. PCA1XXX)
- Keeps data
- Does not clear the metadata or format all the disks
- To reset the device to a MinKNOW version reflected on the image name (e.g. 22.10 ISO = MinKNOW 22.10)
- To reset the device to a known state whilst attempting to keep existing data
Reset Install and keep /data - Keeps network configuration
- Keeps hostname (i.e. PCA1XXX)
- Keeps data
- Does not clear the metadata or format all the disks
Functionally identical to the Customer Factory Reset option
Format Disks and lose /data - Does not keep network configuration
- Does not keep hostname (i.e. PCA1XXX)
- Does not keep data
- Clears the metadata and formats all the disks
- Issue with data storage or a new unformatted drive (e.g. faulty drive or drive replaced)
- If the keep /data option does not resolve the issue
SECURE WIPE - can take hours - Does not keep network configuration
- Does not keep hostname (i.e. PCA1XXX)
- Does not keep data
Use only if requested by a member of Technical Services - this option completely wipes the disks by writing all data to 0

Reset options (2)

You will see the screen below. Select Standard Installation. A confirmation prompt will appear; click Okay.

Note: The blue desktop may fill the entire screen. You can press Esc to view the menu in the default browser.

Screen 2 (1)

Screen 3 (1)

The following screen will appear and the progress will be shown on the progress bar. The entire process may take ~1 hour to complete.

Note: It is normal for the system to restart multiple times. Do not turn off the Data Acquisition Unit while installation is in progress. It is also expected behaviour for the progress bars to stay temporarily stuck at specific stages.

Picture20

Once the rebuild process has completed, the standard login screen will be displayed. After logging in, you will see the MinKNOW icon on the desktop. If the MinKNOW icon is not present, carry out one final power cycle of the Data Acquisition Unit.

Screen5

Any previous changes to the device password will have defaulted back to prom. If you need to update the default password, follow the instructions here

Once the MinKNOW icon is displayed on the desktop, power down the Data Acquisition Unit. To use the PromethION for sequencing, now power on the Sequencing Unit followed by the Data Acquisition Unit and check all flow cell positions are detected.

17. Completing the restore

Eject the bootable USB by going to the File Explorer and selecting the Eject icon next to the USB device.

The keyboard and mouse may take several minutes to be recognised by the device during the first time booting up.

Press Ctrl+Alt+T to open a terminal window.

If your hostname has not been maintained through the restore process (it should be visible on the command line), type:

ont-promethion-serial set NAME_OF_DEVICE

where NAME_OF_DEVICE is the serial ID as included on the label on the side of your Data Acquisition Unit. For example:

ont-promethion-serial set PC24A0012

Press Enter.

Type "bash", then press Enter to confirm that the hostname has been set.

Configure your network.

A script has been written to help you to configure your network. Open a Terminal window and enter:

ont-network-settings

The options for this script are:

--dhcp (optional) - Use DCHP and removes need for all other features except for the interfaces, bond and overwrite --address ip_address (required) - IP address of the device --subnet subnet_mask (required) - Subnet mask for the device --gateway gateway_address (required) - Default gateway for the device --dns DNS_server1,DNS_server2 (required) - DNS servers for the device --search your_domain (required) - Your domain suffix (e.g. yourcompany.local) --overwrite (optional) --help - Details the options above

To update the settings, run the suitable command from the above options with the --overwrite flag and reboot your device.

Open MinKNOW and check for software updates, or check for updates in the terminal:

sudo apt update
sudo apt install ont-promethion-release

ont-system-test (not available on some ISO images)
ont-validate-install
You should see the following message if the installation was successful:

This should be complete, please retry any apt commands that failed to work previously
eg: sudo apt install 
All Packages installed and nvidia is happy, so resetting ont-restore-apt

If the installation was unsuccessful, run the following commands:
sudo apt update
sudo apt dist-upgrade
sudo ont-validate-install
sudo reboot

If the issue has not been resolved after a reboot, contact Technical Support at support@nanoporetech.com.

18. If problems are encountered

Boot to the "Platform Rescue and Recovery" screen.

7abd3d00-fd88-488b-814e-fb50d2200e6e

Click the "Format disks and lose /data" option.

7eaa1bfc-6174-4219-8e6e-c7284c072d18

Once returned to the following screen, click the top "Customer Factory Reset im" option.

Note: this step may happen automatically and proceed immediately to step 4 without user input.

bed531e6-a8b4-4964-b935-520d712f49e1

If the system takes more than 20 minutes between Step 2 and returning to the following screen, click "Standard Installation".

e513d899-ffd6-46d8-8109-f19b69c85d01

Allow the factory reset to continue.

Note: It is normal behaviour for the system to restart multiple times. Do not turn off the PromethION Data Acquisition Unit/GridION while the reset is in progress.

It is also expected behaviour for the progress bars to stay temporarily stuck at specific stages.

d2a6dfd2-9915-4708-832d-51148716cca7

Once the reset is complete, you will be prompted to login.

27dd199d-0a39-459d-86b0-f2a616725845

19. Troubleshooting your device

If there are any issues associated with your device or sequencing, please contact Technical Services.

To find our most common FAQs, please see the support section for MinKNOW here.

In most cases where troubleshooting is required, we recommend exporting your logs and sending them to Technical Services.

Help feature and support link from MinKNOW.

The Nanopore support hub can also be accessed directly from your MinKNOW UI.

In the top right of MinKNOW you will see the "Help" option:

MinKNOW UI Help option 6 0

Clicking this option will bring you to a page with a link and a QR code:

MinKNOW UI Help option QR 6 0

On larger devices such as the GridION and PromethION 24/48, and devices such as the MinION Mk1b and P2 Solo, clicking the link will directly bring you to the Nanopore support page.

On devices such as the P2 Integrated and MinION Mk1C, you will be able to scan the QR code with another device, or type in the shortened URL on another device to quickly reach the support hub.

To export logs:

For the PromethION 24/48, PromethION 2i, GridION and PromethION 2 Solo connected to a GridION:

  • Click Export in the Export Logs section.

When you have successfully exported the logs, you will be notified of where they are located below the button. The logs will be downloaded as a TGZ file in the logs directory.

You can change the location of the logs by using the file manager, where you can easily retrieve them without needing SSH:

  • Click on the file next to Logs exported to: in the Export Logs panel. This will open where the logs are located in the File Manager of MinKNOW.
  • Use the control panel in the lower right corner of the File Manager to move the log files.

export logs

If the PromethION 2 Solo is connected to a stand-alone computer

Log files for each sequencing experiment can be found in:

  • Windows C:\data\logs

  • Mac OS X /private/var/log/MinKNOW

  • Linux /var/log/minknow

To remove logs and temporary data:

In the "Help" page, click Clean up in the Clean Up Files section and confirm in the in the pop-up.

Note: Run data will not be deleted. Logs and temporary data will be removed.

clean up

To repair device issues:

Click Run repair in the troubleshooting section of the Help page and confirm in the pop-up. MinKNOW will attempt to repair the following issues:

  • Ensure required directories under "/data" exist and have the correct ownership and permissions
  • Ensure required files under "/data" have the correct ownership and permissions
  • Ensure the GPU is working at maximum performance
  • Ensure that Bluetooth is disabled

Screenshot 2023-01-24 125625

Last updated: 4/30/2024

Document options