QA Cafe - Knowledgebase - CDRouter 6.3 Release Notes

Knowledge Base > CDRouter 6.3 Release Notes

CDRouter 6.3 Release Notes

Release History

Release Type	Release Number	Release Date
Original	CDRouter 6.3 Build 83	August 27, 2010
Maintenance	CDRouter 6.3 Build 85	September 8, 2010
Maintenance	CDRouter 6.3 Build 88	September 14, 2010
Maintenance	CDRouter 6.3 Build 89	September 23, 2010
Maintenance	CDRouter 6.3 Build 93	November 8, 2010
Maintenance	CDRouter 6.3 Build 94	December 10, 2010

Original release: CDRouter 6.3 build 83, August 27, 2010

New Features and Enhancements

CDRouter

New test case in the icmp.tcl test module

The test case cdrouter_icmp_13 has been added to the icmp test module to verify that the DUT properly translates ICMP Destination Unreachable packets with ICMP code 4 (Fragmentation needed). This test is similar to cdrouter_icmp_12. To disable verification of the IPv4 ID field during this test, set the testvar natVerifyIpId to "no".
```
testvar natVerifyIpId no
```

CDRouter IPv6

Support for PPPoE on the WAN

CDRouter IPv6 now supports PPPoE as a WAN connection mode for IPv6. When PPPoE is enabled on the WAN for IPv6, CDRouter will terminate IPv6CP Configure-Requests from the DUT. Once the PPPoE connection is established, CDRouter will terminate DHCPv6 address and/or prefix requests from the DUT. CDRouter also supports configurations where the DUT's LAN IPv6 address is staticly configured. To enable PPPoE for IPv6, set the testvar ipv6WanMode to PPPoE.
```
testvar ipv6WanMode       PPPoE
testvar pppoeUser         qacafe
testvar pppoePassword     qacafe123
```
PPPoE for IPv6 is independent of the IPv4 WAN mode chosen. However, if PPPoE is chosen for both the IPv4 and IPv6 WAN connection modes, CDRouter assumes that both the IPCP and IPv6CP Configure-Requests from the DUT occur within the same PPP session. Click here for an example. CDRouter does not support configurations where the IPCP and IPv6CP Configure-Requests occur in different PPP sessions. As a result, only a single set of PPPoE credentials can be configured, using the testvars pppoeUser and pppoePassword.

For more information on testing IPv6 over PPPoE with CDRouter, please see this Applcation Note.

Enhanced support for static IPv6 on the WAN

CDRouter IPv6 now supports configurations that utilize static IPv6 on the WAN in conjunction with DHCPv6 prefix delegation for the LAN prefix assignment. To enable this mode of operation, set the testvar ipv6WanMode to static and enable DHCPv6 prefix delegation. Note that in this mode of operation the prefix portion of the testvar ipv6LanIp must be explicitly specified and must match the prefix portion of the dhcpv6WanAssignPrefix testvar.

testvar ipv6WanMode           static
testvar ipv6WanIspIp          3001::1 
testvar ipv6WanIspAssignIp    3001::2
testvar ipv6WanIspNextIp      3001::3
testvar ipv6WanIspPrefixLen   64

# -- DHCPv6 prefix delegation configuration
testvar dhcpv6WanEnablePD              yes 
testvar dhcpv6WanAssignPrefix          3001:dddd::
testvar dhcpv6WanAssignNextPrefix      3001:ddde::
testvar dhcpv6WanAssignPrefixLen       48 
testvar dhcpv6PDLatency                30

# -- LAN IPv6 settings
testvar ipv6LanMode         autoconf
testvar ipv6LanIp           3001:dddd::%eui64%
testvar ipv6LanPrefixLen    64

CDRouter TR-069

Support for Broadband Forum Device 2.0 data model profiles

