.. _DPDK: http://dpdk.org/doc/nics
.. _DPDK-pktgen: https://github.com/Pktgen/Pktgen-DPDK/
.. _SRIOV: https://wiki.openstack.org/wiki/SR-IOV-Passthrough-For-Networking
+.. _PORTSEC: https://wiki.openstack.org/wiki/Neutron/ML2PortSecurityExtensionDriver
===========================
Apexlake installation guide
apt-get install tcpreplay
apt-get install libpcap-dev
-2. Install the framework on the system.
+2. Source OpenStack openrc file.
-The installation of the framework on the system requires the setup of the project.
-After entering into the apexlake directory, it is sufficient to run the following command.
::
- python setup.py install
-
-3. Source OpenStack openrc file.
+ source openrc
-::
+3. Configure Openstack Neutron
- source openrc
+In order to support traffic generation and management by the virtual Traffic Classifier,
+the configuration of the port security driver extension is required for Neutron.
+For further details please follow the following link: PORTSEC_
+This step can be skipped in case the target OpenStack is Juno or Kilo release,
+but it is required to support Liberty.
+It is therefore required to indicate the release version in the configuration file apexlake.conf.
4. Create 2 Networks based on VLANs in Neutron.
The underlying switch needs to be configured accordingly.
::
- VLAN_1=2025
- VLAN_2=2021
+ VLAN_1=2032
+ VLAN_2=2033
+ PHYSNET=physnet2
neutron net-create apexlake_inbound_network \
--provider:network_type vlan \
--provider:segmentation_id $VLAN_1 \
- --provider:physical_network physnet1
+ --provider:physical_network $PHYSNET
neutron subnet-create apexlake_inbound_network \
192.168.0.0/24 --name apexlake_inbound_subnet
neutron net-create apexlake_outbound_network \
- --provider:network_type vlan \
- --provider:physical_network physnet1
-
- neutron net-create apexlake_inbound_network \
--provider:network_type vlan \
--provider:segmentation_id $VLAN_2 \
- --provider:physical_network physnet1
+ --provider:physical_network $PHYSNET
neutron subnet-create apexlake_outbound_network 192.168.1.0/24 \
--name apexlake_outbound_subnet
-5. Configure the Test Cases.
+5. Download Ubuntu Cloud Image and load it on Glance
+
+The virtual Traffic Classifier is supported on top of Ubuntu 14.04 cloud image.
+The image can be downloaded on the local machine and loaded on Glance using the following commands:
+::
+
+ wget cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img
+ glance image-create \
+ --name ubuntu1404 \
+ --is-public true \
+ --disk-format qcow \
+ --container-format bare \
+ --file trusty-server-cloudimg-amd64-disk1.img
+
+6. Configure the Test Cases.
The VLAN tags are also required into the test case Yardstick yaml file as parameters the following test cases:
- TC 006
cd ~
git clone https://github.com/troglobit/smcroute.git
cd smcroute
+ git reset --hard c3f5c56
sed -i 's/aclocal-1.11/aclocal/g' ./autogen.sh
sed -i 's/automake-1.11/automake/g' ./autogen.sh
./autogen.sh
sudo make install
cd ..
+It is required to do the reset to the specified commit ID.
It is also required to create a configuration file using the following command:
SMCROUTE_NIC=(name of the nic)
NIC configuration depends on model and vendor. After proper configuration to support SR-IOV,
a proper configuration of openstack is required.
For further information, please look at the _SRIOV configuration guide
+
+
+Finalize installation the framework on the system
+=================================================
+
+The installation of the framework on the system requires the setup of the project.
+After entering into the apexlake directory, it is sufficient to run the following command.
+::
+
+ python setup.py install
+
+Since some elements are copied into the /tmp directory (see configuration file) it could be necessary
+to repeat this step after a reboot of the host.