Local Installation

Get Parabricks up and running on any linux system with Nvidia GPUs.

Prerequisites

The following are required to install Parabricks:

  • Access to the internet

  • nvidia-driver that supports cuda-9.0 or higher

  • nvidia-driver that supports cuda-10.0 or higher if you want to run deepvariant or cnnscorevariants

  • nvidia-docker or singularity version 2.6.1 or higher

  • Python 2.7 (Most Linux systems will already have this installed)

  • curl (Most Linux systems will already have this installed)

Installation Steps

The user must have received the parabricks.tar.gz file from Parabricks. This package contains all items necessary to install and run the Parabricks software. To request a copy, please contact info@parabricks.com.

Install the Parabricks package to your system:

# Step 1: Unzip the package.
tar -xzf parabricks.tar.gz
# Step 2: Run the installer
sudo ./parabricks/installer.py
# Step 3: verify your installation.
# This should display the parabricks version number:
pbrun version

Installation Options

The default installation option for the package received by you, should have the correct options. However, you can modify the following options.

Options

Details

--install-location

Location in which a folder by the name of parabricks will be created. The parabricks folder will contain everything needed to run the software. The user must have permission to write to this location. (default: /opt/)

--container

Container technology to use. Currently we support, nvidia-docker, docker with nvidia-container-runtime support and singularity version 2.6.1

--release

The parabricks release version you want to install. Contact support@parabricks.com, if you do not want the default version and need more information

--cpu-only

Install on a CPU server. No GPU accelerated tools will run with this option

--symlink

Create a symlink at /usr/bin/pbrun. You can choose to do this during the installation

--arch

Default architecture of the hardware. Currently we support x64_64 or ppc64le

--uninstall

Uninstall parabricks. Removes all the images and scripts from --install-location

Package contents:

  • installer.py: Installer to download and install the software

  • license.bin: License file based on your license with Parabricks

  • EULA.txt: End User License Agreement

Installing with Singularity 3.0 or higher

1) Log in to a machine with sudo access and singularity 3.0 or higher. 2) To download the software: $ wget -O parabricks.tar.gz "< DOWNLOAD_LINK >" 3) Unzip the package $ tar -xvzf parabricks.tar.gz 4) Do a local installation:$ mkdir localdir $ sudo ./parabricks/installer.py --install-location localdir --container singularity 5) Everything will be installed in localdir/parabricks folder. Tar this folder.$ cd localdir $ tar -cvzf parabricks_install.tar.gz parabricks 6) and copy it to the node which will be used for testing and has singularity v3.x. 7) Untar the tar.gz file in some <INSTALL_DIR>$ cd <INSTALL_DIR> $ tar -xvzf parabricks_install.tar.gz

Uninstalling Parabricks

To uninstall, you can run the uninstall tool:

./parabricks/installer.py --uninstall