(usagi-users 02844) Re: PIM-SM for IPV6

[Pavlin Radoslavov <pavlin@xxxxxxxx>]

> I heard today that Xorp 1.0 will soon be out with an improved PIM-SM
> implementation, for Linux and BSD.   Probably in March, so check www.xorp.org
> next month.

FYI, you can download and play now with the stand-alone PIM-SM
module in XORP. Below you can find the email with the instructions
I sent yesterday to the m6bone mailing list.

Obviously, right now you cannot run it in IPv6 mode on Linux without
IPv6 multicast routing support in the kernel.

Regards,
Pavlin

======================================================================
To: m6bone@xxxxxxxxxxxxx
Date: Thu, 04 Mar 2004 16:56:49 -0800
From: Pavlin Radoslavov <pavlin@xxxxxxxx>
Subject: [m6bone] Unofficial announcement of the XORP PIM-SM implementation

All,

I'd like to make an unofficial announcement of the PIM-SM
implementation that is part of the XORP project
(http://www.xorp.org/).

The implementation is dual IPv4 and IPv6 and implements the
following features:

* Lastest PIM-SM spec (draft-ietf-pim-sm-v2-new-09)
* The Bootstrap mechanism (draft-ietf-pim-sm-bsr-03), including scoping
* Static RPs
* IGMPv1 and v2
* MLDv1
* Tested to work on FreeBSD and Linux:
  - In case of Linux only IPv4 works because the kernel itself
    doesn't support IPv6 multicast routing.
  - In case of FreeBSD if you want to run IPv4 you must have
    a kernel with PIM support (e.g., FreeBSD-4.9 or FreeBSD-5.2 or
    newer). Older FreeBSD versions should still work for IPv6.


Things that are not implemented yet, but are on our TODO list:

* Static routes in MRIB
* IGMPv3 and MLDv2
* Bi-directional PIM


Things that are currently in process of testing:

* Multicast scopes


Currently, the PIM-SM + MLD/IGMP modules can be run only in
stand-alone mode (i.e., they haven't been integrated yet with the
XORP router manager for those of you who are familiar with the XORP
architecture).

Below are the instructions how to start using PIM-SM:

================================================================
1. Get the lastest source code from the anonymous CVS repository.
   See http://www.xorp.org/cvs.html for details.

2. Run the following commands to compile it:
   cd xorp
   ./configure
    gmake

  Give it about 1 hour and 1GB of disk space for everything to
  compile :)
  Not everything needs to be compiled for PIM, but selective
  compilation can be a source of confusion.

3. Read pim/README for information about how to configure and run
   PIM-SM in stand-alone mode.

   Basically, you need to edit the "pim/configure_pim" shell script
   and add an entry for your router with the interface names to
   enable, etc.

4. Run as a root:
   cd pim
   ./test_pim

5. Run (in another terminal window) the modified configuration
   (shell) script:
   ./configure_pim -6

   The "-6" option is to run PIM-SM in IPv6 mode. Use option "-4" or
   just no option to run it in IPv4 mode. You can run the
   configuration script twice (with option -4 and -6 respectively)
   to enable both IPv4 and IPv6.

6. After "./configure_pim" exits, then PIM-SM should be up and
   running.

   Note that by default "./test_pim" runs in debug mode in
   foreground so expect to see log messages once it is running. To
   run it in background, you just do it explicitly. E.g., in tcsh:
   ./test_pim >& /dev/null &

7. You can use the built-in CLI (currently it is read-only) to view
   some of the internal state:

telnet localhost 12000

   All the PIM-SM IPv6 commands start with "show pim6":

show pim6 bootstrap
show pim6 bootstrap rps
show pim6 interface
show pim6 interface address
show pim6 join
show pim6 mfc
show pim6 neighbors
show pim6 mrib
show pim6 rps
show pim6 scope

   Press <TAB> or '?' after a command for a brief help.

   All the MLD commands start with "show mld".

================================================================

Note that the current solution of running the stand-alone PIM-SM
and configuring it via a shell script is a temporary solution
until PIM-SM is integrated with the XORP rtrmgr (a goal for
the forthcoming XORP-1.0 release). After the integration, there will
be a real configuration file and the router can be reconfigured
through the CLI as well.


I believe the PIM-SM module is reasonably stable hence I thought
it may be of interest for the IPv6 multicast community and for early
adopters who want to play with it and don't want to wait for the
official release.

Please let me know if you run into problems, if you have any
feedbacks, comments, etc.

Thanks,
Pavlin

======================================================================