How to get the Netronome Agilio vRouter smart network card (installation and setup guide)

Author: Savithru Lokanath Translator: TF compilation group

TF-Netronome architecture

Lab settings

Preparation conditions

• At least two nodes: one controller node + one computing node
• Ubuntu 14.04.4（3.13.0-100 Errata 47 patched kernel）
• TF- Cloud 3.1.2.0-65（OpenStack Kilo/Mitaka）
• Agilio vRouter 3.1.0.0-124

Netronome SmartNIC Installation Guide (New Installation)

Note: This guide assumes that you have already inserted the Netronome NIC in the server.

On all nodes

• Install Ubuntu 14.04.4 on all nodes in the setup
• Download and install the Tungsten Fabric package on the node

   (all-nodes)# dpkg -i contrail-install-packages_3.1.2.0-65~mitaka_all.deb
   (all-nodes)# /opt/contrail/contrail_packages/setup.sh
   (all-nodes)# apt-get update

• Download Netronome (Agilio vRouter) software package and copy to all nodes

   (all-nodes)# tar -xvf ns-agilio-vrouter-release_3.1.0.0-124.tgz 
   (all-nodes)# cd ns-agilio-vrouter-release_3.1.0.0-124/
   (all-nodes)# cp ns-agilio-vrouter-depends-packages_3.1.0.0-124_amd64.deb /opt/contrail/contrail_install_repo/
   (all-nodes)# cd /opt/contrail/contrail_install_repo/
   (all-nodes)# dpkg-scanpackages . /dev/null | gzip -9c > Packages.gz
   (all-nodes)# apt-get update

On the controller node

• Fill the test platform with relevant information

   (controller-node)# vim /opt/contrail/utils/fabfile/testbeds/testbed.py

            bond= {
                compute1 : { 'name': 'bond0', 'member': ['nfp_p0','nfp_p1','nfp_p2','nfp_p3'], 'mode': '802.3ad',    
                          'xmit_hash_policy': 'layer3+4' },
                compute2 : { 'name': 'bond0', 'member': ['nfp_p0','nfp_p1','nfp_p2','nfp_p3'], 'mode': '802.3ad',    
                          'xmit_hash_policy': 'layer3+4' },
            }

            control_data = {
                controller : { 'ip': '172.31.255.1/24', 'gw' : '172.31.255.1', 'device': 'eth1' },
                compute1 : { 'ip': '172.31.255.2/24', 'gw' : '172.31.255.1', 'device': 'bond0' },
                compute2 : { 'ip': '172.31.255.3/24', 'gw' : '172.31.255.1', 'device': 'bond0' },
            }

            env.ns_agilio_vrouter = {
                compute1: {'huge_page_alloc': '24G', 'huge_page_size': '1G', 'coremask': '2,4', 'pinning_mode': 
                            'auto:split'},
                compute2: {'huge_page_alloc': '24G', 'huge_page_size': '1G', 'coremask': '2,4', 'pinning_mode': 
                            'auto:split'}
            }

• Enable Netronome SmartNIC

   (controller-node)# cd /opt/contrail/utils/
   (controller-node)# fab install_ns_agilio_nic
   (controller-node)# reboot
   (controller-node)# fab install_ns_agilio_nic

Note: You may encounter a "python-dev package not found on the target node" error.

(target-node)# aptitude install python-dev

Select "No" in the first prompt and "Yes" in the second prompt. Re-run fab install_ns_agilio_nic

(controller-node)# fab install_ns_agilio_nic

• If you are using a branch cable (4×10GbE → 1×40GbE), please change the media configuration of SmartNIC.

   This should create four NFP interfaces: nfp_p0, nfp_p1, nfp_p2, nfp_p3

   (compute-node)# /opt/netronome/bin/nfp-media --set-media=phy0=4x10G
   (compute-node)# service ns-core-nic.autorun clean
   (compute-node)# reboot

安装Tungsten Fabric

  (controller-node)# cd /opt/contrail/utils
  (controller-node)# fab install_contrail

Note: You may encounter the error "The default-jre-headless package cannot be found on the target node".

 (target-node)# aptitude install default-jre-headless

Select "No" in the first prompt and "Yes" in the second prompt. Re-run fab install_contrail

   (controller-node)# fab setup_interface (Verify if all nodes can talk with each other on Control/Data interface)
   (controller-node)# fab setup_all

On the Netronome compute node

• Verify that the provisioning is successful

   (compute-nodes)# contrail-status
   (compute-nodes)# /opt/netronome/libexec/nfp-vrouter-status -r

