Debian-based Installation-

_{Estimated reading time: 7 minutes}

This document elaborates on the installation process of InAccel ecosystem for Debian-based distributions (Debian / Ubuntu).

Install InAccel-

You can install InAccel in different ways, depending on your needs:

Most users set up InAccel’s repositories and install from them, for ease of installation and upgrade tasks. This is the recommended approach.
Some users download the DEB package and install it manually and manage upgrades completely manually. This is useful in situations such as installing InAccel on air-gapped systems with no access to the internet.

Install using the repository-

Before you install InAccel for the first time on a new host machine, you need to set up the InAccel repository. Afterward, you can install and update InAccel from the repository.

SETUP THE REPOSITORY

Note:

In testing and development environments, some users choose to use the automated convenience script to setup InAccel repository.

Step 1 Update the apt package index:

sudo apt-get update

Step 2 Install packages to allow apt to use a repository over HTTPS:

sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

Step 3 Add InAccel's official GPG key:

curl -fsSL https://jfrog.inaccel.com/artifactory/generic/packages/gpg | sudo apt-key add -

Step 4 Use the following command to set up the repository.

sudo add-apt-repository \
    "deb [arch=amd64] https://jfrog.inaccel.com/artifactory/generic/packages/debian /"

INSTALL INACCEL

Step 1 Update the apt package index.

sudo apt-get update

Step 2 Install the latest version of InAccel:

sudo apt-get install -y inaccel

Step 3 InAccel offers a modified/extended version of runc by adding custom pre-start and post-stop hooks to Coral containers. By providing our custom runtime we enable implicit loading of drivers and libraries of FPGA vendors to provide a zero-configuration experience. To make docker aware of those changes you need to restart its daemon:

sudo systemctl restart docker

Step 4 Verify that InAccel is installed correctly.

inaccel --version

Install from a package-

If you cannot use InAccel's repository to install InAccel, you can download the .deb file for your release and install it manually. You need to download a new file each time you want to upgrade InAccel.

Step 1 Go to https://jfrog.inaccel.com/artifactory/generic/packages/debian and download the .deb file for the InAccel version you want to install.

Step 2 Install InAccel, changing the path below to the path where you downloaded the InAccel package.

sudo dpkg -i /path/to/package.deb

Step 3 Restart docker service to enable InAccel's custom runc hooks (as mentioned above):

sudo systemctl restart docker

Step 4 Verify that InAccel is installed correctly.

inaccel --version

Uninstall InAccel-

Step 1 Uninstall the InAccel package:

sudo apt-get purge inaccel

Step 2 Bitstreams, or customized configuration files on your host are not automatically removed. To delete all bitstreams:

sudo rm -rf /var/lib/inaccel

You must delete any edited configuration files manually.