<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="3"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<rfc category="info" docName="draft-cerveny-bmwg-ipv6-nd-04" ipr="trust200902">
  <front>
    <title abbrev="draft-cerveny-bmwg-ipv6-nd-04">Benchmarking Neighbor
    Discovery</title>

    <author fullname="Bill Cerveny" initials="W.J." surname="Cerveny">
      <organization>Arbor Networks</organization>

      <address>
        <postal>
          <street>2727 South State Street</street>

          <city>Ann Arbor</city>

          <region>MI</region>

          <code>48104</code>

          <country>USA</country>
        </postal>

        <phone/>

        <facsimile/>

        <email>wcerveny@arbor.net</email>

        <uri/>
      </address>
    </author>

    <author fullname="Ron Bonica" initials="R." surname="Bonica">
      <organization>Juniper Networks</organization>

      <address>
        <postal>
          <street> 2251 Corporate Park Drive</street>

          <city> Herndon</city>

          <region>VA</region>

          <code>20170</code>

          <country>USA</country>
        </postal>

        <phone/>

        <facsimile/>

        <email>rbonica@juniper.net</email>

        <uri/>
      </address>
    </author>

    <date day="14" month="February" year="2014"/>

    <abstract>
      <t>This document is a benchmarking instantiation of <xref
      target="RFC6583">RFC 6583: &ldquo;Operational Neighbor Discovery
      Problems&rdquo;</xref>. It describes a general testing procedure and
      measurements that can be performed to evaluate how the problems
      described in RFC 6583 may impact the functionality or performance of
      intermediate nodes.</t>
    </abstract>

    <note title="Requirements Language">
      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
      "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
      document are to be interpreted as described in <xref
      target="RFC2119">RFC 2119</xref>.</t>
    </note>
  </front>

  <middle>
    <section title="Introduction">
      <t>This document is a benchmarking instantiation of <xref
      format="default" target="RFC6583">RFC 6583: &ldquo;Operational Neighbor
      Discovery Problems&rdquo;</xref>. It describes a general testing
      procedure and measurements that can be performed to evaluate how the
      problems described in RFC 6583 may impact the functionality or
      performance of intermediate nodes.</t>
    </section>

    <section title="Terminology">
      <t><list style="hanging">
          <t hangText="Intermediate Node">A router, switch, firewall or any
          other device which separates end-nodes. The tests in this document
          can be completed with any intermediate node which maintains a
          neighbor cache, although not all measurements and performance
          characteristics may apply.</t>

          <t hangText="Neighbor Cache">The neighbor cache is a database which
          correlates the link-layer address and the adjacent interface with an
          IPv6 address.</t>

          <t hangText="Neighbor Discovery">See <xref target="RFC4861">Section
          1 of RFC 4861</xref></t>

          <t hangText="Scanner Network">The network from which the scanning
          tested is connected.</t>

          <t hangText="Scanning Interface">The interface from which the
          scanning activity is conducted.</t>

          <t hangText="Stale Entry Time">This is the duration for which a
          neighbor cache entry marked "Reachable" will continue to be marked
          "Reachable" if an update for the address is not received.</t>

          <t hangText="Target Network">The network for which the scanning
          tests is targeted.</t>

          <t hangText="Target Network Destination Interface">The interface
          that resides on the target network, which is primarily used to
          measure DUT performance while the scanning activity is
          occurring.</t>
        </list></t>
    </section>

    <section title="Overview of Relevant NDP and Intermediate Node Behavior">
      <t>In a traditional network, an intermediate node must support a mapping
      between a connected node's IP address and the connected node's
      link-layer address and interface the node is connected to. With IPv4,
      this process is handled by <xref target="RFC0826">ARP</xref>. With IPv6,
      this process is handled by NDP and is documented in <xref
      target="RFC4861"/>. With IPv6, when a packet arrives on one of an
      intermediate node's interfaces and the destination address is determined
      to be reachable via an adjacent network:<list style="numbers">
          <t>The intermediate node first determines if the destination IPv6
          address is present in its neighbor cache.</t>

          <t>If the address is present in the neighbor cache, the intermediate
          node forwards the packet to the destination node using the
          appropriate link-layer address and interface.</t>

          <t>If the destination IPv6 address is not in the intermediate node's
          neighbor cache:<list style="numbers">
              <t>An entry for the IPv6 address is added to the neighbor cache
              and the entry is marked "INCOMPLETE".</t>

              <t>The intermediate node sends a neighbor solicitation packet to
              the solicited-node multicast address on the interface considered
              on-link.</t>

              <t>If a solicited neighbor advertisement for the IPv6 address is
              received by the intermediate node, the neighbor cache entry is
              marked "REACHABLE" and remains in this state for 30 seconds.</t>

              <t>If a neighbor advertisement is not received, the intermediate
              node will continue sending neighbor solicitation packets every
              second until either a neighbor solicitation is received or the
              maximum number of solicitations has been sent. If a neighbor
              advertisement is not received in this period, the entry can be
              discarded.</t>
            </list></t>
        </list></t>

      <t>There are two scenarios where a neighbor cache can grow to a very
      large size:<list style="numbers">
          <t>There are a large number of real nodes connected via an
          intermediate node's interface and a large number of these nodes are
          sending and receiving traffic simultaneously.</t>

          <t>There are a large number of addresses for which a scanning
          activity is occuring and no real node will respond to the neighbor
          solicitation. This scanning activity can be unintentional or
          malicious. In addition to maintaining the "INCOMPLETE" neighbor
          cache entry, the intermediate node must send a neighbor solicitation
          packet every second for the maximum number of socicitations. With
          today's network link bandwidths, a scanning event could cause a lot
          of entries to be added to the neighbor cache and solicited for in
          the time that it takes for a neighbor cache entry to be
          discarded.</t>
        </list></t>

      <t>An intermediate node's neighbor cache is of a finite size and can
      only accommodate a specific number of entries, which can be limited by
      available memory or a preset operating system limit. If the maximum
      number of entries in a neighbor cache is reached, the intermediate node
      must either drop an existing entry to make space for the new entry or
      deny the new IP address to MAC address/ interface mapping with an entry
      in the neighbor cache. In an extreme case, the intermediate node's
      memory may become exhausted, causing the intermediate node to crash or
      begin paging memory.</t>

      <t>At the core of the neighbor discovery problems presented in <xref
      target="RFC6583">RFC 6583</xref>, unintentional or malicious IPv6
      traffic can transit the intermediate node that resembles an IP address
      scan similar to an IPv4-based network scan. Unlike IPv4 networks, an
      IPv6 end network is typically configured with a /64 address block,
      allowing for upwards of 2**64 addresses. When a network node attempts to
      scan all the addresses in a /64 address block directly attached to the
      intermediate node, it is possible to create a huge amount of state in
      the intermediate node's neighbor cache, which may stress processing or
      memory resources.</t>

      <t>Section 7.1 of RFC 6583 recommends how intermediate nodes should
      behave when the neighbor cache is exceeded. <xref
      target="RFC6583">Section 6 of RFC 6583</xref> recommends how damage from
      an IPv6 address scan may be mitigated. <xref target="RFC6583">Section
      6.2 of RFC 6583</xref> discusses queue tuning.</t>
    </section>

    <section title="Test Setup">
      <t>The network needs to minimally have two subnets: one from which the
      scanner(s) source their scanning activity and the other which is the
      target network of the address scans.</t>

      <t>It is assumed that the latency for all network segments is neglible.
      By default, the target network's subnet shall be 64-bits in length,
      although some tests may involve increasing the prefix length.</t>

      <t>Although packet size shouldn&rsquo;t have a direct impact, packet per
      second (pps) rates will have an impact. Smaller packet sizes should be
      utilized to facilitate higher packet per second rates.</t>

      <t>For purposes of this test, the packet type being sent by the scanning
      device isn&rsquo;t important, although most scanning applications might
      want to send packets that would elicit responses from nodes within a
      subnet (such as an ICMPv6 echo request). Since it is not intended that
      responses be evoked from the target network node, such packets
      aren&rsquo;t necessary.</t>

      <t>At the beginning of each test the intermediate node should be
      initialized. Minimally, the neighbor cache should be cleared.</t>

      <figure>
        <preamble>Basic format of test network. Note that optional
        "non-participating network" is a third network not related to the
        scanner or target network.</preamble>

        <artwork><![CDATA[+---------------+             +-----------+              +--------------+
|               |   Scanner   |           |   Target     |              |
|   Scanning    |-------------|    DUT    |--------------|Target Network|
| src interface |   Network   |           |   Network    |dst interface |
|               |             |           |              |              |
+---------------+             +-----------+              +--------------+
                      ]]></artwork>
      </figure>

      <section title="Testing Interfaces">
        <t>Two tester interfaces are configured for most tests:<list
            style="symbols">
            <t>Scanning source (src) interface: This is the interface from
            which test packets are sourced. This interface sources traffic to
            destination IPv6 addresses on the target network from a single
            link-local address, similar to how an adjacent intermediate node
            would transit traffic through the intermediate node.</t>

            <t>Target network destination (dst) interface: This interface
            responds to neighbor solicitations as appropriate and confirms
            when an intermediate node has forwarded a packet to the interface
            for consumption. Where appropriate, the target network destination
            interface will respond to neighbor solicitations with a unique
            link-layer address per IPv6 address solicited.</t>
          </list></t>
      </section>
    </section>

    <section title="Modifiers (Variables)">
      <t/>

      <section title="Frequency of NDP Triggering Packets">
        <t>The frequency of NDP triggering packets could be as high as the
        maximum packet per second rate that the scanner network will support
        (or is rated for). However, it may not be necessary to send packets at
        a particularly high rate. In fact a goal of testing could be to
        identify if the DUT is able to withstand scans at rates which
        otherwise would not impact the performance of the DUT.</t>

        <t>Optimistically, the scanning rate should be incremented until the
        DUT&rsquo;s performance begins deteriorating. Depending on the
        software and system being used to implement the scanning, it may be
        challenging to achieve a sufficient rate. Where this maximum threshold
        cannot be determined, the test results should note the highest rate
        tested and that DUT performance deterioration was not noticed at this
        rate.</t>

        <t>The lowest rate tested should be the rate for which packets can be
        expected to have an impact on the DUT &mdash; this value is of course,
        subjective.</t>
      </section>
    </section>

    <section title="Tests">
      <section title="Stale Entry Time Determination">
        <t>This test determines the time interval when the intermediate node
        (DUT) identifies an address as stale.</t>

        <t><xref target="RFC4861">RFC 4861, section 6.3.2</xref> states that
        an address can be marked &ldquo;stale&rdquo; at a random value between
        15 and 45 seconds (as defined via constants in the RFC). This test
        confirms what value is being used by the intermediate node. Note that
        RFC 4861 states that this random time can be changed "at least every
        few hours."</t>

        <section title="General Testing Procedure">
          <t><list style="numbers">
              <t>Send a packet to an address in target network. Observe that
              the intermediate node sends neighbor solicitation to the
              solicited-node multicast address on the target network, for
              which tester destination interface responds with a neighbor
              advertisement. The intermediate node should create an entry in
              neighbor cache for the address, marking the address as
              "reachable". The packet should be forwarded to the tester
              destination interface.</t>

              <t>Wait one second.</t>

              <t>Send packet from tester source address to tester destination
              address. Determine if intermediate node sends neighbor
              solicitation. If intermediate node does send neighbor
              solicitation, the stale entry time has not been exceeded.</t>

              <t>If a neighbor solicitation was not sent after one second,
              wait 2 seconds send packet. If neighbor solicitation was not
              received, incrementing the wait time by one second and repeat
              this process until the intermediate node sends a neighbor
              solicitation for the address. The stale entry time is the number
              of seconds that elapsed between the first packet and when the
              neighbor solicitation was sent.</t>
            </list></t>
        </section>
      </section>

      <section title="Neighbor Cache Exhaustion Determination">
        <t>Discover the point at which the neighbor cache is exhausted and
        evaluate intermediate node behavior when this threshold is
        reached.</t>

        <section title="General Testing Procedure">
          <t><list style="numbers">
              <t>Send packets incrementally to addresses, simultaneously
              resending packets of previously discovered addresses within the
              stale entry time.</t>

              <t>Observe what happens when one address greater than the
              maximum neighbor cache size ("n") is reached. When "n+1" is
              reached, if either the first or most recent cache entry are
              dropped, this may be acceptable.</t>

              <t>Confirm intermediate node doesn't crash when "n+1" is
              reached.</t>
            </list></t>
        </section>
      </section>

      <section title="Determine Neighbor Discovery Behavior during address scan">
        <t>This test is a prerequisite for later tests, for which it is
        confirmed how an intermediate node behaves in the presence of an
        address scan. If adding the flow after the address scan results in
        abnormal behavior, it will be difficult to evaluate correct behavior
        for later tests.</t>

        <section title="General Testing Procedure">
          <t><list style="numbers">
              <t>Start sending n/2 (n determined in "Neighbor Cache
              Exhaustion" test) flows at a rate of one packet per second to
              valid addresses (valid addresses are defined as addresses for
              which the tester responds to neighbor solicitation).</t>

              <t>Send n/2 + 1 flow and determine if intermediate node takes a
              long time to process NS/NA for valid addresses.</t>
            </list></t>
        </section>
      </section>

      <section title="Pre-established Flow Treatment">
        <t>This test expands on "Determine neighbor discovery behavior during
        address scan". This test confirms behavior described in RFC 6483,
        where it is expected that in the presence of an address scan, flows
        for successfully cached addresses will continue to flow across the
        intermediate node.</t>

        <section title="General Testing Procedure">
          <t><list style="numbers">
              <t>Start n/2 flows (one packet per second per flow) to valid
              addresses.</t>

              <t>Start address scan to invalid addresses (addresses without
              responding host).</t>

              <t>Determine if flows continue for existing, valid flows
              continue without unexpected loss or delay.</t>
            </list></t>
        </section>
      </section>

      <section title="Stopped Flow Recovery Behavior">
        <t>This test determines how a stopped flow recovers from the stale
        state in the presence of an address scan. It confirms that the
        intermediate node continues to prefer addresses that had previously
        been added to the neighbor cache, even when the address is marked
        "stale" in the neighbor cache.</t>

        <section title="General Testing Procedure">
          <t><list style="numbers">
              <t>Start n/2 flows (one packet per second per flow) to valid
              addresses.</t>

              <t>Start address scan to invalid addresses (addresses without
              responding host).</t>

              <t>Stop one flow to valid address.</t>

              <t>Wait stale time period for address to be marked "stale" in
              intermediate node neighbor cache.</t>

              <t>Restart stopped flow and confirm that address is marked
              "active" immediately (not stuck behind address scan).</t>
            </list></t>
        </section>
      </section>
    </section>

    <section title="Measurements Explicitly Excluded">
      <t>These are measurements which aren't recommended because of the
      itemized reasons below:</t>

      <section title="DUT CPU Utilization">
        <t>This measurement relies on the DUT to provide utilization
        information, which is subjective.</t>
      </section>

      <section title="Malformed Packets">
        <t>This benchmarking test is not intended to test DUT behavior in the
        presence of malformed packets.</t>
      </section>
    </section>

    <section title="DUT Initialization">
      <t>At the beginning of each test, the neighbor cache of the DUT should
      be initialized.</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <t>This document makes no request of IANA.</t>

      <t>Note to RFC Editor: this section may be removed on publication as an
      RFC.</t>
    </section>

    <section anchor="Security" title="Security Considerations">
      <t>Benchmarking activities as described in this memo are limited to
      technology characterization using controlled stimuli in a laboratory
      environment, with dedicated address space and the constraints specified
      in the sections above.</t>

      <t>The benchmarking network topology will be an independent test setup
      and MUST NOT be connected to devices that may forward the test traffic
      into a production network, or misroute traffic to the test management
      network.</t>

      <t>Further, benchmarking is performed on a "black-box" basis, relying
      solely on measurements observable external to the DUT/SUT. Special
      capabilities SHOULD NOT exist in the DUT/SUT specifically for
      benchmarking purposes.</t>

      <t>Any implications for network security arising from the DUT/SUT SHOULD
      be identical in the lab and in production networks.</t>
    </section>

    <section anchor="Acknowledgements" title="Acknowledgements">
      <t>Helpful comments and suggestions were offered by Al Morton, Joel
      Jaeggli, Nalini Elkins, Scott Bradner, and Ram Krishnan, on the BMWG
      e-mail list and at BMWG meetings. Precise grammatical corrections and
      suggestions were offered by Ann Cerveny.</t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include="reference.RFC.2119"?>

      <?rfc include='reference.RFC.0826'?>

      <?rfc include='reference.RFC.5180'?>

      <?rfc include='reference.RFC.6583'?>

      <?rfc include='reference.RFC.2544'?>

      <?rfc include='reference.RFC.4861'?>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.7048'?>
    </references>
  </back>
</rfc>
