Skip to content

Reference Operating System Setup Guide

Yuta edited this page Aug 18, 2021 · 1 revision

Pre-requires

You need to download the software below. Xilinx Tools should be downloaded in the setup host after installing OS.

Hardware equipments

On NetFPGA-PLUS, you will need the all of the list, in addition to the machine. If you don't need hardware test, you can ignore the list.

  • Xilinx Alveo Cards(U200, U250, U280) or VCU1525
  • 2-ports QSFP+ 100GbE Network Interface Card (For Hardware Test)
  • Direct Attached Cable for QSFP+ x2

Warning

Some of the updates on this page can cause your system to crash if done incorrectly. Especially if working remotely, take extra care and make sure you understand the changes done. Note that some values on this page (license path, MAC address) are examples only.

0. Install Operating System

Install Ubuntu 18.04 (LTS) http://releases.ubuntu.com/18.04/ubuntu-18.04.2-desktop-amd64.iso

1. Edit Grub Configuration

Edit file /etc/default/grub to rename NIC device name to ethX.

------------------------------------------------------------------
>>
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
<<
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash biosdevname=0 net.ifnames=0 intel_iommu=on"
------------------------------------------------------------------
# update-grub2
# reboot

2. Network Setup

Netplan is the network configuration abstraction renderer utility for a linux system. In order to name the interfaces based on their MAC addresses edit the following configuration file: /etc/netplan/01-network-manager-all.yaml and apply changes sudo netplan apply (might require system reboot). Follow the 01-network-manager-all.yaml configuration example below and make the necessary changes based on your MAC addresses.

----------------------------------------------------------
# Let NetworkManager manage all devices on this system
network:
 version: 2
 renderer: networkd
 ethernets:
   gateway:
     match:
       macaddress: QQ:WW:EE:RR:TT:YY
     dhcp4: false
     dhcp6: false
     addresses: [A.B.C.D/E]
     gateway4: A.B.C.D
     nameservers:
       addresses: [X.X.X.X]
       search: [Y.Y.Y.Y]
     optional: true
   nf-port0:
     match:
       macaddress: 00:0a:35:03:00:00
     optional: true
     set-name: nf0
   nf-port1:
     match:
       macaddress: 00:0a:35:03:00:01
     optional: true
     set-name: nf1
----------------------------------------------------------
# netplan apply
# reboot

Disable Avahi daemon

To disable the daemon edit /etc/avahi/avahi-daemon.conf and change the following:

use-ipv4=no
use-ipv6=no

then run the following command to restart the service:

[user@nf-test109]# sudo service avahi-daemon restart

Disable IPv6

To temporary disable IPv6 run the following command:

[user@nf-test109]# sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1

or please append this lines to /etc/sysctl.conf

net.ipv6.conf.all.disable_ipv6=1
net.ipv6.conf.default.disable_ipv6=1

Reboot.

If it didn't work on your environment, please add 'ipv6.disable=1' on grub configuration file. On /etd/defualt/grub, you can edit it.

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash biosdevname=0 net.ifnames=0 intel_iommu=on ipv6.disable=1"

Then, update the grub file.

# update-grub2

Reboot.

3. Packages

# apt install vim git ssh make libc-dev gcc python3-pip libpcap-dev libnet1-dev

Please install scapy for python3.

# pip3 install scapy scapy-python3

4. Vivado Installation

Once you setup network configuration and verified to access the Internet, then you can get Vivado installation image from Xilinx page. Please download Vivado 2020.2

5. USB Driver

To download a bitstream file synthesized in Vivado, you need to install USB driver.

 # cd /tools/Xilinx/Vivado/2020.2/data/xicom/cable_drivers/lin64/install_script/install_drivers/
 # ./install_drivers

6. Setup

Adding script for bashrc

Add these lines to file /etc/bash.bashrc

source /tools/Xilinx/Vivado/2020.2/setting64.sh
export XILINXD_LICENSE_FILE=12345@license.abc.xyz

(Vivado path and license are as an example only)