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.
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.
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.
Before you proceed, ensure that you have successfully installed
$ 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:
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.
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
~/.inacceldirectory). 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.
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 (
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
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.