S3P_scripts

S3P is a sub-project of OpenDaylight for testing Stability, Scalability, Security, and Performance.

These scripts are intended to simplify the process of managing large sets of virtual machines to enable scale testing for OpenDaylight S3P.

Dependencies:

S3P-scripts requires the following utilities which may be installed with setup_S3P-scripts.sh. Development work was done on Fedora 23 Server. the netinst (minimal) server image was obtained from: https://mirror.chpc.utah.edu/pub/fedora/linux/releases/23/Server/x86_64/iso/Fedora-Server-netinst-x86_64-23.iso

Hardware

If using the passthrough-vf network, the host system must have a network interface capable of SR-IOV such as the Intel 82599ES or X540-AT2. The host system must also support IOMMU and VT-d in this case.

Virtual Machines and Containers

libvirtd, virsh, virt-install, virt-customize, kvm, qemu rsync brutils (brctl), iproute2 (ip utils),

Containers only

lxc.x86_64

installation

Steps required to bring up virtual machines:

0. Create VM image file with S3P-scripts/domain_defs/create_vm_image.sh or manually
1. A Kickstart configuration for a suitable installation is in S3P-scripts/domain_defs/vm_install.ks.cfg
2. Ensure IOMMU and VT-d are enabled on the physical host systems (for virtual functions)
3. enable VT-x in the BIOS :: Advanced | Processor Configuration | Intel (R) Virtualization
4. enable VT-d in the BIOS :: Advanced | Integrated IO Configuration | Intel (R) VT for Directed I/O
5. add intel_iommu=on to the kernel command line
6. prepare the networks for the VMs
7. verify network interfaces, bridges, and subnets in S3P-scripts/network/network-details.sh
8. run S3P-scripts/network/setup_net.sh to create bridges and assign interfaces
9. enable virtual functions for the PF of the passthrough network
   • S3P-scripts/network/enable_vf_driver.sh is a useful tool for enabling VFs
10. run S3P-scripts/network/setup_virsh_passthrough_net.sh to create a passthrough network
11. define virtual machines with virsh and libvirt domxml definitions in S3P-scripts/domain_defs/
12. a single VM image (e.g. vh-seed.img) may be cloned and given a new name with
    • S3P-scripts/domain_defs/clone_domain.sh newDomName
13. TODO: need better explanation of "virsh define" for a set of XML
14. Launch Virtual machines with TODO

##TODO: networking::VM::VF-adapter doesn't DHCP -> customize /etc/sysconfig/network-scripts? assign IP based on vh#?