CDRouter TR-069 now includes experimental support for verifying the Device 2.0 data model profiles defined in Broadband Forum TR-181 Issue 2. The new test module tr181i2_profiles has been added to facilitate testing of the Device 2.0 data model profiles. Note that the DUT must support the Device 2.0 data model to perform these tests and that currently only profile verification testing for TR-181 Issue 2 is supported by CDRouter. Additional Device 2.0 functionality will be included in future releases.
Preliminary support for TR-069 over IPv6

CDRouter TR-069 now supports TR-069 over IPv6. To configure TR-069 over IPv6, the DUT must support IPv6 on the WAN, and CDRouter's ACS must be configured with an IPv6 address using the testvar acsIp:
```
testvar acsIp 3009::1
```
CDRouter's TR-069 over IPv6 functionality requires both the CDRouter IPv6 and CDRouter TR-069 add-ons. This release provides only basic functionality for verifying the mechanics of TR-069 over IPv6 networks. Advanced support for TR-069 over IPv6 and additional features will be included in future releases.
PD-128 test module has been renamed

The Broadband Forum has changed the name of the PD-128 test plan to OD-128. CDRouter's pd128 test module has been renamed od128 for consistency. The Broadband Forum has also renumbered Tests 17 and above in OD-128. As a result, any CDRouter test packages or scripts utilizing the original pd128 test module must be updated to use the od128 test module instead. In addition, Tests 17+ have been renumbered, so any packages or scripts that were running or skipping specific tests above Test 17 will have to be manually updated.
CDRouter now supports OD-128 Rev 3.0

CDRouter's opd128 test module has been updated to reflect the changes in the most recent approved version of OD-128. CDRouter's od128 test module now conforms to OD-128 Version 3.0, and now includes support for OD-128 Tests 17.1 through 17.4 dealing with File Uploads. To configure file uploads, the testvar tr69UploadRPC must be set to "yes", and the testvars tr69UploadPath and tr69ConfigUploadFilename must specify the location where the file will be uploaded to on the local Linux host, and the name of the file:
```
testvar tr69UploadRPC             yes
testvar tr69UploadPath            /tmp
testvar tr69ConfigUploadFilename  vendor_configuration_file
```
New testvar for delaying UDP connection requests from ACS

CDRouter now has a mechanism for delaying successive UDP connection request attempts when testing TR-111 Part 2 configurations. This can be useful if the DUT implements a minimum UDP connection request interval. By default, CDRouter will attempt UDP connection requests as needed during a test run (with a delay of 0). To configure a delay, include the testvar acsUdpConnectionDelay in your config file. This testvar specifies the delay, in seconds, that CDRouter will wait before UDP connection request attempts to DUT:

testvar acsUdpConnectionDelay 20

Note that each UDP connection request attempt by CDRouter involves sending two separate UDP connection request messages as recommended in Section G.2.2.3 of TR-069 Amendment 2. The acsUdpConnectionDelay is only applied before each UDP connection request attempt.

TCP retransmission enabled for OD-128 firmware download tests

Prior to this release TCP retransmission was disabled for the OD-128 download tests (OD-128 Test 8). With TCP retransmission disabled, any packet loss during the download process would result in a test case failure. The OD-128 firmware download tests will now be run with TCP retransmission enabled, since the purpose of the test is to verify the download mechanism (some packet loss is deemed acceptable in this case).

New factory reset test in the tr69 test module

A new test case, tr69_300, for verifying the FactoryReset RPC has been added to the tr69 test module. This test must be used with caution - running it will reset the DUT's to factory defaults, which may be different than the running configuration and alter the test setup. This test should only be run if the base CDRouter configuration matches the factory default configuration of the DUT. To enable this test the testvar tr69FactoryResetRPC must be set to yes:
```
testvar tr69FactoryResetRPC   yes
```

BuddyWeb

Integrated CloudShark capture file decodes

This new feature allows you to view CDRouter generated capture files directly in your browser without having to open Wireshark. This feature utilizes the same engine used to power CloudShark.org, a new service offered by QA Cafe.

