qacafe - ip test solutions
Knowledge Base > Release Notes > CDRouter 3.3 Release Notes

CDRouter 3.3 Release Notes

Welcome to CDRouter version 3.3!

What's new in version 3.3:

  Support for newer linux kernels
  -------------------------------

  * CDRouter 3.3 resolves a problem that prevented CDRouter run from
    running on linux kernel's greater than 2.6.11. CDRouter has now
    been tested using the latest Linux stable kernels up to version
    2.6.16.


  ATTENTION: Fedora Core users
  ----------------------------
  
  * Linux kernels built for Fedora Core distributons are configured
    with a 4k stack size. If you are using a wireless card with
    driverloader, you must upgrade to a kernel that is built with
    16k stacks. We do not recommend using the stack workaround
    in driverloader with wireless cards.

    For additional help on upgrading your kernel to a 16k stack
    please visit:

    http://www.qacafe.com/help/question.php?qstId=135

 
  No more Install GUI
  -------------------

  * CDRouter no longer requires a GUI/X11 window when installing a new
    version. The *.exe that is downloaded can now be run in text 
    only mode without X11 DISPLAY support. Previously, the install 
    had to be initiated from a windows environment.

    The install process is still the same. After the install *.exe
    is run, a *.tgz is placed in the current directory. This file
    contains the installation files for each Linux distribution.


  New UDP NAT test cases
  ----------------------

  * The nat.tcl module has been updated with new test cases based on
    the latest IETF Draft - NAT Requirements for Unicast UDP (06). The
    following two test cases have been added:

    TEST 66: Verify NATP uses port parity preservation
    MODULE: nat.tcl 
    NAME: cdrouter_nat_350 


    TEST 67: Verify ICMP unreachable from WAN does not destroy NAT mapping
    MODULE: nat.tcl 
    NAME: cdrouter_nat_360 


    NOTE: If the NAPT implementation does not support the presrvation
    of port parity, the test case cdrouter_nat_350 may be skipped
    by configuring testvar natPortParity to no.

    testvar natPortParity no



  Path MTU Discovery Update
  -------------------------

  * Test cdrouter_icmp_20 for path MTU discovery has been updated
    to better catch cases where a router is forwarding and fragmenting
    packets with the DF bit (Don't Fragment) set. Previously, CDRouter
    would not catch the case where the router was incorrectly
    fragmenting packets with the DF bit set.


  WPA2 support
  ------------

  * CDRouter 3.3 now supports WPA2. To enable WPA2, the device under
    test must be configured in WPA2 mode and the testvar wpaMode must 
    be configured as 'WPA2'.

        testvar wpaMode WPA2

    You must also update driverloader to version 2.32 or newer and use
    a wireless card that supports WPA2. When CDRouter starts, it will 
    now display all of the wireless capabilities supported:

    INFO(setup): 15:35:25| Device wlan1 supports WPA, WPA2, AES, TKIP, WEP128

    If 'WPA2' does not appear in the list, then WPA2 is not supported
    by the card. For some cards, upgrading the driver will enabled WPA2.

    QA Cafe has been testing WPA2 wireless cards for both PCI and USB. 
    Please contact support@qacafe.com for help on selecting a WPA2 
    wireless card.

    More help on WPA2 is available from the QA Cafe Knowledgebase. Try
    searhcing the knowledgebase for 'WPA2'.

    http://www.qacafe.com/help/search.php?k=WPA2
    

  Linux interface checking
  ------------------------

  * Starting in CDRouter 3.3, CDRouter will check each interface used
    for CDRouter testing for any Linux IP configuration. If CDRouter
    detects an IP address is configured on the interface under Linux,
    it will stop testing and issue and error. This address check
    may be disabled by add "-ignore-address-warning" on the buddy
    command-line or 'touch /usr/buddyweb/etc/ignore-address-warning'
    for BuddyWeb. 

    For more information on this topic, please see the following
    support notes:

    http://www.qacafe.com/help/question.php?qstId=132
    http://www.qacafe.com/help/question.php?qstId=21


  New test case for accepting RIP updates on the WAN
  --------------------------------------------------

  * A new test case (cdrouter_rip_200) has been added to the rip.tcl
    module to verify that router can accept a RIP update from the WAN
    interface. This test can be enabled by setting the testvar
    ripAcceptWanUpdate to yes.

    testvar ripAcceptWanUpdate yes


  New test case for DHCPINFORM
  ----------------------------
  * A new test case (cdrouter_dhcp_server_700) has been added to the
    dhcp-s.tcl module to verify DHCPINFORM requests from DHCP clients.
    The test case verifies that DHCPINFORM request are accepted for
    both unicast and broadcast addresses.

    If the router does not support DHCPINFORM, the testvar dhcpInform
    should be set to no. It defaults to yes.

    testvar dhcpInform no


  H.323 Inbound ALG
  -----------------

  * This release fixes a problem with the H.323 test cases that did not
    support an H.323 ALG that remapped the WAN side media channel port
    number when the openLogicalChannelAck is forwarded from the WAN to
    to the LAN.


  Viewing log files with BuddyWeb
  -------------------------------

  * BuddyWeb now adds colors and highlighting to log files to help you 
    analyze and understand test results. By colorizing important messages 
    and packet traces in the logs, your eye is able to quickly locate 
    the important log messages, saving you precious time searching 
    through lots of unformatted text.  If you prefer not to see the trace 
    highlighting, or need access to the plain text file, you can find 
    the option to turn it on and off in the "Advanced" page in BuddyWeb.

    For more information on BuddyWeb and all its features, please visit:

      http://www.qacafe.com/buddyweb.htm


  New Test Result View in BuddyWeb
  --------------------------------

  * BuddyWeb has a new test result view that displays each test in the 
    order in which it was run. This "View as Sequence" view is useful 
    in situations where you want to see all the tests that have run at 
    the same time.  Previously, only the current Loop was shown. This 
    also supports filtering based on the test result. For example, 
    the list might display only the passed tests.  

    More information about BuddyWeb can be found at:

       http://qacafe.com/help/category.php?catId=12

    NOTE: After upgrading to CDRouter 3.3, you should hit -Refresh 
    on your Firefox browser to make sure your browser is not caching
    anything it should not be! You can also close and restart your
    browser.


  New "Pause" Option in BuddyWeb
  ------------------------------
   
  * You can now enable "pause" mode from BuddyWeb by turning on the
    "pause" option when configuring a packages's run time options.
    The "pause" option in BuddyWeb works the same as the -pause
    option from the command-line. When "pause" is enabled, BuddyWeb
    will prompt the user before each test case. The test case will
    not start until the "Pause Dialog" is acknowledged. While BuddyWeb
    waits for the acknowledgement, CDRouter will continue to process
    any events on the WAN and LAN interfaces.

    Pause mode can be useful for certain debug situations where you
    may want to repeat a test over and over by check the status of
    the device manually between test cases.


  DHCP Client Options
  -------------------

  * You may now configure additional DHCP client options for the CDRouter
    DHCP LAN client using testvars dhcpClientOptionCode* and 
    dhcpClientOptionData*. Client side options are configured the
    same way as the existing DHCP server side options.

    Up to 10 additional DHCP options can be configured. Each DHCP option 
    is configured using 2 testvar entries for the DHCP option code 
    and raw hex data for the option. The DHCP option data must be 
    converted into the raw ascii hex format. NOTE: You do not need to 
    include the total option length in the data portion since this 
    will be computed automatically. See the user's guide for more examples.

    
    Example, to add DHCP option 124 and DHCP option 125
    
       testvar dhcpClientOptionCode1  124
       testvar dhcpClientOptionData1  000000000401020304
       testvar dhcpClientOptionCode2  125
       testvar dhcpClientOptionData2  000000000401020304



  DHCP filter for CMTS setups
  ---------------------------

  * In some CMTS (Cable Modem Termination System) environments, CDRouter can
    now be configured with the MAC address of the expected DHCP client on the
    WAN. This allows a DHCP client that is part of DOCSIS not to interfere
    with any of the DHCP client testing of the gateway under test. To enable
    this DHCP filter, the testvar dhcpClientMac should be set to the expected
    mac address of the DHCP client on the WAN. 

       testvar dhcpClientMac 00:00:03:04:05:06

    When enabled, CDRouter will ignore any DHCP client that does not use
    the configured MAC address.

    NOTE: This option is used only when the testvar wanMode is set to "DHCP".


  DynDNS Update
  -------------

  For DynDNS testing, CDRouter now enables an IP address checker at 
  checkip.dyndns.org for any DynDNS clients that use this feature of the
  DynDNS service. This feature is enabled automatically if DynDNS is
  enabled.

  Control-C bug fixed
  -------------------

  * This release fixes a potential problem with hitting "Control-C"
    while buddy is running. It was possible for Control-C" not 
    to stop the test run and leave buddy in a hung state. This is
    fixed in the CDRouter 3.3 release.