PromethION: Protocol
PromethION 24/48 user manual V PIC_1013_v1_revZ_12Nov2019
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.
FOR RESEARCH USE ONLY
Contents
Overview
Installation
- 2. What's in the box
- 3. Installing and powering on the device
- 4. Network settings and connection
- 5. Changing the default password and hostname
- 6. (Advanced) Updating the timezone and setting a local NTP server
- 7. Hardware check
Pre-sequencing checks and sequencing run
After completing a sequencing run
Updating the software
Operating system update on PromethION
- 14. Downloading the ISO image and burning it to a USB drive
- 15. Preparing the PromethION for UEFI boot
- 16. How to boot from USB
- 17. Completing the restore
- 18. If problems are encountered
Troubleshooting
概要
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.
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.
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
- PromethION 24 Sequencing Unit
- PromethION 24 Data Acquisition Unit
- 3x Country-specific C13 cables
- 24x Configuration Test Cells (CTCs)
- 2x PCIe cables
- 2x USB-A/Mini USB cable
- 1x USB-A/USB B cable
- 1x MiniDP/Display port cable
- 1x USB-A stick (ISO reset image)
- 1x USB-C/USB-A adapter
What's in the box - PromethION 48
- PromethION 48 Sequencing Unit
- PromethION 48 Data Acquisition Unit
- 3x Country-specific C13 cables
- 48x Configuration Test Cells (CTCs)
- 3x PCIe cables
- 3x USB-A/Mini-USB cable
- 1x USB-A/USB-B cable
- 1x MiniDP/Display port cable
- 1x USB-A stick (ISO reset image)
- 1x USB-C/USB-A adapter
3. Installing and powering on the device
重要
If you have purchased a PromethION 24 Combined, the device must only be unpacked and installed by an Oxford Nanopore Technologies Field Service Engineer.
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 48 Sequencing and Data Acquisition Units
オプショナルステップ
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.
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.
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.
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.
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:
- 2x USB A – Mini USB
- 1x USB A to USB B from the Data Acquisition Unit to the Sequencing Unit (see the diagram below):
PromethION 48 Connect:
- 3x USB A – Mini USB
- 1x USB A to USB B from the Data Acquisition Unit to the Sequencing Unit (see the diagram below):
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.
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:
- Turn on the Sequencing Unit
- Wait for 3 minutes
- Turn on the Data Acquisition Unit
Double-click the MinKNOW icon located on the desktop to open the MinKNOW UI.
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.
You will be prompted to enter your email address and Nanopore password:
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.
You will be taken to the Sequencing Overview, displaying the connected flow cells.
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:
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.
Instructions for setting up a copper connection
Single copper port on DHCP service
- 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.
Dual copper ports on DHCP service
- 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 ports with a static IP address
- 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.
Instructions for setting up a fibre connection
Single fibre port on DHCP service
- 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:
Dual fibre ports on DHCP service
- 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 ports with a static IP address
- 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.
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.
In the Change Password dialogue box, enter your current password, followed by the new password.
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.
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.
Press the CTC down firmly into the loader, and ensure that the latch engages.
Insertion of the CTC at the wrong angle can damage the pins on the PromethION:
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
Navigate to the start homepage and click 'Hardware check'.
Select all the CTCs in the UI and click Start for the check to begin.
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).
最終ステップ
The hardware check will complete after approximately one minute.
Hardware check pass is indicated by a green check icon.
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 12 weeks 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 |
重要
冷蔵庫からフローセルを取り出した後にフローセルが室温に戻るまで20分待ってからPromethIONに差し込んでください。湿度の高い環境ではフローセルに結露が生じることがあります。フローセルの上面と下面にある金色のコネクターピンに結露がないかを点検し、結露が確認された場合はリントフリーのウェットティッシュで拭き取ってください。フローセル下面にヒートパッド(黒いパッド)があることを確認してください。
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.
Press the flow cell down firmly into the loader, and ensure that the latch engages.
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.
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
Navigate to the start homepage and click 'Flow cell check'.
When you see the flow cell type and flow cell IDs recognised, click Start to begin.
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).
Flow cell health indicators
The quality of the flow cell will be shown as one of the three outcomes:
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
Green tick (MinION flow cell): The number of sequencing pores is above warranty.
Question mark (PromethION flow cell): A flow cell check has not been run on the flow cell during this MinKNOW session.
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.
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
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.
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.
Select Shutdown.
Click Shut Down in the pop-up to confirm.
ヒント
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.
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.
Note: For MinION Mk1B/Mk1D, 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.
Click Install Update in the installer window to download the new update.
A change log for the update is available in this dialogue box.
Wait for the software to update; this may take several minutes.
The installer window will notify you when the update is complete.
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 MinKNOW Software for the MinION Mk1B, Mk1D and P2 Solo Devices.
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:
- Rufus on Windows
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.
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.
Once in setup, press the Right cursor key until Boot is highlighted.
Within Boot, configure the following settings:
- Boot mode select: UEFI
- Boot Option #1: UEFI Hard Disk
- Boot option #2: UEFI USB Hard Disk
Use the cursor keys to navigate to Save & Exit, then select Save Changes and Reset.
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.
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.
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 |
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.
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.
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.
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.
Click the "Format disks and lose /data" option.
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.
If the system takes more than 20 minutes between Step 2 and returning to the following screen, click "Standard Installation".
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.
Once the reset is complete, you will be prompted to login.
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:
Clicking this option will bring you to a page with a link and a QR code:
On larger devices such as the GridION and PromethION 24/48, and devices such as the MinION Mk1B/Mk1D 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.
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
macOS: /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.
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