Note that this feature requires both Wireshark and the command line tools tshark and capinfos. These applications can be installed on newer Ubuntu systems using the following command (note that capinfos is installed by default when wireshark is installed):
```
sudo apt-get install wireshark tshark
```
If tshark is not installed, BuddyWeb will generate a warning message when the integrated CloudShark capture file viewer is invoked. CloudShark viewing can be disabled by visiting the the Preferences page in BuddyWeb and unselecting the "Use CloudShark for captures" option. When this feature is disabled Wireshark must be used to view all capture files.
In-line packet decodes

BuddyWeb now allows you to click on any packet in a log and view a complete decode within the same session without opening Wireshark. This feature is very useful and utilizes the new browser based Wireshark decode functionality described above.

New Test Modules and Test Cases

CDRouter

New test case 1

TEST: Verify NAT translates IP address in ICMP Destination Unreachable with code fragmentation needed
MODULE: icmp.tcl
NAME: cdrouter_icmp_13

CDRouter IPv6

In addition, the new pppoe-c-v6 test module has been added with 11 new test cases.

MODULE: pppoe-c-v6.tcl 
NAME: PPPoE client tests with IPv6 on the WAN side of the router

For a complete description of all individual test cases included in the above test module, please see the official list of CDRouter IPv6 test case summaries.

CDRouter TR-069

New test case for verifying the FactoryReset RPC in the tr69 test module

TEST: Verify the FactoryReset RPC
MODULE: tr69.tcl
NAME: tr69_300

New test case for verifying the File Upload RPC in the od128 test module

TEST: OD-128 Test 17 Part 1: File Upload - No ACS specified Delay
MODULE: od128.tcl
NAME: od128_test_17.1

New test case for verifying the File Upload RPC in the od128 test module

TEST: OD-128 Test 17 Part 2: File Upload - ACS specified Delay
MODULE: od128.tcl
NAME: od128_test_17.2

New test case for verifying the File Upload RPC in the od128 test module

TEST: OD-128 Test 17 Part 3: File Upload - No ACS specified Delay - SSL
MODULE: od128.tcl
NAME: od128_test_17.3

New test case for verifying the File Upload RPC in the od128 test module

TEST: OD-128 Test 17 Part 4: File Upload - ACS specified Delay - SSL
MODULE: od128.tcl
NAME: od128_test_17.4

In addition, the new tr181i2_profiles test module has been added with 281 new test cases.

MODULE: tr181i2_profiles.tcl 
NAME: TR-181 issue 2 CWMP Profile testing for Device:2

For a complete description of all individual test cases included in the above test module, please see the official list of CDRouter TR-069 test case summaries.

Bug Fixes and Notes

CDRouter

The cdrouter_app_207 test case has been updated to always use an even port for RTP and the next highest odd port for RTCP, as recommended in Section 11 of RFC 3550. In prior releases the RTP and RTCP ports were arbitrarily chosen and were not necessarily even and odd, respectively.

CDRouter IPv6

Testcase ipv6_ndp_30.tcl has been updated to handle DHCPv6 on the WAN and autoconf on the LAN when the 'M' bit is set in IPv6 router advertisements. Previously, this test case was not processing the results of the DHCPv6 Information Request correctly for this configuration.

CDRouter TR-069

Updated the tr111_part2.tcl module to support routers with short UDP NAT timeouts. When CDRouter switches the stun server, new UDP connection requests must be made from the current STUN server not the ACS. The original NAT binding for the stun server on the ACS may be deleted if the UDP NAT timeouts are short.

The OD-128 firmware download and config file upload tests that involve an ACS specified delay have been updated (od128_test8.2, od128_test_8.4, od128_test_17.2, and od128_test_17.4). These tests now verify that the CPE delays the specified amount of time before honoring the RPC from the ACS. For example, if the ACS specifies a delay of 60 seconds, these test cases now ensure that the CPE waits 60 seconds before downloading or uploading the requested file.

