Debian-based Installation-
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.