= Startup =

In the Startup Guide we describe how to use the mcproxy, how to configurate and check the functionality. We describe a scenario and discusses where problems could arise.

== Tables, Flags and useful Tools ==
We offer an overfew of the used Linux-Kernel tables and flags by the mcproxy. Also we make mention of a few useful tools to test and analyse the mcproxy.

=== Tables (IPv4 | IPv6)===
The following tables can be found under the path ''/proc/net/''.The ipv6 tables shows the same contain like the ipv4 tables. But they are only available if you configure and compile your own Linux-Kernel. For more details see [wiki:Kernel here].
* igmp | igmp6
 * This table shows the multiast group subscriptions of your system for every interface. The multicast group addresses are written in hexadecimal and network byte order (only for IPv4). For example an ip address like FEDCBA98 means 152.186.220.254. The mcproxy subscribe a multicast group on the upstream interface for every subscritption heard on the downstream side. This can be seen in the igmp table.
* ip_mr_vif | ip6_mr_vif
 * This table shows interfaces which are registarte to forward multicast traffic. These interfaces are identified by an virtual interface index (vif). All interface used by the mcproxy registrate here.
* ip_mr_cache | ip6_mr_cache
 * This table shows the multicast forwarding rules. All interfaces used in this table associated with a vif. 

=== Flags ===
  MRT-Flag:: If the multicast routing flag is set, then the Linux-Kernel is initialse to forward multicast traffic. Only one programm at the same time can set the MRT-Flag to use the multicast routing tables and to set the flag you need root previligies. To change the flag manual you can overwrite the following file:
{{{
/proc/sys/net/ipv<X>/conf/default/mc_forwarding
}}}

  RP-Filter::  The Reverse Path Filter check the source IP of each packet received on an interface against the routing table. If the best route for the source IP address does not use the same interface that the packet was received on the packet is dropped. If the multicast path is not similar to the ip path, the flag musst be turned off. This is imported for the multicast client and for the mcproxy itself and can be done in the following file:
{{{
/proc/sys/net/ipv4/conf/<interface>/rp_filter
}}}

=== Tools ===
 smcroute:: Smcroute is a command line tool to manipulate the multicast routes of the Linux kernel and it can send join and leave messages to subscribe mutlicast groups. **//Attention!**// Smcroute is a daemon and set the MRT-Flag. So you cannot run smcroute and mcproxy at the same time. You can download it [http://www.cschill.de/smcroute/ here].

 iperf::
{{{
 apt-get install iperf
}}}

 wireshark/tcpdump::