This work is a result of project ECTICS (PID2019-105257RB-C21), funded by:
Mupi-proxy (Multiple UPstream Interfaces multicast Proxy) is a proof of concept implementation of the extensions defined in IETF draft-asaeda-pim-multiif-igmpmldproxy-04 to support multiple upstream interfaces in IGMP/MLD proxies. It has been implemented for Linux using an SDN application running over Ryu controller that controls and Open vSwitch in charge of relaying the multicast data flows and IGMP/MLD traffic.
The generic working scenario of mupi-proxy is presented in the figure, where several IP multicast flow providers are connected to upstream interfaces and several clients that consume the multicast flows are connected to downstream interfaces.
In this scenario, mupi-proxy is in charge of relaying the control and data multicast flows among clients and providers. Basically it:
- Relays the IGMP/MLD control requests sent by the clients to the providers following the selection policies configured. For that purpose, mupi-proxy includes a Multicast Upstream Routing Table (MURT) that allows to specify how the upstream interface is selected in terms of the client's IP address, the multicast group and the IP address of the multicast flow source.
- Relays the multicast data traffic sent by the providers to the clients.
Mupi-proxy works as a standard Ethernet switch for unicast traffic.
The main task to carry out when configuring mupi-proxy is the definition of the MURT. Each entry of the MURT is a 5-tuple with the following format:
(client_ip, mcast_group, mcast_src_ip, upstream_if, priority)
being:
- client_ip: an IP address or prefix used to define the range of client IP addresses the entry applies to.
- mcast_group: an IP multicast group or a prefix of multicast groups the entry applies to.
- mcast_src_ip: an IP address or prefix used to define the range of mcast source IP addresses the entry applies to.
- upstream_if: the number of the upstream interface to be used.
- priority: the priority of the table entry.
The first three fields (client_ip, mcast_group and mcast_src_ip) can be empty. An empty value in these fields is equivalent to 0.0.0.0/0.
When a request to join an IP multicast group is received from a client, the mupi-proxy extracts the client source IP address, the IP multicast group and, if specified, the multicast source IP address. With these three values, it iterates over the MURT entries to find the ones that match the request values, selecting the one with the highest priority and relaying the IGMP/MLD request to the upstream interface specified in the selected entry.
In case two or more entries with the same priority are selected, the request is sent to all the upstream interfaces specified in the MURT entries.
For example, if the MURT is configured with the following values:
| client_ip | mcast_group | mcast_src_ip | upstream_if | priority | |
|---|---|---|---|---|---|
| 1 | 10.100.0.0/26 | 224.0.122.5 | 10.100.0.21 | 7 | 30 |
| 2 | 224.0.122.5 | 8 | 20 | ||
| 3 | 0.0.0.0/0 | 224.0.0.0/4 | 0.0.0.0/0 | 9 | 0 |
the following queries would be directed to the upstream interfaces specified below:
- Q1: (10.100.0.20, 224.0.122.5, 10.100.0.21) -> 7 # matching entries: 1,2,3
- Q2: (10.100.0.70, 224.0.122.5, 10.100.0.21) -> 8 # matching entries: 2,3
- Q3: (10.100.0.70, 224.0.122.6, 10.100.0.21) -> 9 # matching entries: 3
A Virtual Networks over LinuX (VNX) virtual testbed scenario is distributed to easily test mupi-proxy. The test scenario is made of:
- A Linux container (LXC) named controller which runs the Ryu controller and the mupi-proxy application.
- An Open vSwitch (OVS) which is in charge of forwarding the traffic and it is OpenFlow-controlled from the SDN controller.
- Three containers (provider1-3) which act as IP multicast flow providers.
- Six containers (client1-6) which act as clients that request IP multicast flows to the different providers.
Note: All containers use the standard VNX account credentials: vnx/xxxx and root/xxxx.
To start using the mupi-proxy test scenario:
- Download and install the latest version of the VNXSDNLAB virtual machine from:
https://idefix.dit.upm.es/download/vnx/vnx-vm/VNXSDNLAB2020-v1.ova
Alternatively, the scenario can be started on any Linux computer with VNX installed (see http://vnx.dit.upm.es/ for installation details).
- Start the VNXSDNLAB virtual machine, open a terminal and update VNX to the latest version and clone mupy-proxy github repository:
sudo vnx_update
git clone https://github.com/giros-dit/mupi-proxy.git
- Download the test scenario containers image:
cd mupi-proxy/test/filesystems
vnx_download_rootfs -r vnx_rootfs_lxc_ubuntu64-18.04-v025-vnxlab2.tgz
cd ..
- Start the test scenario with:
sudo vnx -f mupi-proxy-test1.xml -v --create
Note: you can destroy the scenario with '--destroy' option:
sudo vnx -f mupi-proxy-test1.xml -v --destroy
- Start mupi-proxy in controller container with:
ssh root@controller
ryu-manager ryu/flowmanager/flowmanager.py mupi-proxy/mupi-proxy.py --config-file mupi-proxy/conf/<config-file>
being <config-file> the name of the mupi-proxy configuration file (see examples under mupi-proxy/conf/ directory).
- Once the scenario is started, you can connect to:
- the providers (through ssh or directly through the console) to program them to start sending IP multicast flows. For example, the following command starts to send one ip multicast packet each three seconds to 224.100.10.10:1234 through interface eth1:
ssh root@provider1
mcsender -t3 -ieth1 224.100.10.10:1234
- the clients to join to the multicast groups sent by the providers. For example, the following command request to join to multicast group 224.100.10.10 and loops till it receives 10 packets sent to 224.100.10.10:1234 through interface eth1:
ssh root@client1
mcfirst -4 -I eth1 224.100.10.10 1234 -c 10
- To inspect the status of the flow tables of the switch, you can use FlowManager application. Just start a web navigator and connect to:
http://controller:8080/home/index.html
draft-asaeda-pim-multiif-igmpmldproxy-04 describes in section 6.2 four posible modes of selecting the appropiate upstream interface. Examples of these modes are provided in mupi-proxy distribution.
For testing the examples, all providers (1-3) are configured to transmit all of them to these four multicast groups: 224.10.10.0, 224.10.10.1, 224.10.10.2 and 224.10.10.3. These four groups can be aggregated in prefix 224.10.10.0/30. To start the transmission from the providers you can use this command:
sudo vnx -f mupi-proxy-test1.xml -v -x start-test1
And to stop it:
sudo vnx -f mupi-proxy-test1.xml -v -x stop-test
Each client is assigned to a specific provider. Clients 1/2 are assigned to provider1, 3/4 to provider2 and 5/6 to provider3. The routing tables configured are:
[murt]
# Multicast upstream routing table config
#
# Format: Client IP Multicast Multicast Upstream Priority
# Addr/Prefix group source IP If Id
# Addr/prefix Addr/Prefix
murt_entry = 10.100.0.11, , , 7, 10
murt_entry = 10.100.0.12, , , 7, 10
murt_entry = 10.100.0.13, , , 8, 10
murt_entry = 10.100.0.14, , , 8, 10
murt_entry = 10.100.0.15, , , 9, 10
murt_entry = 10.100.0.16, , , 9, 10
For this mode, start ryu manager using this command:
start-mupi-proxy mupi-proxy/conf/mode1-client.conf
And you can test how the mode works with commands like:
ssh client1 mcfirst -4 -I eth1 224.10.10.1 1234 -c 10 # Receives from 10.100.0.31
ssh client3 mcfirst -4 -I eth1 224.10.10.1 1234 -c 10 # Receives from 10.100.0.32
ssh client5 mcfirst -4 -I eth1 224.10.10.1 1234 -c 10 # Receives from 10.100.0.33
In this mode, client request are routed to providers depending on the source and multicast group requested (S,G). The routing tables configured are:
[murt]
# Multicast upstream routing table config
#
# Format: Client IP Multicast Multicast Upstream Priority
# Addr/Prefix group source IP If Id
# Addr/prefix Addr/Prefix
murt_entry = , 224.10.10.0/31, 10.100.0.31, 7, 10
murt_entry = , 224.10.10.2/31, 10.100.0.32, 8, 10
murt_entry = , 224.10.10.0/30, 10.100.0.33, 9, 10
For this mode, start ryu manager using this command:
start-mupi-proxy mupi-proxy/conf/mode2-asm.conf
And you can test how the mode works with commands like:
ssh client1 mcfirst -4 -I eth1 10.100.0.31 224.10.10.0 1234 -c 10 # Receives from 10.100.0.31
ssh client2 mcfirst -4 -I eth1 10.100.0.33 224.10.10.0 1234 -c 10 # Receives from 10.100.0.33
ssh client3 mcfirst -4 -I eth1 10.100.0.32 224.10.10.0 1234 -c 10 # No data received
If the source is not specified in a client request, it receives simultaneously from all matching entries. For example:
ssh client1 mcfirst -4 -I eth1 224.10.10.0 1234 -c 10 # Receives from 10.100.0.31 and .33
In this mode, client requests are routed to providers depending on the multicast group requested (*,G): group .11 is assigned to provider 1, .21 to provider2 and .31 to provider3. The routing tables configured are:
[murt]
# Multicast upstream routing table config
#
# Format: Client IP Multicast Multicast Upstream Priority
# Addr/Prefix group source IP If Id
# Addr/prefix Addr/Prefix
murt_entry = , 224.10.10.0, , 7, 10
murt_entry = , 224.10.10.1, , 8, 10
murt_entry = , 224.10.10.2, , 9, 10
murt_entry = , , , 7, 0
For this mode, start ryu manager using this command:
start-mupi-proxy mupi-proxy/conf/mode3-asm.conf
And you can test how the mode works with commands like:
ssh client1 mcfirst -4 -I eth1 224.10.10.0 1234 -c 10 # Receives from 10.100.0.31
ssh client1 mcfirst -4 -I eth1 224.10.10.1 1234 -c 10 # Receives from 10.100.0.32
ssh client1 mcfirst -4 -I eth1 224.10.10.3 1234 -c 10 # Receives from 10.100.0.31
In this mode, client requests are routed to providers depending on the source IP of the multicast flow (S,*). The routing tables configured are:
[murt]
# Multicast upstream routing table config
#
# Format: Client IP Multicast Multicast Upstream Priority
# Addr/Prefix group source IP If Id
# Addr/prefix Addr/Prefix
murt_entry = , , 10.100.0.31, 7, 10
murt_entry = , , 10.100.0.32, 8, 10
murt_entry = , , 10.100.0.33, 9, 10
For this mode, start ryu manager using this command:
start-mupi-proxy mupi-proxy/conf/mode4-source.conf
And you can test how the mode works with commands like:
ssh client1 mcfirst -4 -I eth1 10.100.0.31 224.10.10.0 1234 -c 10 # Receives from 10.100.0.31
ssh client2 mcfirst -4 -I eth1 10.100.0.32 224.10.10.2 1234 -c 10 # Receives from 10.100.0.32
ssh client3 mcfirst -4 -I eth1 10.100.0.33 224.10.10.3 1234 -c 10 # Receives from 10.100.0.33