Skip to content

Install InAccel on Amazon Linux / CentOS / Fedora / Red Hat Enterprise Linux-

time/embed

To get started with InAccel on Amazon Linux / CentOS / Fedora / Red Hat Enterprise Linux follow the installation steps.

Installation methods-

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

  • Most users set up InAccel’s repository and install from it, for ease of installation and upgrade tasks. This is the recommended approach.

  • Some users download the RPM packages and install them 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.

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

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.

Set up the repository-

Install the yum-utils package (which provides the yum-config-manager utility) and set up the repository.

sudo yum install -y yum-utils

sudo yum-config-manager \
  --add-repo \
  https://setup.inaccel.com/inaccel.repo

Install InAccel-

  1. Install the latest version of InAccel, InAccel CLI, InAccel Docker, and InAccel FPGA:

    sudo yum install inaccel inaccel-cli inaccel-docker inaccel-fpga

    This command installs InAccel, but it doesn’t start InAccel.

  2. Start InAccel and configure InAccel to start on boot.

    sudo systemctl enable --now inaccel

Install from packages-

If you cannot use InAccel's repository to install InAccel, you can download the .rpm files for your release and install them manually. You need to download new files each time you want to upgrade InAccel.

  1. Go to https://cloudsmith.io/~inaccel/repos/stable/groups/?q=format:rpm.

  2. Download the following rpm files for the InAccel, InAccel CLI, InAccel Docker, and InAccel FPGA packages:

    • inaccel-<version>-1.x86_64.rpm

    • inaccel-cli-<version>-1.x86_64.rpm

    • inaccel-docker-<version>-1.x86_64.rpm

    • inaccel-fpga-<version>-1.x86_64.rpm

  3. Install the .rpm packages. Update the path in the following example to where you downloaded the InAccel packages.

    sudo yum install /path/to/package.rpm

    The InAccel daemon doesn't start automatically.

  4. Start InAccel and configure InAccel to start on boot.

    sudo systemctl enable --now inaccel

Upgrade InAccel-

To upgrade InAccel, download the newer package files and repeat the installation procedure, pointing to the new files.

Install using the convenience script-

InAccel provides a convenience script at https://setup.inaccel.com/repository to install InAccel into development environments non-interactively. The convenience script isn’t recommended for production environments, but it’s useful for creating a provisioning script tailored to your needs. Also refer to the install using the repository steps to learn about installation steps to install using the package repository.

Always examine scripts downloaded from the internet before running them locally. Before installing, make yourself familiar with potential risks and limitations of the convenience script:

  • The script requires root or sudo privileges to run.

  • The script attempts to detect your Linux distribution and version and configure your package management system for you.

  • The script doesn’t allow you to customize most installation parameters.

  • The script installs dependencies and recommendations without asking for confirmation. This may install a large number of packages, depending on the current configuration of your host machine.

This example downloads the script from https://setup.inaccel.com/repository and runs it to install the latest stable release of InAccel on Linux:

curl -fsSL https://setup.inaccel.com/repository -o setup-inaccel.sh
sudo sh setup-inaccel.sh install

Upgrade InAccel after using the convenience script-

If you installed InAccel using the convenience script, you should upgrade InAccel using your package manager directly. There’s no advantage to re-running the convenience script. Re-running it can cause issues if it attempts to re-install repositories which already exist on the host machine.

Uninstall InAccel-

  1. Uninstall the InAccel, InAccel CLI, InAccel Docker, and InAccel FPGA packages:

    sudo yum remove inaccel inaccel-cli inaccel-docker inaccel-fpga

  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.

Next steps-

Last update: April 3, 2023