docs/configurationguide/low-latency.feature.configuration.description.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 Introduction
   5 ============
   6
   7 In KVM4NFV project, we focus on the KVM hypervisor to enhance it for NFV, by
   8 looking at the following areas initially
   9
  10 * Minimal Interrupt latency variation for data plane VNFs:
  11    * Minimal Timing Variation for Timing correctness of real-time VNFs
  12    * Minimal packet latency variation for data-plane VNFs
  13 * Inter-VM communication,
  14 * Fast live migration
  15
  16 Configuration of Cyclictest
  17 ===========================
  18
  19 Cyclictest measures Latency of response to a stimulus. Achieving low latency
  20 with the KVM4NFV project requires setting up a special test environment.
  21 This environment includes the BIOS settings, kernel configuration, kernel
  22 parameters and the run-time environment.
  23
  24 * For more information regarding the test environment, please visit
  25   https://wiki.opnfv.org/display/kvm/KVM4NFV+Test++Environment
  26   https://wiki.opnfv.org/display/kvm/Nfv-kvm-tuning
  27
  28 Pre-configuration activities
  29 ----------------------------
  30
  31 Intel POD1 is currently used as OPNFV-KVM4NFV test environment. The latest
  32 build packages are downloaded onto Intel Pod1-jump server from artifact
  33 repository. Yardstick running in a ubuntu docker container on Intel Pod1-jump
  34 server will trigger the cyclictest.
  35
  36 Running cyclictest through Yardstick will Configure the host(Pod1-node1), the
  37 guest, executes  cyclictest on the guest.
  38
  39 The following scripts are used for configuring host and guest to create a
  40 special test environment and achieve low latency.
  41
  42 **host-setup0.sh**: On running this script will install latest kernel rpm
  43 on host and will make necessary changes as following to create special test
  44 environment
  45
  46    * Isolates CPUs from the general scheduler
  47    * Stops timer ticks on isolated CPUs whenever possible
  48    * Stops RCU callbacks on isolated CPUs
  49    * Enables intel iommu driver and disables DMA translation for devices
  50    * Sets HugeTLB pages to 1GB
  51    * Disables machine check
  52    * Disables clocksource verification at runtime
  53
  54 **host-setup1.sh**: On running this script will make following test
  55 environment changes
  56
  57    * Disabling watchdogs to reduce overhead
  58    * Disabling RT throttling
  59    * Reroute interrupts bound to isolated CPUs to CPU 0
  60    * Change the iptable so that we can ssh to the guest remotely
  61
  62 **host-run-qemu.sh**: On running this script will launch a guest vm on host.
  63      Note: download guest disk image from artifactory
  64
  65 **guest-setup0.sh**: On running this scrcipt on guest vm will install the
  66 latest build kernel rpm, cyclictest and makes following configuration on
  67 guest vm.
  68
  69    * Isolates CPUs from the general scheduler
  70    * Stops timer ticks on isolated CPUs whenever possible
  71    * Uses polling idle loop to improve performance
  72    * Disables clocksource verification at runtime
  73
  74 **guest-setup1.sh**: On running this script on guest vm will make following
  75 configurations
  76
  77    * Disable watchdogs to reduce overhead
  78    * Routes device interrupts to non-RT CPU
  79    * Disables RT throttling
  80
  81 Hardware configuration
  82 ----------------------
  83
  84 Currently Intel POD1 is used as test environment for kvmfornfv to execute
  85 cyclictest. As part of this test environment Intel pod1-jump is configured as
  86 jenkins slave and all the latest build artifacts are downloaded on to it.
  87 Intel pod1-node1 is the host on which a guest vm will be launched as a part of
  88 running cylictest through yardstick.
  89
  90 * For more information regarding hardware configuration, please visit
  91   https://wiki.opnfv.org/display/pharos/Intel+Pod1
  92   https://build.opnfv.org/ci/computer/intel-pod1/
  93   http://artifacts.opnfv.org/octopus/brahmaputra/docs/octopus_docs/opnfv-jenkins-slave-connection.html