Import Upstream version 1.2.2
[quagga-debian.git] / pimd / DEBUG
1 # $QuaggaId: $Format:%an, %ai, %h$ $
2
3 DEBUG HINTS
4
5   - Check the source is issuing multicast packets with TTL high enough
6     to reach the recipients.
7
8   - Check the multicast packets are not being dropped due to
9     fragmentation problems.
10
11   - Three easy options to test IGMPv3 joins from the receiver host:
12
13     1) Configure pimd on the receiver host with "ip igmp join":
14
15        interface eth0
16         ip pim ssm
17         ip igmp join 239.1.1.1 1.1.1.1 
18
19     2) Use test_igmpv3_join command-line utility (provided with qpimd):
20
21        test_igmpv3_join eth0 239.1.1.1 1.1.1.1
22
23     3) User the Stig Venaas' ssmping utility:
24
25        ssmping -I eth0 1.1.1.1
26
27        To see multicast responses with ssmping, you will need run on
28        the host 1.1.1.1 either:
29        a) Stig Venaas' ssmpingd command-line daemon
30           OR
31        b) qpimd built-in ssmpingd service:
32           conf t
33             ip ssmpingd 1.1.1.1
34
35   - Using nepim to generate multicast stream from 1.1.1.1 to 239.1.1.1:
36
37     Notices:
38
39     a) The host unicast address 1.1.1.1 must be reachable from the
40     receiver.
41
42     b) nepim tool requires the receiver must be started *before* the
43     sender.
44
45     First: Start a receiver for that stream by running:
46
47     nepim -q -6 -j 1.1.1.1+239.1.1.1@eth0
48     (Remember of enabling both "ip pim ssm" and "ip igmp" under eth0.)
49
50     Second: Start the sender at host 1.1.1.1.
51
52     The following command generates a 100-kbps multicast stream for
53     channel 1.1.1.1,239.1.1.1 with TTL 10 and 1000-byte payload per UDP
54     packet (to avoid fragmentation):
55
56     nepim -6 -M -b 1.1.1.1 -c 239.1.1.1 -T 10 -W 1000 -r 100k -a 1d
57
58
59
60 SAMPLE DEBUG COMMANDS
61
62   conf t
63    int eth0
64     ip pim ssm
65
66   test pim receive hello eth0 192.168.0.2 600 10 111 1000 3000 0
67   test pim receive join eth0 600 192.168.0.1 192.168.0.2 239.1.1.1 1.1.1.1
68
69   show ip pim join                                                         
70
71
72 INTEROPERABILITY WITH CISCO
73
74   ! Cisco IP Multicast command reference:
75   ! ftp://ftpeng.cisco.com/ipmulticast/Multicast-Commands
76   !
77   ip pim ssm default ! enable SSM mode for groups 232.0.0.0/8
78   ip multicast-routing
79   ip pim state-refresh disable
80   no ip pim dm-fallback
81   !
82   interface FastEthernet0
83    ip pim sparse-mode
84    ip igmp version 3
85
86 -x-