Skip to content

Latest commit

 

History

History
153 lines (101 loc) · 4.16 KB

CENTOS_7-guide.rst

File metadata and controls

153 lines (101 loc) · 4.16 KB
Raw

CentOS 7 Setup Guide

This document describes steps to set up a Centos 7 single host devstack environmenmt using networking-vpp.

Host Setup

  1. Configure hugepage and iommu support:

    default_hugepagesz=2M hugepagesz=2M hugepages=2048 iommu=pt intel_iommu=on

VPP build and install

  1. pull VPP source from git:

    git clone https://gerrit.fd.io/r/vpp

  2. Build and install VPP:

    cd vpp
make install-dep
make build-release
make pkg-rpm

  3. Install VPP rpms. The rpms are located in vpp/built-root directory after build is complete:

    sudo yum install build-root/vpp*.rpm

  4. Build and install VPP-PAPI. VPP-PAPI is VPP's python API used by networking-vpp.

    • Install python-devel package if it is not installed already:

      sudo install -y python-devel

    • Build and install:

      make -Cbuild-root PLATFORM=vpp TAG=vpp_debug vpp-api-install
cd vpp-api/python
sudo python setup.py install

  5. Configuring VPP

    It may be desirable to change vpp cli's listening port to something other than the default 5000, as it is used by keystone. This can be done by adding line cli-listen localhost:5002 in unix section of VPP config file /etc/vpp/startup.conf.

    It is necessary to load pmd kernel module of choice (vfio-pci, igb_uio, etc). igb_uio module can be found in dpdk build directory: build-root/install-vpp-native/dpdk/kmod/igb_uio.ko

  6. Starting VPP

    VPP can be started by starting VPP service:

    systemctl start vpp

    To verify VPP has started correctly:

    vppctl show interface

    You should see your physical NIC listed in the interface list, in this case GigabitEthernet2/5/0:

    Name               Idx       State          Counter          Count
GigabitEthernet2/5/0              5        down
local0                            0        down
pg/stream-0                       1        down
pg/stream-1                       2        down
pg/stream-2                       3        down
pg/stream-3                       4        down

More detailed instruction on vpp building and installing can be found at: https://wiki.fd.io/view/VPP/Build,_install,_and_test_images#Build_A_VPP_Package

Upgrade qemu-kvm

  1. Enable Centos EV repo

    yum install centos-release-qemu-ev

  2. Update packages, this will pick up new qemu packages from EV repo.

    yum update

  3. Remove qemu-system-x86 package if it's installed, this will prevent libvirt from identifying QEMU version to be 2.0

    yum remove qemu-system-x86

Build and install qemu

If you would like to use qemu rather than qemu-kvm, you can build and install qemu with the following steps:

wget http://wiki.qemu-project.org/download/qemu-2.3.1.tar.bz2
tar xvf qemu-2.3.1.tar.bz2
cd qemu-2.3.1
sudo yum install gtk2-devel
./configure  --enable-numa
make
sudo make install

Devstack Setup

General direction on how to download and set up devstack can be found at http://docs.openstack.org/developer/devstack/

Add the following to local.conf:

disable_service n-net q-agt
disable_service cinder c-sch c-api c-vol
disable_service tempest

enable_plugin networking-vpp https://github.com/iawells/networking-vpp.git
ENABLED_SERVICES+=,q-svc,q-meta,q-dhcp
Q_PLUGIN=ml2
Q_ML2_TENANT_NETWORK_TYPE=vlan
ML2_VLAN_RANGES=physnet:100:200
Q_ML2_PLUGIN_EXT_DRIVERS=
Q_ML2_PLUGIN_MECHANISM_DRIVERS=vpp
Q_ML2_PLUGIN_TYPE_DRIVERS=vlan
VLAN_TRUNK_IF='GigabitEthernet2/5/0'

Note that VLAN_TRUNK_IF should be set to the interface name in VPP that you want to use as your trunk interface.

VM creation

Note that hugepage support is required on guest VMs for vhostuser port attachment, this can be done by creating a new flavor and booting the VM with the flavor:

nova flavor-create m1.tiny.hugepage auto 512 0 1
nova flavor-key m1.tiny.hugepage set  hw:mem_page_size=2048

nova boot --image cirros-0.3.4-x86_64-uec --flavor m1.tiny.hugepage --nic net-name=private myvm