Para correr el TP debemos tener instalado docker y docker-compose. Para instalarlo, pueden chequear la documentación aquí:
En Mac, docker-compose se instala junto con docker. En otras plataformas, hay que instalarlos por separado. Pueden encontrar los pasos de instalación aquí:
Una vez que docker esté instalado, tenemos que descargar la imagen que utilizaremos para generar el contendor. Para esto, debemos correr
docker pull iwaseyusuke/mininet
Primero debemos clonar el repositorio del TP
git clone git@github.com:7543distrofiuba/tp3-framework.git
cd tp3-framework
El TP requiere la librería pox para correr. Esta está incluida como un submodulo del repositorio. Para inicializarla deben correr el siguiente comando.
git submodule update --init --recursive
Una vez hecho esto, el ambiente ya esta listo para ser ejecutado.
Los archivos necesarios para correr el TP se montan en el contenedor en el directorio /tmp. En este directorio pueden encontrar la siguiente estructura
/tmp
/tmp/pox -> Aquí se montan los archivos de la libreria pox.
/tmp/pox/ext -> Aquí se montan los archivos de la carpeta controller. Todo lo que agreguen en este directorio podrá ser ejecutado por pox.
/tmp/topology -> Aquí se montan los archivos para inicializar las topologías de mininet.
/tmp/tcpdump -> Aquí se montan la salida de tcpdump para poder capturar tráfico.
Para ejecutar el ambiente, debemos primero levantar el contenedor de Docker, sobre el cual correremos todos los comandos. Para esto, corremos el siguiente comando.
docker-compose up -d
Primero, debemos levantar el controlador pox. En este caso, estamos ejecutando un controlador que corre spanning tree.
docker-compose exec mininet /tmp/pox/pox.py samples.spanning_tree
Para correr sus propios controladores, deben correr
docker-compose exec mininet /tmp/pox/pox.py <nombre del controlador sin .py>
Por ejemplo, para correr el controlador de ejemplo provisto por la cátedra, debemos ejecutar
docker-compose exec mininet /tmp/pox/pox.py example
Para iniciar mininet y levantar la topología tenemos que correr el commando. En este caso, estamos corriendo una topología de ejemplo.
docker-compose exec mininet mn --custom /tmp/topology/example.py --topo example --mac --arp --switch ovsk --controller remote
Para correr sus propias topologías, deben correr
docker-compose exec mininet mn --custom /tmp/topology/<archivo de topologia> --topo <nombre de topologia>[,<parametro>] --mac --arp --switch ovsk --controller remote
Una vez que la topología esta iniciada y la consola de mininet esta disponible para utilizar, podemos probar la conexión corriendo
mininet> h1 ping -c 1 h2
mininet> pingall
Primero, debemos identificar la interfaz a capturar. La interfaz tendra el siguiente formato sw<N>-eth<M> en donde N es el número de switch y M es el puerto de salida.
docker-compose exec mininet ifconfig
Para capturar el tráfico de la interfaz seleccionada, correr el siguiente comando, remplanzando <interfaz>
docker-compose exec mininet tcpdump -C 1000 -v -i <interfaz> -w /tmp/tcpdump/tcpdump.pcap
Por ejemplo, para capturar todas las interfaces, podemos usar
docker-compose exec mininet tcpdump -C 1000 -v -i any -w /tmp/tcpdump/tcpdump.pcap
Para visualizar los paquetes capturados corremos Wireshark, observando la salida de tcpdump
tail -c +1 -f tcpdump/tcpdump.pcap | wireshark -k -i -
Para medir el ancho de banda de una conexión TCP, tenemos que utilizar la herramienta iperf incluida en Mininet. Para medir el ancho de banda entre dos hosts podemos correr el siguiente comando en la consola de mininet
mininet> iperf h1 h2
mininet> iperf <nodo1> <nodo2>
Donde cada nodo puede ser un host o un switch.
En caso de necesitarlo, se puede detener la ejecución del contenedor corriendo
docker-compose down
Otra cosa que también puede ser útil es conectarse al container para correr comandos directamente en ese entorno. Para hacer esto, debemos correr
docker-compose exec mininet bash
Este comando abre una terminal bash, dentro del container para ejecutar lo que necesitamos.