Node Locked License, Docker Container

Prerequisites

Installing Parabricks via the Docker container installer requires the following:

  • A working Nvidia driver

  • A working nvidia-docker2 setup

  • Installer package, something similar to parabricks.tar.gz

You can refer to the section Installation Requirements for more details

Software Installation

This section assumes you have the installer package as parabricks.tar.gz either through the Trial Process or through the License Portal. For node locked licenses, you should have requested a license.bin from EnterpriseSupport@nvidia.com

# Extract the installation package.
$ tar -xzf parabricks.tar.gz

# Install the software.
$ sudo ./parabricks/installer.py

# Verify your installation.
# This should display the parabricks version number:
$ pbrun version

During the installation, you'll be asked the following:

  1. To accept the end user license agreement.

  2. If you want to create a symbolic link from the Parabricks installation to /usr/bin/pbrun (requires sudo access).

  3. If you want to install the Ampere version or the non-Ampere version.

To check if your system has Ampere GPUs, run the following:

nvidia-smi --query-gpu=name --format=csv,noheader

Any GPU labeled with the first letter A (e.g. 'Tesla A100', 'Tesla A40') is an Ampere GPU.

Note

If your machine has more GPUs than you have licenses, you will need to specify which, and how many, GPUs to use. For example, use the following flags to select only the first two GPUs:

CUDA_VISIBLE_DEVICES="0,1" pbrun [command and inputs]  --num-gpus 2

After installation the pbrun command will start any tool in the Parabricks software suite. Answering "yes" to the 2nd question (about creating a symbolic link) will make pbrun available for system wide access. Otherwise you can access pbrun from your local installation directory, which is /opt/parabricks/pbrun by default.