Skip to content

Part 2: Setup the working environment

Estimated reading time: 7 minutes

In this section, we thoroughly explain how to setup your working environment in order to run applications powered by InAccel Coral FPGA resource manager.

Prerequisites-

  1. InAccel (inaccel) package (CLI + Container Runtime) should be installed in your system. If you have not already installed InAccel follow the instructions provided here: Debian | RPM.

    Info

    While InAccel CLI is not a true requirement, we strongly encourage the usage of the CLI instead of directly tinkering with any associated commands. Setting up Coral without InAcccel CLI and/or InAccel Container Runtime is out of the scope of this tutorial.

  2. Docker (docker) installation that fully supports custom runtimes is required for running Coral which is shipped as a container image. If you are planning to use InAccel CLI only for bitstream deployment (to any remote repository), then you can skip Docker package installation in that machine.

Verify installation-

Before you proceed, ensure that you have successfully installed inaccel by running inaccel --version:

$ inaccel --version
inaccel version 1.3

If your terminal's output is similar or identical to the output above then you can assume that inaccel is properly installed and continue with generating your free license key.

Generate a license-

In order to launch Coral, you need a valid license key issued by InAccel. This can be easily achieved through the following steps:

  1. Follow this link and complete the form to make an inquiry for a free license. Then, click on button CREATE NEW LICENSE and you will receive an email by InAccel containing th Community Edition license key you requested.

  2. Retrieve the license key attached to your email and store it in your local InAccel settings to use it every time you launch Coral (the settings file can be found below the ~/.inaccel directory). Simply issue the following commmand:

    $ inaccel config license CORAL_LICENSE_KEY
    

Launch InAccel Coral-

If you completed the above steps, then you are ready to launch Coral. To make things clear, Coral is not required to be launched neither at installation nor at bitstream deployment stage. Its functionality is to manage accelerators, hence you only need a running instance when your applications are running.

Nevertheless, we suggest to launch Coral now to complete your environment setup. If you wish, feel free to skip this section and come back before moving to Part 4.

Warning

If you are launching InAccel Coral for the first time make sure you restart docker daemon service by issuing systemctl docker restart to enable InAccel container runtime (inaccel-runc).

  1. Start Coral through its associated CLI command.

    $ inaccel coral start --only
    Using InAccel Coral:
    latest: Pulling from inaccel/coral
    72d97abdfae3: Pull complete
    309405f4efb3: Pull complete
    92c220a9fc99: Pull complete
    e605f08227eb: Pull complete
    Digest: sha256:101473325ecdb71adc4e077ebc8506de2b1895224d2cf8a64ad805c868a9ee04
    Status: Downloaded newer image for inaccel/coral:latest
    
  2. Verify Coral is successfuly launched by issuing inaccel coral console.

    $ inaccel coral console
    21 Coral FPGA Resource Manager
    
    Welcome to
                              |
      __|   _      __|  _` |  |
     (     (   |  |    (   |  | community
     ___|  ___/  _|    __,_| _| version 1.5
                     by InAccel
    

Congratulations, you have successfully completed your InAccel environment setup. In Part 3, we get our hands dirty by demonstrating how to package and deploy your accelerators.