# 2020-04-20 Example CNF: VPP IP Forwarder (from the CNF Testbed) README

Upstream: https://github.com/cncf/cnf-testbed/tree/master/examples/network_functions/vpp-ip-forwarder

Description:
- Layer 3 packet forwarding
- Based on the fd.io VPP project
- Uses DPDK

### How to test

This testing is based on the [CNF Developer Install guide](https://github.com/cncf/cnf-conformance/blob/master/INSTALL.md#cnf-developer-install-and-usage-guide)

**Pre-req:**
- Follow [Pre-req steps](https://github.com/cncf/cnf-conformance/blob/master/INSTALL.md#prerequisites), including
- Set the KUBECONFIG environment to point to the remote K8s cluster
- SKIP the helm install, because VPP IP Forwader is not published
- Deploy the vpp ip forwarder
- Clone the cnf-testbed repo `git clone --depth=1 cnf-tesbed...`
- Go into the example dir...
- Install the CNF `helm install vpp-ip-forwarder`

**Setup and configuration**
- Follow the [download instructions](https://github.com/cncf/cnf-conformance/blob/master/INSTALL.md#setup-and-configuration)
- Initialize the test suite by running `cnf-conformance setup` (creates cnfs folder and other items)
- Copy vpp ip forwader folder to cnfs `cp example-cnfs/vpp-ip-forwarder cnfs`
- Run the tests `crystal src/cnf-conformance.cr all`