summaryrefslogtreecommitdiffstats
path: root/docs/usecases
diff options
context:
space:
mode:
authorJohn DeNisco <jdenisco@cisco.com>2020-04-09 14:23:13 -0400
committerJohn DeNisco <jdenisco@cisco.com>2020-04-09 14:23:35 -0400
commit98c2348b5cf9669c9698b9fdd31ae653081e9180 (patch)
treededa50034730c6b0c5f7729a31aa525f58d09676 /docs/usecases
parent81767d71a943fcf1196867549a6b48122f259695 (diff)
docs: Fix the Use Cases Index
Signed-off-by: John DeNisco <jdenisco@cisco.com> Change-Id: If4d5ef8ab93c905493af074fb4c2096f1ab222d4
Diffstat (limited to 'docs/usecases')
-rw-r--r--docs/usecases/container_test.md30
1 files changed, 15 insertions, 15 deletions
diff --git a/docs/usecases/container_test.md b/docs/usecases/container_test.md
index c6b48dc8d07..dc45aabe57b 100644
--- a/docs/usecases/container_test.md
+++ b/docs/usecases/container_test.md
@@ -11,7 +11,7 @@ test a split-tunnel nat + ikev2 + ipsec + ipv6 prefix-delegation
scenario.
OS / Distro test results
-========================
+------------------------
This setup has been tested on an Ubuntu 18.04 LTS system. If you're
feeling adventurous, the same scenario also worked on a recent Ubuntu
@@ -20,7 +20,7 @@ feeling adventurous, the same scenario also worked on a recent Ubuntu
Other distros may work fine, or not at all.
Proxy Server
-============
+------------
If you need to use a proxy server e.g. from a lab system, you'll
probably need to set HTTP_PROXY, HTTPS_PROXY, http_proxy and
@@ -38,7 +38,7 @@ Something like so:
```
Install and configure lxd
-=========================
+-------------------------
Install the lxd snap. The lxd snap is up to date, as opposed to the
results of "sudo apt-get install lxd".
@@ -59,7 +59,7 @@ it with a symbolic link, unless you want to rebuild all of your
containers from scratch. Ask me how I know that.
Create three network segments
-=============================
+-----------------------------
Aka, linux bridges.
@@ -72,7 +72,7 @@ Aka, linux bridges.
We'll explain the test topology in a bit. Stay tuned.
Set up the default container profile
-====================================
+------------------------------------
Execute "lxc profile edit default", and install the following
configuration. Note that the "shared" directory should mount your vpp
@@ -114,7 +114,7 @@ containers, run vpp without installing it, etc.
```
Set up the network configurations
-=================================
+---------------------------------
Edit the fake "internet" backbone:
@@ -183,7 +183,7 @@ configurations:
```
Create a "master" container image
-=================================
+---------------------------------
The master container image should be set up so that you can
build vpp, ssh into the container, edit source code, run gdb, etc.
@@ -210,7 +210,7 @@ vpp configurations.
```
Duplicate the "master" container image
-======================================
+--------------------------------------
To avoid having to configure N containers, be sure that the master
container image is fully set up before you help it have children:
@@ -223,7 +223,7 @@ container image is fully set up before you help it have children:
```
Install handy script
-====================
+--------------------
See below for a handly script which executes lxc commands across the
current set of running containers. I call it "lxc-foreach," feel free
@@ -280,7 +280,7 @@ Here's the script:
```
Test topology
-=============
+-------------
Finally, we're ready to describe a test topology. First, a picture:
@@ -319,7 +319,7 @@ The so-called "internet" bridge models the public internet. The "dora" and
"swan" bridges connect vpp instances to local hosts
End station configs
-===================
+-------------------
The end-station Linux configurations set up the eth2 and eth3 ip
addresses shown above, and add tunnel routes to the opposite
@@ -340,7 +340,7 @@ end-station networks.
```
VPP configs
-===========
+-----------
Split nat44 / ikev2 + ipsec tunneling, with ipv6 prefix delegation in
the "dora" config.
@@ -455,7 +455,7 @@ the "dora" config.
```
IKEv2 certificate setup
-=======================
+-----------------------
In both of the vpp configurations, you'll see "/scratch/setups/xxx.pem"
mentioned. These certificates are used in the ikev2 key exchange.
@@ -472,7 +472,7 @@ Here's how to generate the certificates:
Make sure that the "dora" and "swan" configurations point to the certificates.
DHCPv6 server setup
-===================
+-------------------
If you need an ipv6 dhcp server to test ipv6 prefix delegation,
create the "dhcpserver" container as shown above.
@@ -510,7 +510,7 @@ The "|| true" bit keeps going if eth1 already has the indicated ipv6
address.
Container / Host Interoperation
-===============================
+-------------------------------
Host / container interoperation is highly desirable. If the host and a
set of containers don't run the same distro _and distro version_, it's