summaryrefslogtreecommitdiffstats
path: root/docs/design
diff options
context:
space:
mode:
authorkalyanreddy <reddyx.gundarapu@intel.com>2017-03-28 11:34:11 +0530
committerJiang, Yunhong <yunhong.jiang@intel.com>2017-03-28 14:27:51 +0000
commitb04935b08394a9b64b69429215e27f0323065bfa (patch)
treecf0d1e241a2d01a187e408d0cb52b5cf4c3c986e /docs/design
parent9f343782f79512bb6423c973f591dcc90b63ab6b (diff)
Update documentation structure.
This patch is used to update documentation structure. Change-Id: I50d4ef4256ccfc57a0434123e7532a50000582cf Co-Authored by:Srinivas <srinivas.atmakuri@tcs.com> Co-Authored by:RajithaY<rajithax.yerrumsetty@intel.com> Co-Authored by:shravani paladugula <shravanix.paladugula@intel.com> Co-Authored by:Navya Bathula <navyax.bathula@intel.com> Signed-off-by: Gundarapu Kalyan Reddy <reddyx.gundarapu@intel.com> (cherry picked from commit f1f3cc27f23bdde81c37d8142d4288d811bd5e45)
Diffstat (limited to 'docs/design')
-rw-r--r--docs/design/Bare-metalPacketForwarding.pngbin20986 -> 0 bytes
-rw-r--r--docs/design/DeviceInterruptTest.pngbin14326 -> 0 bytes
-rw-r--r--docs/design/PacketforwardingDPDK_OVS.pngbin9111 -> 0 bytes
-rw-r--r--docs/design/TimerTest.pngbin17837 -> 0 bytes
-rwxr-xr-xdocs/design/index.rst14
-rw-r--r--docs/design/kvm1.pngbin55615 -> 0 bytes
-rw-r--r--docs/design/kvmfornfv_design.rst136
7 files changed, 0 insertions, 150 deletions
diff --git a/docs/design/Bare-metalPacketForwarding.png b/docs/design/Bare-metalPacketForwarding.png
deleted file mode 100644
index 4b884e257..000000000
--- a/docs/design/Bare-metalPacketForwarding.png
+++ /dev/null
Binary files differ
diff --git a/docs/design/DeviceInterruptTest.png b/docs/design/DeviceInterruptTest.png
deleted file mode 100644
index 497f63fa3..000000000
--- a/docs/design/DeviceInterruptTest.png
+++ /dev/null
Binary files differ
diff --git a/docs/design/PacketforwardingDPDK_OVS.png b/docs/design/PacketforwardingDPDK_OVS.png
deleted file mode 100644
index c8b689b82..000000000
--- a/docs/design/PacketforwardingDPDK_OVS.png
+++ /dev/null
Binary files differ
diff --git a/docs/design/TimerTest.png b/docs/design/TimerTest.png
deleted file mode 100644
index 52eacc8cf..000000000
--- a/docs/design/TimerTest.png
+++ /dev/null
Binary files differ
diff --git a/docs/design/index.rst b/docs/design/index.rst
deleted file mode 100755
index 63fd75ff6..000000000
--- a/docs/design/index.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-.. _kvmfornfv-design:
-
-================
-KVM4NFV Design
-================
-
-.. toctree::
- :numbered:
- :maxdepth: 3
-
- kvmfornfv_design.rst
diff --git a/docs/design/kvm1.png b/docs/design/kvm1.png
deleted file mode 100644
index 3de1a6b80..000000000
--- a/docs/design/kvm1.png
+++ /dev/null
Binary files differ
diff --git a/docs/design/kvmfornfv_design.rst b/docs/design/kvmfornfv_design.rst
deleted file mode 100644
index 765f41219..000000000
--- a/docs/design/kvmfornfv_design.rst
+++ /dev/null
@@ -1,136 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-==========================
-KVM4NFV design description
-==========================
-
-This design focuses on the enhancement of following area for KVM Hypervisor
-
-* Minimal Interrupt latency variation for data plane VNFs:
- * Minimal Timing Variation for Timing correctness of real-time VNFs
- * Minimal packet latency variation for data-plane VNFs
-* Fast live migration
-
-**Minimal Interrupt latency variation for data plane VNFs**
-
-Processing performance and latency depend on a number of factors, including
-the CPUs (frequency, power management features, etc.), micro-architectural
-resources, the cache hierarchy and sizes, memory (and hierarchy, such as NUMA)
-and speed, inter-connects, I/O and I/O NUMA, devices, etc.
-
-There are two separate types of latencies to minimize:
-
- 1. Minimal Timing Variation for Timing correctness of real-time
- VNFs – timing correctness for scheduling operations(such as Radio scheduling)
- 2. Minimal packet latency variation for data-plane VNFs – packet delay
- variation, which applies to packet processing.
-
-For a VM, interrupt latency (time between arrival of H/W interrupt and
-invocation of the interrupt handler in the VM), for example, can be either of
-the above or both, depending on the type of the device. Interrupt latency with
-a (virtual) timer can cause timing correctness issues with real-time VNFs even
-if they only use polling for packet processing.
-
-We assume that the VNFs are implemented properly to minimize interrupt latency
-variation within the VMs, but we have additional causes of latency variation
-on KVM:
-
- - Asynchronous (e.g. external interrupts) and synchronous(e.g. instructions)
- VM exits and handling in KVM (and kernel routines called), which may have
- loops and spin locks
- - Interrupt handling in the host Linux and KVM, scheduling and virtual
- interrupt delivery to VNFs
- - Potential VM exit (e.g. EOI) in the interrupt service routines in VNFs
- - Exit to the user-level (e.g. QEMU)
-
-.. Figure:: kvm1.png
-
-
-Design Considerations
----------------------
-
-The latency variation and jitters can be minimized with the below
-steps (with some in parallel):
-
- 1. Statically and exclusively assign hardware resources
- (CPUs, memory, caches,) to the VNFs.
-
- 2. Pre-allocate huge pages (e.g. 1 GB/2MB pages) and guest-to-host mapping,
- e.g. EPT (Extended Page Table) page tables, to minimize or mitigate
- latency from misses in caches,
-
- 3. Use the host Linux configured for hard real-time and packet latency,
- Check the set of virtual devices used by the VMs to optimize or
- eliminate virtualization overhead if applicable
-
- 4. Use advanced hardware virtualization features that can reduce or
- eliminate VM exits, if present, and
-
- 5. Inspect the code paths in KVM and associated kernel services to
- eliminate code that can cause latencies (e.g. loops and spin locks).
-
- 6. Measure latencies intensively. We leverage the existing testing methods.
- OSADL, for example, defines industry tests for timing correctness.
-
-
-Goals and Guidelines
---------------------
-
-The output of this project will provide :
-
- 1. A list of the performance goals, which will be obtained by the
- OPNFV members (as described above)
-
- 2. A set of comprehensive instructions for the system configurations
- (hardware features, BIOS setup, kernel parameters, VM configuration,
- options to QEMU/KVM, etc.)
-
- 3. The above features to the upstream of Linux, the real-time patch
- set, KVM, QEMU, libvirt, and
-
- 4. Performance and interrupt latency measurement tools
-
-
-Test plan
----------
-
-The tests that need to be conducted to make sure that all components from OPNFV
-meet the requirement are mentioned below:
-
-**Timer test**:This test utilize the cyclictest
-(https://rt.wiki.kernel.org/index.php/Cyclictest) to test the guest timer
-latency (the latency from the time that the guest timer should be triggered
-to the time the guest timer is really triggered).
-
-.. Figure:: TimerTest.png
-
-**Device Interrupt Test**:A device on the hardware platform trigger interrupt
-every one ms and the device interrupt will be delivered to the VNF. This test
-cover the latency from the interrupt happened on the hardware to the time the
-interrupt handled in the VNF.
-
-.. Figure:: DeviceInterruptTest.png
-
-**Packet forwarding (DPDK OVS)**:A packet is sent from TG (Traffic Generator)
-to a VNF. The VNF, after processing the packet, forwards the packet to another
-NIC and in the end the packet is received by the traffic generator. The test
-check the latency from the packet is sent out by the TC to the time the packet
-is received by the TC.
-
-.. Figure:: PacketforwardingDPDK_OVS.png
-
-**Packet Forwarding (SR-IOV)**:This test is similar to Packet Forwarding
-(DPDK OVS). However, instead of using virtio NIC devices on the guest,
-a PCI NIC or a PCI VF NIC is assigned to the guest for network acess.
-
-**Bare-metal Packet Forwarding**:This is used to compare with the above
-packet forwarding scenario.
-
-.. Figure:: Bare-metalPacketForwarding.png
-
-----------
-Reference
-----------
-
-https://wiki.opnfv.org/display/kvm/