9b903967ac4ab7aeb21fbab1707bba47abf8832e
[vpp.git] / vnet / vnet / vcgn / README
1                 =================================
2                 CARRIER GRADE NAT - NAT44 README
3                 =================================
4  
5 What is implemented:
6 ====================
7 * NAT44 UDP, TCP, ICMP protocols
8 * Show and config commands for various parameters for the same
9 * NF9 logging is implemented but is not tested
10  
11 What is not implemented:
12 =========================
13 * TCP MSS
14 * TCP refresh direction
15 * Static port forwarding
16 * Syslog support
17 * Destination based logging or session logging
18 * None of the ALGs
19 * Performance optimization
20 * Binary APIs, suitable for configuring the feature from netconf/restconf/yang
21 * Support for VLANs
22  
23 Setup
24 =====
25                 
26                               +--------------+
27 +------------+      GEb/0/0  |              |
28 | Tester     +-------------->+  vCGN/vPE-f  |
29 |            +<--------------+  VM in UCS   |
30 +------------+      GE13/0/0 |              |
31                               +--------------+
32  
33 Configure Interfaces and add routes in vPE-f 
34 =============================================
35 set int ip address GigabitEthernetb/0/0 10.4.5.2/24 
36 set int state GigabitEthernetb/0/0 up 
37 set int ip address GigabitEthernet13/0/0 20.4.5.2/24 
38 set int state GigabitEthernet13/0/0 up 
39 ip route add 4.4.4.0/24 via GigabitEthernet13/0/0 
40 ip route add 1.2.3.0/24 via GigabitEthernetb/0/0 show ip fib
41  
42 Configure vCGN NAT44 for UDP/TCP/ICMP
43 =======================================
44 set vcgn inside GigabitEthernetb/0/0 outside GigabitEthernet13/0/0 
45 set vcgn port limit 65535 set vcgn dynamic port start 5641 
46 set vcgn map 10.1.1.0 - 10.1.1.31 set vcgn tcp timeout active 65535 init 65535 
47 set vcgn udp timeout active 65535 init 65535 set vcgn icmp timeout 65535
48  
49 Set ARP entries for CGN to Tester
50 ==================================
51 set ip arp GigabitEthernet13/0/0 4.4.4.4 11:22:33:44:55:00 
52 set ip arp GigabitEthernetb/0/0 1.2.3.0 11:22:33:44:55:10 
53 set ip arp GigabitEthernetb/0/0 1.2.3.1 11:22:33:44:55:12 
54 set ip arp GigabitEthernetb/0/0 1.2.3.2 11:22:33:44:55:13 
55 set ip arp GigabitEthernetb/0/0 1.2.3.3 11:22:33:44:55:14 
56 set ip arp GigabitEthernetb/0/0 1.2.3.4 11:22:33:4e:55:11 
57 set ip arp GigabitEthernetb/0/0 1.2.3.5 11:22:33:44:55:15 
58 set ip arp GigabitEthernetb/0/0 1.2.3.6 11:22:33:44:55:16 
59 set ip arp GigabitEthernetb/0/0 1.2.3.7 11:22:33:44:55:17 
60 set ip arp GigabitEthernetb/0/0 1.2.3.8 11:22:33:44:55:18 
61 set ip arp GigabitEthernetb/0/0 1.2.3.9 11:22:33:44:55:19 
62 set ip arp GigabitEthernetb/0/0 1.2.3.10 11:22:33:44:55:1a 
63 set ip arp GigabitEthernetb/0/0 1.2.3.11 11:22:33:44:55:1b 
64 set ip arp GigabitEthernetb/0/0 1.2.3.12 11:22:33:44:55:1c 
65 set ip arp GigabitEthernetb/0/0 1.2.3.13 11:22:33:44:55:1d 
66 set ip arp GigabitEthernetb/0/0 1.2.3.14 11:22:33:44:55:1e 
67 set ip arp GigabitEthernetb/0/0 1.2.3.15 11:22:33:44:55:1f 
68 set ip arp GigabitEthernetb/0/0 1.2.3.16 11:22:33:44:50:01 
69 set ip arp GigabitEthernetb/0/0 1.2.3.17 11:22:33:44:51:01 
70 set ip arp GigabitEthernetb/0/0 1.2.3.18 11:22:33:44:52:01 
71 set ip arp GigabitEthernetb/0/0 1.2.3.19 11:22:33:44:53:01 
72 set ip arp GigabitEthernetb/0/0 1.2.3.20 11:22:33:44:54:02 
73 set ip arp GigabitEthernetb/0/0 1.2.3.21 11:22:33:44:55:01 
74 set ip arp GigabitEthernetb/0/0 1.2.3.22 11:22:33:44:56:02 
75 set ip arp GigabitEthernetb/0/0 1.2.3.23 11:22:33:44:57:00 
76 set ip arp GigabitEthernetb/0/0 1.2.3.24 11:22:33:44:58:02 
77 set ip arp GigabitEthernetb/0/0 1.2.3.25 11:22:33:44:59:03 
78 set ip arp GigabitEthernetb/0/0 1.2.3.26 11:22:33:44:5a:01 
79 set ip arp GigabitEthernetb/0/0 1.2.3.27 11:22:33:44:5b:02 
80 set ip arp GigabitEthernetb/0/0 1.2.3.28 11:22:33:44:5c:03 
81 set ip arp GigabitEthernetb/0/0 1.2.3.29 11:22:33:44:5d:04 
82 set ip arp GigabitEthernetb/0/0 1.2.3.30 11:22:33:44:5e:05 
83 set ip arp GigabitEthernetb/0/0 1.2.3.31 11:22:33:44:5f:06
84  
85  
86 Show commands
87 =============
88 show vcgn config
89 show vcgn statistics
90 show node counters
91 show interface
92  
93 Show commands to show translations
94 ==================================
95 show vcgn inside-translation protocol tcp inside-addr 1.2.3.4 start-port 5641 end-port 5645 
96 show vcgn outside-translation protocol tcp outside-addr 10.1.1.31 start-port 7000 end-port 8000 
97 show vcgn inside-translation protocol icmp inside-addr 1.2.3.4 start-port 7000 end-port 8000 
98 show vcgn outside-translation protocol icmp outside-addr 10.1.1.31 start-port 7000 end-port 8000
99  
100