README.md revision bee3dc86
1/*
2 *
3 * Copyright (c) 2016 Cisco and/or its affiliates.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
7 *
8 *     http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16# INTRO:
17
18This is a Vagrant based user demo environment for beginners with VPP
19
20It walks a user through
21- each of the commands,
22- the expected output,
23- gives a file of the commands used to try themselves
24
25# REQUIREMENTS
26- vagrant (1.8)
27- virtualbox / vmware fusion
28
29# GETTING STARTED
30- clone the repo
31- modify env.sh if needed and ```source ./env.sh```
32- by default the VM uses 2 x CPUs and 4G RAM
33- ```vagrant up```
34- ... run the demo
35
36# RUNNING DEMOs
37- From the Host, where you ran ```vagrant up``` run ```./run <demoname>```
38
39```./run <demoname>```
40
41# DEMOs
42
43## routing - directly connected routing
44- Creates two network namespaces c1, c2
45- A gateway interface for each on VPP
46- Routes due to directly connected routes inserted into default FIB
47
48## bridging - directly connected interfaces into a bridge-domain
49- Creates two network namespaces c1, c2
50- Adds interfaces to VPP and add them to bridge-domain 1
51- MAC addresses are automatically learned
52
53## tracing - how to show a "day in the life of a packet" in VPP
54- Same environment as "routing" demo
55- How to add a trace
56- View a trace
57- Interpret a trace
58
59