Annotation of embedaddon/pimd/README-config.md, revision 1.1
1.1 ! misho 1: > $Id: README.config,v 1.4 2002/06/13 17:39:19 pavlin Exp $
! 2:
! 3: This is file contains help for configuring and using pimd, the
! 4: PIM-SM/SSM multicast daemon. For the latest pimd version, see
! 5: <https://github.com/troglobit/pimd>
! 6:
! 7: There is an older Japanese version of this file, it could need
! 8: some updating help, in the meantime, see [README.config.jp][jp]
! 9:
! 10: **NOTE:** currently, this file is very incomplete. If something is
! 11: missing and/or unclear, email the current maintainer of pimd
! 12: or file an issue in the GitHub issue tracker.
! 13:
! 14: ## Using GRE Tunnels for Multicast Routing
! 15:
! 16: Based on information contributed by Hiroyuki Komatsu
! 17: <mailto:komatsu@taiyaki.org>
! 18:
! 19: If you are configuring the particular gre interfaces for the first time,
! 20: ignore the errors after `ip link set gre1 down` and `ip tunnel del gre1`
! 21:
! 22: On Linux (Debian) try the following:
! 23:
! 24: ### GRE Tunnel Between Two Machines
! 25:
! 26: This sets up a GRE tunnel between hosts 11.11.11.11 and 33.33.33.33.
! 27:
! 28: Physical interfaces: [11.11.11.11] [33.33.33.33]
! 29: GRE tunnel: 22.22.22.11 <-------> 22.22.22.33
! 30:
! 31: ==== host 11.11.11.11 (GRE interface 22.22.22.11)
! 32: echo 1 > /proc/sys/net/ipv4/ip_forward
! 33: echo 0 > /proc/sys/net/ipv4/conf/all/rp_filter
! 34: ip link set gre1 down
! 35: ip tunnel del gre1
! 36: ip tunnel add gre1 mode gre remote 33.33.33.33 local 11.11.11.11 ttl 127
! 37: ip addr add 22.22.22.11/24 peer 22.22.22.33/24 dev gre1
! 38: ip link set gre1 up multicast on
! 39:
! 40: ==== host 33.33.33.33 (GRE interface 22.22.22.33)
! 41: echo 1 > /proc/sys/net/ipv4/ip_forward
! 42: echo 0 > /proc/sys/net/ipv4/conf/all/rp_filter
! 43: ip link set gre1 down
! 44: ip tunnel del gre1
! 45: ip tunnel add gre1 mode gre remote 11.11.11.11 local 33.33.33.33 ttl 127
! 46: ip addr add 22.22.22.33/24 peer 22.22.22.11/24 dev gre1
! 47: ip link set gre1 up multicast on
! 48:
! 49:
! 50: ### GRE Tunnels with Three Machines
! 51:
! 52: > STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!STOP!!!
! 53: >
! 54: > IF YOU ADD MORE THAN TWO GRE TUNNELS IN A CHAIN, IT IS VERY EASY TO CREATE
! 55: > UNICAST ROUTING LOOPS, AND THIS MAY LEAD TO MULTICAST ROUTING LOOPS.
! 56: > MULTICAST ROUTING LOOP IS A DISASTER THAT MAY BRING YOUR WHOLE NETWORK DOWN.
! 57: > BEFORE ATTEMPTING THIS CONFIGURATION, MAKE SURE YOU UNDERSTAND VERY WELL
! 58: > WHAT YOU ARE DOING, AND WHAT MAY HAPPEN.
! 59: > IF YOU ARE READING THIS, THE CHANCES ARE THAT YOU DON'T KNOW, SO THINK AGAIN!!
! 60: >
! 61: > THINK!!!THINK!!!THINK!!!THINK!!!THINK!!!THINK!!!THINK!!!THINK!!!THINK!!!
! 62:
! 63: Physical interfaces: [11.11.11.11] [33.33.33.33] [55.55.55.55]
! 64: GRE tunnels: 22.22.22.11 <--> 22.22.22.33
! 65: 44.44.44.33 <--> 44.44.44.55
! 66:
! 67: ==== host 33.33.33.33 (GRE interfaces 22.22.22.33 and 44.44.44.33)
! 68: echo 1 > /proc/sys/net/ipv4/ip_forward
! 69: echo 0 > /proc/sys/net/ipv4/conf/all/rp_filter
! 70: ip tunnel add gre1 mode gre remote 11.11.11.11 local 33.33.33.33 ttl 127
! 71: ip addr add 22.22.22.33/24 peer 22.22.22.11/24 dev gre1
! 72: ip link set gre1 up multicast on
! 73: ip tunnel add gre2 mode gre remote 55.55.55.55 local 33.33.33.33 ttl 127
! 74: ip addr add 44.44.44.33/24 peer 44.44.44.55/24 dev gre2
! 75: ip link set gre2 up multicast on
! 76:
! 77: ==== host 55.55.55.55 (GRE interface 44.44.44.55)
! 78: echo 1 > /proc/sys/net/ipv4/ip_forward
! 79: echo 0 > /proc/sys/net/ipv4/conf/all/rp_filter
! 80: ip tunnel add gre1 mode gre remote 33.33.33.33 local 55.55.55.55 ttl 127
! 81: ip addr add 44.44.44.55/24 peer 44.44.44.33/24 dev gre1
! 82: ip link set gre1 up multicast on
! 83: route add -net 22.22.22.0 netmask 255.255.255.0 gw 44.44.44.33 gre1
! 84:
! 85: ==== host 11.11.11.11 (GRE interface 22.22.22.11)
! 86: echo 1 > /proc/sys/net/ipv4/ip_forward
! 87: echo 0 > /proc/sys/net/ipv4/conf/all/rp_filter
! 88: ip tunnel add gre1 mode gre remote 33.33.33.33 local 11.11.11.11 ttl 127
! 89: ip addr add 22.22.22.11/24 peer 22.22.22.33/24 dev gre1
! 90: ip link set gre1 up multicast on
! 91: route add -net 44.44.44.0 netmask 255.255.255.0 gw 22.22.22.33 gre1
! 92:
! 93:
! 94: ## The pimd.conf FAQ
! 95:
! 96: For a complete list of all available options, see `pimd.conf` and the man page.
! 97:
! 98: 1. How to disable pimd being Cand-RP?
! 99:
! 100: Comment-out the `rp-candidate` and `group-prefix` lines in `pimd.conf`
! 101:
! 102: 2. How to disable pimd being Cand-BSR?
! 103:
! 104: Comment-out the `bsr-candidate` line in `pimd.conf`
! 105:
! 106: 3. How to prevent a prefix of multicast addresses being routed through
! 107: my multicast router?
! 108:
! 109: If you want to scope, say, prefixes 238.0.0.0/8 and 239.0.0.0/8, add
! 110: the following lines to `pimd.conf`:
! 111:
! 112: phyint eth1 scoped 238.0.0.0 masklen 8
! 113: phyint eth1 scoped 239.0.0.0 masklen 8
! 114:
! 115: 4. How to create a scope zone and stop multicast packets for some multicast
! 116: prefix being propagated beyond the boundary of my network?
! 117:
! 118: Add scoping filters on your border routers for each prefix you want
! 119: to scope. E.g.:
! 120:
! 121: phyint eth1 scoped 239.0.0.0 masklen 8
! 122:
! 123: [jp]: https://github.com/troglobit/pimd/blob/master/README.config.jp
! 124:
! 125: <!--
! 126: -- Local Variables:
! 127: -- mode: markdown
! 128: -- End:
! 129: -->
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to README-config.md CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pimd