X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Fmethodology_kvm_vms_vhost_user.rst;h=0a465cf0fb40357a808d3198767558d3a81fa5bc;hb=b255b932218c15f2d63d7ae7bddbbd3acd00229b;hp=34e3bc0447502c1251138201123124d47fb3348f;hpb=124101d22151239b0411a73ae4d2bf8d70970937;p=csit.git

diff --git a/docs/report/introduction/methodology_kvm_vms_vhost_user.rst b/docs/report/introduction/methodology_kvm_vms_vhost_user.rst
index 34e3bc0447..0a465cf0fb 100644
--- a/docs/report/introduction/methodology_kvm_vms_vhost_user.rst
+++ b/docs/report/introduction/methodology_kvm_vms_vhost_user.rst
@@ -1,17 +1,34 @@
 KVM VMs vhost-user
 ------------------
 
+QEMU is used for VPP-VM testing enviroment. By default, standard QEMU version
+preinstalled from OS repositories is used on VIRL/vpp_device functional testing
+(qemu-2.11.x for Ubuntu 18.04, qemu-2.5.0 for Ubuntu 16.04). For perfomance
+testing QEMU is downloaded from `project homepage <qemu.org>`_ and compiled
+during testing. This allows framework to easily inject QEMU patches in case of
+need. In QEMU version <2.8 we used it for increasing QEMU virtion queue size.
+In CSIT setup DUTs have small VM image `/var/lib/vm/vhost-nested.img`. QEMU
+binary can be adjusted in global settings. VM image must have installed at least
+qemu-guest-agent, sshd, bridge-utils, VirtIO support and Testpmd/L3fwd
+application. Username/password for the VM must be cisco/cisco and
+NOPASSWD sudo access. The interface naming is based on driver (management
+interface type is Intel E1000), all E1000 interfaces will be named mgmt<n> and
+all VirtIO interfaces will be named virtio<n>. In VM
+"/etc/init.d/qemu-guest-agent" you must set "TRANSPORT=isa-serial:/dev/ttyS1"
+because ttyS0 is used by serial console and ttyS1 is dedicated for
+qemu-guest-agent in QEMU setup. There is python library for QEMU setup, start
+and some utilities "resources/libraries/python/QemuUtils.py"
+
 FD.io CSIT performance lab is testing VPP vhost with KVM VMs using
 following environment settings:
 
-- Tests with varying Qemu virtio queue (a.k.a. vring) sizes: [vr256]
-  default 256 descriptors, [vr1024] 1024 descriptors to optimize for
-  packet throughput.
+- Tests with varying Qemu virtio queue (a.k.a. vring) sizes: [vr1024] 1024
+  descriptors to optimize for packet throughput.
 - Tests with varying Linux :abbr:`CFS (Completely Fair Scheduler)`
   settings: [cfs] default settings, [cfsrr1] CFS RoundRobin(1) policy
   applied to all data plane threads handling test packet path including
   all VPP worker threads and all Qemu testpmd poll-mode threads.
-- Resulting test cases are all combinations with [vr256,vr1024] and
+- Resulting test cases are all combinations with [vr1024] and
   [cfs,cfsrr1] settings.
 - Adjusted Linux kernel :abbr:`CFS (Completely Fair Scheduler)`
   scheduler policy for data plane threads used in CSIT is documented in