[common] fixing compiler warnings
[samplevnf.git] / docs / vCGNAPT / RELEASE_NOTES.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International
2 .. License.
3 .. http://creativecommons.org/licenses/by/4.0
4 .. (c) OPNFV, National Center of Scientific Research "Demokritos" and others.
5
6 =========================================================
7 vCGNAPT - Release Notes
8 =========================================================
9
10 Introduction
11 ================
12 This is the beta release for vCGNAPT VNF.
13 vCGNAPT application can be run independently (refer INSTALL.rst).
14
15 User Guide
16 ===============
17 Refer to README.rst for further details on vCGNAPT, HLD, features supported,
18 test plan. For build configurations and execution requisites please refer to
19 INSTALL.rst.
20
21 Feature for this release
22 ===========================
23 This release supports following features as part of vCGNAPT
24
25 - vCGNAPT can run as a standalone application on bare-metal linux server or on a virtual machine using SRIOV and OVS dpdk.
26 - Static NAT
27 - Dynamic NAT
28 - Static NAPT
29 - Dynamic NAPT
30 - ARP (request, response, gratuitous)
31 - ICMP (terminal echo, echo response, passthrough)
32 - ICMPv6 and ND (Neighbor Discovery)
33 - UDP, TCP and ICMP protocol passthrough
34 - Multithread support
35 - Multiple physical port support
36 - Limiting max ports per client
37 - Limiting max clients per public IP address
38 - Live Session tracking to NAT flow
39 - PCP support
40 - NAT64
41 - ALG SIP
42 - ALG FTP
43
44 System requirements - OS and kernel version
45 ==============================================
46 This is supported on Ubuntu 14.04 and 16.04 and kernel version less than 4.5
47
48    VNFs on BareMetal support:
49          OS: Ubuntu 14.04 or 16.04 LTS
50          kernel: < 4.5
51          http://releases.ubuntu.com/16.04/
52          Download/Install the image: ubuntu-16.04.1-server-amd64.iso
53
54    VNFs on Standalone Hypervisor
55          HOST OS: Ubuntu 14.04 or 16.04 LTS
56          http://releases.ubuntu.com/16.04/
57          Download/Install the image: ubuntu-16.04.1-server-amd64.iso
58
59              - OVS (DPDK) - 2.5
60              - kernel: < 4.5
61              - Hypervisor - KVM
62              - VM OS - Ubuntu 16.04/Ubuntu 14.04
63
64 Known Bugs and limitations
65 =============================
66 - Hadware Load Balancer feature is supported on fortville nic FW version 4.53 and below.
67 - L4 UDP Replay is used to capture throughput for dynamic cgnapt
68 - Hardware Checksum offload is not supported for IPv6 traffic.
69 - CGNAPT on sriov is tested till 4 threads
70
71 Future Work
72 ==============
73 - SCTP passthrough support
74 - Multi-homing support
75 - Performance optimization on different platforms
76
77 References
78 =============
79 Following links provides additional information for differenet version of DPDKs
80         .. _QUICKSTART:
81                         http://dpdk.org/doc/guides-16.04/linux_gsg/quick_start.html
82                         http://dpdk.org/doc/guides-16.11/linux_gsg/quick_start.html
83                         http://dpdk.org/doc/guides-17.02/linux_gsg/quick_start.html
84                         http://dpdk.org/doc/guides-17.05/linux_gsg/quick_start.html
85
86         .. _DPDKGUIDE:
87                         http://dpdk.org/doc/guides-16.04/prog_guide/index.html
88                         http://dpdk.org/doc/guides-16.11/prog_guide/index.html
89                         http://dpdk.org/doc/guides-17.02/prog_guide/index.html
90                         http://dpdk.org/doc/guides-17.05/prog_guide/index.html