IGMPv2 Router Testing Tool Files

IGMPv2 Router Testing Tool
--------------------------

IGMPv2 Router Testing Tool is a testing tool for testing the IGMPv2 implementation on the router. The purpose of this tool is to check to what extent the IGMPv2 Implementation on the Router is following the standards mentioned in RFC 2236.



Directory Structure
-------------------

There is only one directory 'testtool' in the root directory. This directory contains all the source files for the functioning of IGMPv2 Router Testing Tool. The root directory contains the source files for the GUI part of the IGMP Router Testing Tool.



Setting up Work Environment
---------------------------

Router: The multicast router I had used was a soft router known as 'mrouted'. The following are the details of the linux machine on whihc I had installed mrouted.

Operating System: RedHat Linux 9.0
IP/Subnet       : 172.16.18.5/255.255.255.0
Mrouted Version : Mrouted 3.9 Beta 3
Mrouted rpm used: mrouted-3.9b3-1.i386.rpm (taken from Internet Lab)

To start the multicast router, first install the rpm and then either run "service mrouted start" or "mrouted -d igmp" (if u want to see the IGMP packets in the network).


Testing Tool: The testing tool was installed on a machine on the same subent with the following details.

Operating System: RedHat Linux 9.0
IP/Subnet       : 172.16.18.10/255.255.255.0
C, C++ Compiler : gcc, g++ version 3.2.2
GUI used        : QT Designer version 3.1.1


NOTE:

1) Make sure that before every test case the router is not in Members Present State for the group which is being used in the test case.

2) If u want the testing tool to use some network interface other than eth0, then please go to the function 'struct in_addr IgmpRouterTest::GetTestingNodeIp()' in 'IgmpRouterTest_core.cpp' file in 'testtool' directory, and change 'eth0' to whichever network interface you want.

3) The perl script 'script.pl' takes a single argument, the IP of the Router and dispalys its Group Membership Table. You may modify this script to access and display the Group Membership Table of your multicast router.

4) The router and the testing tool have to be on the same subnet and you have to take extra precautions for ensuring there are no other queriers in the same network. You can probably use a cross cable for the router and the testing tool and set the above two ips ... that would make life a lot easier :-) !



Kinds of Interfaces
-------------------

There are two kinds of interfaces - One is Text Mode, Other is GUI.



Compiling and Running the Testing Tool
--------------------------------------

First checkout the source directory and enter it.

$ svn checkout http://svn.code.sf.net/p/igmptestingtool/code/trunk igmptestingtool-code
$ cd igmptestingtool-code


For compiling the text mode interface, enter the testtool directory and run 'make'.

$ cd testtool
$ make

For running the text mode interface, the format has to be 

$ ./output num1 num2 num3

where num1 indicates the test type (functional, negative or security), num2 indicates the test suite and num3 indicates the test case (having a look at the main.cpp file in 'testtool' directory should clear all doubts).


For compiling the GUI, first enter the testtool directory, run 'make sharedlibrary', come back to the root directory, run qmake, followed by 'make'.

$ cd testtool
$ make sharedlibrary
$ cd ..
$ qmake TestingTool.pro
$ make

For running the GUI, run the executable.

$ ./TestingTool