• Create VirtIO flavors

Note: only execute once

(compute-node)# cd /ns-agilio-vrouter-release_3.1.0.0-124/ns-agilio-vrouter_3.1.0.0-124/opt/netronome/openstack
(compute-node)# ./make_virtio_flavors.sh <controller-ip-address>

Netronome SmartNIC Installation Guide (existing setup)

Note: This guide assumes that you have already inserted the Netronome NIC in the server.

On the new Netronome compute node

• Install the required Linux kernel

  (compute-node)# apt-get install linux-image-3.13.0-100-generic 
  (compute-node)# apt-get install linux-headers-3.13.0-100-generic 
  (compute-node)# apt-get install linux-image-extra-3.13.0-100-generic 
  (compute-node)# apt-get install linux-image-generic 
  (compute-node)# apt-get install linux-generic

In the /etc/default/grub directory, make sure

 GRUB_DEFAULT='1>Ubuntu, with Linux 3.13.0-100-generic'
 GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=on iommu=pt intremap=on"

 (compute-node)# update-grub
 (compute-node)# reboot

• Items required to install NFP

(compute-node)# apt-get install dkms libftdi1 libjansson4

• Download Netronome (Agilio vRouter) software package

(compute-node)# tar -xvf ns-agilio-vrouter-release_3.1.0.0-124.tgz 
(compute-node)# cd ns-agilio-vrouter-release_3.1.0.0-124/

• Install NFP package

  (compute-node)# dpkg -i nfp-bsp-6000-b0*
  (compute-node)# ldconfig

• Refresh SmartNIC

  (compute-node)# /opt/netronome/bin/nfp-flash -P --i-accept-the-risk-of-overwriting-miniloader -w /opt/netronome/flash/flash-nic.bin 
  (compute-node)# /opt/netronome/bin/nfp-one
  (compute-node)# reboot

• Install core network card package

  (compute-node)# cd ns-agilio-vrouter-release_3.1.0.0-124/
  (compute-node)# dpkg -i ns-agilio-core-nic*.deb

• If you are using a branch cable (4×10GbE → 1×40GbE), please change the media configuration of SmartNIC.

   This should create four NFP interfaces: nfp_p0, nfp_p1, nfp_p2, nfp_p3

   (compute-node)# /opt/netronome/bin/nfp-media --set-media=phy0=4x10G
   (compute-node)# service ns-core-nic.autorun clean
   (compute-node)# reboot

• Populate the test platform with information from the new compute node

   (controller-node)# vim /opt/contrail/utils/fabfile/testbeds/testbed.py

            bond= {
                compute3 : { 'name': 'bond0', 'member': ['nfp_p0','nfp_p1','nfp_p2','nfp_p3'], 'mode': '802.3ad',    
                          'xmit_hash_policy': 'layer3+4' }
            }

            control_data = {
                controller : { 'ip': '172.31.255.1/24', 'gw' : '172.31.255.1', 'device': 'eth1' },
                compute3 : { 'ip': '172.31.255.4/24', 'gw' : '172.31.255.1', 'device': 'bond0' }
            }

            env.ns_agilio_vrouter = {
                compute3: {'huge_page_alloc': '24G', 'huge_page_size': '1G', 'coremask': '2,4', 'pinning_mode': 
                            'auto:split'},
            }

• 安装Tungsten Fabric

   (controller-node)# cd /opt/contrail/utils
   (controller-node)# fab install_pkg_node:/tmp/contrail-install-packages*.deb,root@<new-compute-ip>
   (controller-node)# ssh root@<new-compute-ip> "cd /opt/contrail/contrail_packages; ./setup.sh"

   (controller-node)# scp /tmp/ns-agilio-vrouter-depends-packages*.deb root@:<new-compute-ip>:/opt/contrail/contrail_install_repo/
   (controller-node)# fab install_pkg_node:/tmp/ns-agilio-vrouter-depends-packages*.deb,root@<new-compute-ip>
   (controller-node)# ssh root@<new-compute-ip> "cd /opt/contrail/contrail_packages_ns_agilio_vrouter; ./setup.sh"
   (controller-node)# ssh root@<new-compute-ip> "cd /opt/contrail/contrail_install_repo; dpkg-scanpackages . /dev/null | gzip -9c > Packages.gz; apt-get update"

   (controller-node)# fab add_vrouter_node:root@<new-compute-ip>

(Note: Contrail is replaced by Tungsten Fabric with the same function in the text)