Skip to content
Snippets Groups Projects
README.md 2.32 KiB
Newer Older
# ETSI TeraFlowSDN Controller Tutorials


## Abstract
This document provides a walkthrough on how to prepare your environment for executing 
and contributing to the [ETSI TeraFlowSDN OSG](https://tfs.etsi.org/).
This walkthrough makes some reasonable assumptions to simplify the deployment of the 
ETSI TeraFlowSDN controller, the execution of experiments and tests, and development of 
new contributions.
In particular, we assume:

- [VirtualBox](https://www.virtualbox.org/) version 6.1.34 r150636
- [VSCode](https://code.visualstudio.com/) with the 
  [*Remote SSH*](https://code.visualstudio.com/docs/remote/ssh) extension
- VM software:
  - [Ubuntu Server 20.04 LTS](https://releases.ubuntu.com/20.04/)
  - [MicroK8s](https://microk8s.io/)


## Contact
If your environment does not fit with the proposed assumptions and you experience issues 
preparing it to work with the ETSI TeraFlowSDN controller, contact the ETSI TeraFlowSDN 
OSG team through
[Slack](https://join.slack.com/t/teraflowsdn/shared_invite/zt-18gc5jvkh-1_DEZHFhxeuOqzJZPq~U~A)


## Table of Content:
- [1. Deployment Guide](./1-0-deployment.md)
  - [1.1. Create VM for the TeraFlowSDN controller](./1-1-create-vm.md)
  - [1.2. Install MicroK8s Kubernetes platform](./1-2-install-microk8s.md)
  - [1.3. Deploy TeraFlowSDN over MicroK8s](./1-3-deploy-tfs.md)
  - [1.4. Access TeraFlowSDN WebUI and Grafana Dashboards](./1-4-access-webui.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [1.5. Show Deployment and Log per Component](./1-5-deploy-logs-troubleshooting.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
- [2. Run Experiments Guide](./2-0-run-experiments.md)
  - [2.1. Configure the Python environment](./2-1-python-environment.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [2.2. OFC'22 Demo - Bootstrap devices, Monitor device Endpoints, Manage L3VPN Services](./2-2-ofc22.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [2.3. OECC/PSC'22 Demo (PENDING)](./2-3-oeccpsc22.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [2.4. ECOC'22 Demo - Disjoint DC-2-DC L2VPN Service](./2-4-ecoc22.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [2.5. NFV-SDN'22 Demo (PENDING)](./2-5-nfvsdn22.md)
- [3. Development Guide (WORK IN PROGRESS)](./3-0-development.md)
  - [3.1. Configure VSCode and Connect to the VM](./3-1-configure-vscode.md)
Lluis Gifre Renom's avatar
Lluis Gifre Renom committed
  - [3.2. Developing a new component: Forecaster (WORK IN PROGRESS)](./3-4-develop-new-component.md)
  - [3.3. Debugging individual components in VSCode](./3-3-debug-comp.md)
  - [3.4. Development Commands, Tricks, and Hints (WORK IN PROGRESS)](./3-2-develop-cth.md)