quagga-0.99.20mr2.1 - Release Notes for the Mobile Routing variant of Quagga

https://downloads.pf.itd.nrl.navy.mil/ospf-manet/archive/quagga-0.99.20mr2.1/RELEASE_NOTES.MobileRouting

	Release Notes for the Mobile Routing variant of Quagga

The Mobile Routing variant of Quagga (http://www.quagga.net/) is a
research implementation of OSPF MANET Designated Routers (MDRs) that
implements the following RFCs:

  - RFC 5614 Mobile Ad Hoc Network (MANET) Extension of OSPF Using
	     Connected Dominating Set (CDS) Flooding

  - RFC 5243 OSPF Database Exchange Summary List Optimization

  - RFC 5838 Support of Address Families in OSPFv3

The implementation goes a bit beyond what is specified in the above
RFCs based on experience with emulations and WiFi-based field
experiments.

Authors
=======

The primary authors of OSPF-MDR are Richard Ogier and Phillip
Spagnolo.  Tom Goff has been the lead maintainer since 2009.

This software is supported and maintained as open source software by
Boeing Research & Technology, Naval Research Laboratory, and other
open source contributors.

License
=======

GNU GPLv2

Availability
============

See the downloads section of
http://cs.itd.nrl.navy.mil/work/ospf-manet/ for releases and snapshots
generated when updates occur.

Check back there for updates, to report bugs, or for discussions with
developers.

Documentation
=============

Documentation is integrated with the Quagga Texinfo documentation; see
the doc directory files ospf6d-af.texi and ospf6d-manet.texi.

Version Notes
=============

quagga-mr 0.99.20mr2.1 release (Jan 2012)
-----------------------------------------

This is a maintenance release mostly tracking upstream Quagga updates.
A summary of the high-level changes since the 0.99.17mr2.0 release of
quagga-mr are outlined below.

all code:

  - Sync with quagga_0_99_20_release from
    git://code.quagga.net/quagga.git.

ospf6d:

 * Changes that impact backward compatibility and interoperability:

  - Enable OSPFv3 Address Families interoperability by default.

  - Use the values from RFC 5614 for MDR TLVs; non-standard backwards
    compatibility with previous releases can be configured.

  - OSPFv3 Instance ID is no longer configurable per interface and is
    now a global attribute.

  - The default values for HelloInterval, RouterDeadInterval, and
    RxmtInterval for MDR interfaces were changed to be consistent with
    Section 3.2 of RFC 5614.

 * Other changes:

  - Reorganization of some MDR code.

  - Support the OSPFv3 LinkLSASuppression interface option and enable
    link-LSA suppression by default on MDR interfaces.

  - Allow configuring the IPv6 transport class used for OSPFv3
    protocol packets.

  - Avoid some unnecessary delete-then-add route updates.

  - Fix how prefixes are compared for route redistribution.

  - Improve LSA debugging commands.

  - Improve logging for SDT/CMAP visualization.

  - Add a vty command to check for asymmetric link advertisements in
    router-LSAs.

New OSPFv3 view commands:

  - "show ipv6 ospf6 database asymmetric-links"

New OSPFv3 configuration commands:

  - "instance-id <0-255>"
  - "protocol-traffic-class <0-255>"
  - "mdr-tlv-interoperability"
  - "no mdr-tlv-interoperability"

New OSPFv3 interface configuration commands:

  - "ipv6 ospf6 link-lsa-suppression"
  - "no ipv6 ospf6 link-lsa-suppression"


quagga-mr 0.99.17mr2.0 release (May 2011)
-----------------------------------------

This is a maintenance release focused on incremental improvements
rather than significant new features.  High-level changes since
quagga-mr 0.99.16mr1.0 are summarized below.

New zebra configuration commands:

  - "rib sort-nexthops descending"
  - "rib sort-nexthops ascending"
  - "no rib sort-nexthops"

  - "netlink linkmetrics-multicast-group <1-64>"
  - "no netlink linkmetrics-multicast-group"

New OSPFv3 configuration commands:

  - "af-interoperability"
  - "no af-interoperability"

  - "area A.B.C.D spf-delay-msec <0-10000>"
  - "area A.B.C.D spf-holdtime-msec <0-10000>"

New OSPFv3 interface configuration commands:

  - "ipv6 ospf6 neighbor-metric-hysteresis <1-65535>"
  - "no ipv6 ospf6 neighbor-metric"

  - "ipv6 ospf6 linkmetric-formula (cisco|nrl-cable)"
  - "no ipv6 ospf6 linkmetric-formula"
  - "ipv6 ospf6 linkmetric-weight-throughput <0-100>"
  - "ipv6 ospf6 linkmetric-weight-resources <0-100>"
  - "ipv6 ospf6 linkmetric-weight-latency <0-100>"
  - "ipv6 ospf6 linkmetric-weight-l2_factor <0-100>"

  - "ipv6 ospf6 linkmetric-update-filter (adjust-values)"
  - "no ipv6 ospf6 linkmetric-update-filter"

  - "ipv6 ospf6 periodic-metric-function neighbor-time [<0-65535>]
    recalculate-interval <1-65535>"
  - "no ipv6 ospf6 periodic-metric-function"

  - "ipv6 ospf6 neighbor-cost A.B.C.D <1-65535>"
  - "no ipv6 ospf6 neighbor-cost [A.B.C.D]"

  - "ipv6 ospf6 min-smf-relay-mdr-level (MDR|BMDR)"
  - "ipv6 ospf6 min-smf-relay-neighbor-count <1-2>"
  - "ipv6 ospf6 smf-relay-isolated"
  - "no ipv6 ospf6 smf-relay-isolated"

New OSPFv3 informational commands:

  - "show ipv6 ospf6 neighbor-linkmetrics [A.B.C.D]"
  - "show ipv6 ospf6 neighbor mdrdetail [A.B.C.D]"

all code:

  - Sync with quagga_0_99_17_release from
    git://code.quagga.net/quagga.git.

ospf6d:

  - Improve support for equal-cost multipath routing.

  - Apply network mask to connected routes when generating prefixes
    included in link-LSAs.

  - Ignore host bits when determining if OSPFv3 routes are equivalent.

  - Avoid using MaxAge LSAs for SPF calculations.

  - Improve MinLSArrival processing.

  - Expose additional LSA debugging vty commands to vtysh.

  - Improve OSPFv3 support for multiple address families and add a
    configuration option to enable AF interoperability with other RFC
    5838 implementations.

  - Support specifying OSPFv3 area-IDs as a decimal value in addition to
    dotted quad notation.

  - Fix reported consec-hello-threshold configuration value.

  - Add support for lower-layer link status and RFC 4938/5578 and link
    metrics signaling initially developed as part of the CABLE JCTD
    project.  Some improvements include: support for multiple cost
    metric formulas; improve handling of invalid link metrics updates;
    make the link metrics netlink multicast group configurable.

  - Improved support for OSPFv3 link-local signaling (RFC 5613).

  - Improve OSPFv3 route redistribution.

  - Add a framework for extensible interface and neighbor operations
    to allow registering callbacks for certain events and deconflict
    managing neighbor cost metrics.

  - Set the hop limit for OSPFv3 multicast packets to 1 by default.

  - Improve vty commands for neighbor status information.

  - Add a configurable delay and hold time for area SPF calculations.

  - Fix an issue where neighbor interface index changes were not
    processed correctly for MDR interfaces.

  - Fix some small memory leaks.

  - Add options to modify how SMF relaying is controlled.

zebra:

  - Add the option to sort rib entry next-hops when equal-cost
    multipath routing is enabled and active.

doc:

  - Update OSPF-MDR and OSPFv3 Address Families documentation; document
    new zebra and ospf6d vty commands.

Known issues:

  - Most neighbor metric managers do not react when the associated
    interface cost changes and per-neighbor cost metrics may not be
    updated (can affect non-broadcast interfaces).

  - OSPFv3 Address Families does not include support for the IPv6 MTU
    TLV in link-local signaling data.


quagga-mr 0.99.16mr1.0 release (June 2010)
------------------------------------------

This release includes updates to OSPF-MDR based on the 0.99.16 release
of Quagga.  A brief summary of changes since the previous patch
release (quagga-0.99.9.ospfv3-manetmdr.patch) are listed below.

New features
~~~~~~~~~~~~

all code:

    - upgrade to quagga-0.99.16 base
    - remove whitespace changes
    - general coding style cleanup

ospf6d:

    - Add TLV data before calculating the LLS checksum
    - Don't remove self-originated MaxAge LSAs
    - Make MinLSArrival and MinLSInterval configurable
    - Enforce MinLSInterval
    - Fix checksum comparison when determining which lsa is newer
    - workaround some cases of inconsistent neighbor state
    - cleanup handling MDR-specific time
    - Fix SMF file descriptor handling
    - Use sizeof() the destination to avoid an overflow in memcpy()
    - Fix unlocking LSAs
    - Fix prematurely aging a LSA when using relative time
    - allow quagga to log links and paths to a file, for use by
      SDT/CMAP visualization
    - add metric function API that allows new links to enter network
      with high cost and lower cost over time
    - restore improved SMF integration
    - add neighbor acceptance criteria (consecutive hellos to
      transition to INIT)
    - expose MDRConstraint parameter to vtysh API
    - lexicographic comparison for MDR selection was ignoring router
      priority

vtysh:

    - Fix vty completion with readline 6

zebra:

    - consider all nexthops when looking for a gateway match
    - set the interface link-layer socket address

other:

    - Fix some configure script problems on FreeBSD

Caveats and known issues
~~~~~~~~~~~~~~~~~~~~~~~~

    - OSPF MDR is not completely aligned with RFC 5614 as published,
      but with a draft version of that specification.

    - The checksum of incoming link-local signal data is not checked.

    - This version may not function correctly in FreeBSD 8.0 jails
      when routes are redistributed between ospfd and ospf6d.  The
      CORE example scenario sample1.imn is a known problem case.