CWMP Profiles ADSLWAN, ADSL2WAN, and VDSL2WAN no longer include the general parameter InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}. since this parameter pulls in other potential interfaces that may not be part of the ADSL or VDSL2 interfaces. Devices with multiple WAN interfaces could previously have an issue trying to validate these profiles in the tr098_profiles.tcl module.

BuddyWeb

Package progress is now included in the title of the live page. This helps you check on your tests even if the tab or window is in the background.
Refined the look of dialog boxes and buttons

Maintenance release: CDRouter 6.3 build 85, September 8, 2010

Bug Fixes and Notes

CDRouter TR-069

CDRouter's TR-098 profile definitions have been updated to resolve an issue with parameters containing multiple instances that did not also have the parent object defined as part of the profile. The TR-098 profiles now include the parent object for any parameter with multiple instances. CDRouter's TR-098 profile definitions were the only profile definitions impacted by this issue.

The od128.tcl test module has been updated to automatically skip od128_test_24.1 if the only LAN interface available is wireless. In CDRouter 6.3 Build 83 od128_test_24.1 would not be skipped when using wireless only on the LAN, which would produce a fatal error. This issue impacted CDRouter 6.3 Build 83 only - all earlier releases were not susceptible to this issue.

Maintenance release: CDRouter 6.3 build 88, September 14, 2010

Bug Fixes and Notes

CDRouter TR-069

In previous releases the tr69UploadPath testvar was not used properly in tests od128_test_17.1 through od128_test_17.2. This build resolves this issue and ensures that the file uploaded by the DUT to the ACS is written to the local directory specified by the tr69UploadPath testvar.

The logic that determines which TR-069 tests to skip based on TR-069 device type and support for TR-111 Part 1 has been updated. In previous releases of CDRouter 6.3 this logic was incorrect due to the renumbering of the od128.tcl test module that was included in the original release of CDRouter 6.3. Note that this issue impacts users of the od128.tcl test module in earlier releases of CDRouter 6.3 only. In addition, only tests above od128_test_17.x are impacted.

Maintenance release: CDRouter 6.3 build 89, September 23, 2010

Bug Fixes and Notes

CDRouter

This build resolves an issue with the advanced forward unknown configuration discussed in Using CDRouter with Traffic Generators section in the CDRouter User's Guide. In previous releases broadcast traffic sent by the DUT on the WAN was not processed correctly by CDRouter when a forwarding interface was enabled. For example, if the DUT sent a broadcast DHCPDISCOVER, as expected during some of CDRouter's DHCP client tests, CDRouter's WAN DHCP server would not respond. As a result the DUT would not obtain an address on the WAN causing all subsequent tests to fail.

Maintenance release: CDRouter 6.3 build 91, October 5, 2010

Bug Fixes and Notes

CDRouter

This build resolves a minor display issue with older versions of the Firefox web browser and the CloudShark-based capture decode functionality included in CDRouter 6.3.

Maintenance release: CDRouter 6.3 build 93, November 8, 2010

Bug Fixes and Notes

CDRouter

In previous releases the cdruter_pppoept_1 test case would produce an unexpected fatal error when VLANs were used on the WAN. This issue is resolved in this build.

CDRouter TR-069

This build resolves an issue with the od128_test_10.4 test case when testing LAN side STB devices. In earlier releases this test performed parameter validation for STB devices against the wrong data model, which resulted in a test case error.

Maintenance release: CDRouter 6.3 build 94, December 10, 2010

Bug Fixes and Notes

CDRouter TR-069

CDRouter's ACS TCP retransmission behavior can now be disabled by setting the testvar acsTcpRetransTimer to 0. This disables TCP retransmissions and returns the ACS TCP behavior to be the same as CDRouter 6.2 and previous releases. In some cases, using CDRouter's TCP retransmission for ACS connections can result in slow downloads when the CPE frequently brings the TCP receive window to 0. In CDRouter 6.3 and newer releases, TCP retransmission behavior is enabled for the ACS with a value 5000 milli-seconds.

testvar acsTcpRetransTimer 0

Related articles that may also be helpful: