CDRouter 12.24

February 10, 2022

New Features

  • USP: The CDRouter USP expansion now includes a full implementation of version 1.1 of TP-469, the Conformance Test Plan for User Services Platform Agents, which was released by the Broadband Forum at the end of January 2022. The UNH-IOL validated 12.24 to be used for certification. Thanks to Ben Patton and the entire UNH-IOL IP team.

    This is a major update to the usp_conformance test module containing many new test cases and updates based on changes to the test plan. For a complete list of changes associated with TP-469 version 1.1, please see the additional notes below.

    All users actively seeking TP-469 certification should upgrade to CDRouter 12.24 as soon as possible. More information on USP self-testing certification with CDRouter may be found here.

    Please contact support@qacafe.com with any questions!

  • TR-069: Added support for the CWMP Device:2.15 Data Model. [sc15153]

  • USP: Added support for the USP Device:2.15 Data Model. [sc15153]

Change Log

  • CDRouter: All test cases in mac-filter test module have been deprecated and will be removed in the next release of CDRouter. These test cases require LAN clients with static MAC addresses which is becoming less common in modern networks where most clients implement MAC randomization for privacy. The following tests will be removed in the next release.[sc15532]

    • cdrouter_mac_filter_1
    • cdrouter_mac_filter_2
    • cdrouter_mac_filter_3
    • cdrouter_mac_filter_4
    • cdrouter_mac_filter_5
    • cdrouter_mac_filter_6

  • CDRouter: The following testvars have also been deprecated due the deprecation of the mac-filter test module. [sc15532]

  • CDRouter: CDRouter will now set the tuned kernel parameter to throughput-performance during installation instead of setting it during start. [sc15020]

  • CDRouter: CDRouter now supports the current DynDNS update URL /v3/update in addition to the legacy URL /nic/update. [sc13769]

  • TR-069: CDRouter’s integrated STUN server now returns an error code of 431 when an invalid MESSAGE-INTEGRITY field is received, as specified by RFC 3489 which is required by TR-069 Annex G. [sc14218]

  • CDRouter: Resolved a test interface selection error that may result in a fatal error when running the cdrouter_ipsecpt_11, cdrouter_ipsecpt_120, cdrouter_sip_71, cdrouter_sip_72, or cdrouter_sip_73 test cases. [sc11258]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9943. [sc15261]

  • TR-069: The ACS and ACS download server certificates included with previous releases have expired. New ACS and ACS download server certificates and the associated intermediate and root CAs have are now available and have been included in this release. [sc15317]

  • TR-069: Resolved an issue with Device:2 implementations when the acsCreatePortMapOnIGD is enabled and used to create port mappings on the IGD. [sc14544]

  • TR-069: Resolved a fatal error in the tr69_27 test case after a failed connection request. [sc14889]

  • TR-069: Updated the logging in the tr143_http_3 and tr143_http_13 test cases to report TotalBytes(Sent|Received) instead of the test file size.[sc14806]

  • USP: The USP certificates shipped with previous releases of CDRouter will expire on February 18, 2022 and have been replaced by a new set of certificates that expire in February of 2023. [sc15142]

  • USP: A log message is now printed whenever the MQTT agent is unsubscribed. [sc13392]

  • USP: Removed Object references ending with ‘.’ per R-ARC.7 in TR-369. [sc15382]

  • USP: Updated the usp_30 test case to use the uspRebootTimeout testvar instead of the uspNotificationTimeout testvar. [sc15120]

  • USP: Added tests usp_annex_a_50 through usp_annex_a_67 for verifying BulkData functionality over MQTT. [sc15160]

  • USP: Added tests usp_annex_a_70 through usp_annex_a_76 for verifying ForceCollection() functionality. [sc15160]

Notices

  • CDRouter install error on CentOS 8: All NTA1000v7 systems are now eligible for an operating system upgrade from CentOS 8 to Rocky Linux 8. This upgrade is required because CentOS 8 has reached End-of-Life status. In addition, certain CentOS 8 repositories have recently moved leading to errors which prevent the installation of CDRouter. To resolve this issue, all NTA1000v7 users must migrate to Rocky Linux 8 as soon as possible.

    We have developed a comprehensive Rebuild System Drive guide that makes this process easy and fast with no loss of CDRouter data. Please contact support@qacafe.com with any questions or concerns and let us know when you have successfully completed the migration.

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Config upgrades: CDRouter 12.24 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.24 testvars using the config upgrade utility.

aliases: - /cdrouter/release-notes/cdrouter-12-24-release-notes/

New Test Cases

  • The following tests were added to TP-469 v1.1 and are now included in the usp_conformance module:

    • usp_conformance_1_78: Removal of subscriptions that have no associated controller
    • usp_conformance_1_79: Operate message using input args
    • usp_conformance_1_80: GetSupportedProtocol
    • usp_conformance_1_81: Automatic unique key generation
    • usp_conformance_1_82: Get message with unmatched search expression
    • usp_conformance_1_83: GetInstances message with unmatched search expression
    • usp_conformance_1_84: Notification - Subscription using search paths
    • usp_conformance_9_11: Use of the Timer! Event
    • All tests in Section 10: Bulk Data Collection tests

Modified Test Cases

  • The test metrics for usp_conformance_1_3 and usp_conformance_1_7 have been updated to include an invalid value for the Device.LocalAgent.Subscription.Enable parameter instead of having both an invalid parameter and a parameter with an invalid value. [sc14729]

  • Error codes 7011 and 7012 are now supported in usp_conformance_1_3 and usp_conformance_1_7. [sc14729]

  • Additional checks to verify that the core operation did not succeed have been added to the following tests: [sc11684]

    • usp_conformance_1_7
    • usp_conformance_1_8
    • usp_conformance_1_14
    • usp_conformance_1_15
    • usp_conformance_1_20
    • usp_conformance_1_24
    • usp_conformance_1_27
    • usp_conformance_1_28
    • usp_conformance_1_31
    • usp_conformance_1_32
    • usp_conformance_1_33
    • usp_conformance_1_34
    • usp_conformance_1_35

  • Error code 7012 is now supported in usp_conformance_1_8. [sc14727]

  • The usp_conformance_1_21 test has been updated to include an invalid value for the Device.LocalAgent.Subscription.Enable parameter instead of having both an invalid parameter and a parameter with an invalid value. Note that this update changes the OB-USP-AGENT test result. [sc14728]

  • Error codes 7011 and 7102 are now supported in usp_conformance_1_21. [sc14728]

  • In usp_conformance_1_40 a check has been added to verify that the resolved_path and requested_path fields are equal in the Get message. [sc14752]

  • A few typos in the title of usp_conformance_1_47 have been fixed. [sc14752]

  • The allow_partial field has been updated to false in the Set messages in usp_conformance_1_59 and usp_conformance_1_84. [sc14726]

  • The usp_conformance_1_55 test will now fail if the Agent does not delete the Subscription object after it expires. Note that this update changes the OB-USP-AGENT test result. [sc14808]

  • Added a check to usp_conformance_6_7 for a STOMP DISCONNECT frame. Note that this update changes the OB-USP-AGENT test result. [sc14813]

  • The usp_conformance_1_15 test now allows the NotifRetry parameter to be false or 0. [sc14259]

  • Corrected various parameters and values in the permissions tests in Section 2 of the test plan. [sc11024]

  • A check has been added to usp_conformance_3_6 to verify that the Agent does not accept TLS renegotiation. [sc13583]

  • The usp_conformance_4_1 test case has been simplified. This test now only verifies that the DUT is able to establish a connection with a new controller using MTP layer encryption. [sc13579]

  • Allows Agents with multiple slots to either send an error message or not in response to the Download operation in test usp_conformance_9_7. [sc13993]

  • The usp_conformance_1_47 test case has been update to set a proper boolean value of true rather than "true". [sc11690]

Removed Test Cases

  • The following tests were deprecated in TP-469 v1.1 and removed from the usp_conformance test module:

    • usp_conformance_1_63: Operate message using input args
    • usp_conformance_2_3: Agent does not process messages without controller’s certificate information
    • usp_conformance_2_4: Agent rejects messages from Endpoint IDs that are not in subject AltName
    • usp_conformance_2_5: Agent use of Self-Signed Certificates
    • usp_conformance_7_3: Agent Session Acceptance from Controller
    • usp_conformance_9_1: Use of the Boot! event and BootParameters

Fixes and Improvements

  • The usp_conformance_9_2 has been updated to exit early if the AddController() operation fails. [sc15157]

  • Resolved an issue when adding a new CoAP controller. [sc15100]

  • The usp_conformance_6_6, usp_conformance_6_7, and usp_conformance_6_10 tests now use Device.LocalAgent.MTP.{i}.STOMP.DestinationFromServer to find the correct connection. [sc14131]

  • The usp_conformance_2_19 and usp_conformance_2_20 test cases have been updated with an additional failure check. [sc14283]

  • Improved logging in USP Scenarios when the received error is not the expected error. This affects usp_conformance_1_4 and usp_conformance_1_6. [sc14279]

  • The usp_conformance_9_7 test case has been updated with an additional check to verify that the software versions are different before and after the firmware upgrade. [sc13585]

  • Removes trailing “.” from reference parameters when adding a new controller. [sc15382]

  • Fixes callback inconsistency with usp_conformance_1_78 & fixes the Websocket.Path parameter when adding a new controller [sc15119]

  • Uses the correct destination when adding a new CoAP controller. [sc15100]

  • Exits usp_conformance_9_2 if AddController() fails. [sc15157]

CDRouter 12.23

January 14, 2022

New Features

  • USP: The CDRouter USP expansion now includes a full implementation of version 1.1 of the upcoming TP-469 test plan, Conformance Test Plan for User Services Platform Agents, which is scheduled for release by the Broadband Forum by the end of January 2022.

    This is a major update to the usp_conformance test module containing many new test cases and updates based on changes to the test plan. For a complete list of changes associated with TP-469 version 1.1, please see the additional notes below.

    All users actively seeking TP-469 certification should upgrade to CDRouter 12.23 as soon as possible. More information on USP self-testing certification with CDRouter may be found here. Please contact support@qacafe.com with any questions!

Change Log

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9920. [sc15045]

  • New ACS TLS server certificates

    The ACS and ACS download server certificates shipped with previous releases of CDRouter have expired and have been replaced by a new set of test certificates signed by Sectigo.com (formerly COMODO) that expire February 2023. [sc15142]

  • Remove obsoleted testvar wirelessCountryCode. [sc14909]

Notices

  • Rocky Linux 8 migration: All NTA1000v7 systems are now eligible for an operating system upgrade from CentOS 8 to Rocky Linux 8. Please see our Rebuild System Drive guide for more information.

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Config upgrades: CDRouter 12.23 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.23 testvars using the config upgrade utility.

aliases: - /cdrouter/release-notes/cdrouter-12-23-release-notes/

New Test Cases

  • The following tests were added to TP-469 v1.1 and are now included in the usp_conformance module:

    • usp_conformance_1_78: Removal of subscriptions that have no associated controller
    • usp_conformance_1_79: Operate message using input args
    • usp_conformance_1_80: GetSupportedProtocol
    • usp_conformance_1_81: Automatic unique key generation
    • usp_conformance_1_82: Get message with unmatched search expression
    • usp_conformance_1_83: GetInstances message with unmatched search expression
    • usp_conformance_1_84: Notification - Subscription using search paths
    • usp_conformance_9_11: Use of the Timer! Event
    • All tests in Section 10: Bulk Data Collection tests

Modified Test Cases

  • The test metrics for usp_conformance_1_3 and usp_conformance_1_7 have been updated to include an invalid value for the Device.LocalAgent.Subscription.Enable parameter instead of having both an invalid parameter and a parameter with an invalid value. [sc14729]

  • Error codes 7011 and 7012 are now supported in usp_conformance_1_3 and usp_conformance_1_7. [sc14729]

  • Additional checks to verify that the core operation did not succeed have been added to the following tests: [sc11684]

    • usp_conformance_1_7
    • usp_conformance_1_8
    • usp_conformance_1_14
    • usp_conformance_1_15
    • usp_conformance_1_20
    • usp_conformance_1_24
    • usp_conformance_1_27
    • usp_conformance_1_28
    • usp_conformance_1_31
    • usp_conformance_1_32
    • usp_conformance_1_33
    • usp_conformance_1_34
    • usp_conformance_1_35

  • Error code 7012 is now supported in usp_conformance_1_8. [sc14727]

  • The usp_conformance_1_21 test has been updated to include an invalid value for the Device.LocalAgent.Subscription.Enable parameter instead of having both an invalid parameter and a parameter with an invalid value. Note that this update changes the OB-USP-AGENT test result. [sc14728]

  • Error codes 7011 and 7102 are now supported in usp_conformance_1_21. [sc14728]

  • In usp_conformance_1_40 a check has been added to verify that the resolved_path and requested_path fields are equal in the Get message. [sc14752]

  • A few typos in the title of usp_conformance_1_47 have been fixed. [sc14752]

  • The allow_partial field has been updated to false in the Set messages in usp_conformance_1_59 and usp_conformance_1_84. [sc14726]

  • The usp_conformance_1_55 test will now fail if the Agent does not delete the Subscription object after it expires. Note that this update changes the OB-USP-AGENT test result. [sc14808]

  • Added a check to usp_conformance_6_7 for a STOMP DISCONNECT frame. Note that this update changes the OB-USP-AGENT test result. [sc14813]

  • The usp_conformance_1_15 test now allows the NotifRetry parameter to be false or 0. [sc14259]

  • Corrected various parameters and values in the permissions tests in Section 2 of the test plan. [sc11024]

  • A check has been added to usp_conformance_3_6 to verify that the Agent does not accept TLS renegotiation. [sc13583]

  • The usp_conformance_4_1 test case has been simplified. This test now only verifies that the DUT is able to establish a connection with a new controller using MTP layer encryption. [sc13579]

  • Allows Agents with multiple slots to either send an error message or not in response to the Download operation in test usp_conformance_9_7. [sc13993]

  • The usp_conformance_1_47 test case has been update to set a proper boolean value of true rather than "true". [sc11690]

Removed Test Cases

  • The following tests were deprecated in TP-469 v1.1 and removed from the usp_conformance test module:

    • usp_conformance_1_63: Operate message using input args
    • usp_conformance_2_3: Agent does not process messages without controller’s certificate information
    • usp_conformance_2_4: Agent rejects messages from Endpoint IDs that are not in subject AltName
    • usp_conformance_2_5: Agent use of Self-Signed Certificates
    • usp_conformance_7_3: Agent Session Acceptance from Controller
    • usp_conformance_9_1: Use of the Boot! event and BootParameters

Fixes and Improvements

  • The usp_conformance_9_2 has been updated to exit early if the AddController() operation fails. [sc15157]

  • Resolved an issue when adding a new CoAP controller. [sc15100]

  • The usp_conformance_6_6, usp_conformance_6_7, and usp_conformance_6_10 tests now use Device.LocalAgent.MTP.{i}.STOMP.DestinationFromServer to find the correct connection. [sc14131]

  • The usp_conformance_2_19 and usp_conformance_2_20 test cases have been updated with an additional failure check. [sc14283]

  • Improved logging in USP Scenarios when the received error is not the expected error. This affects usp_conformance_1_4 and usp_conformance_1_6. [sc14279]

  • The usp_conformance_9_7 test case has been updated with an additional check to verify that the software versions are different before and after the firmware upgrade. [sc13585]

CDRouter 12.22

December 16, 2021

New Features

  • NTA1000: All NTA1000v7 systems are now eligible for an operating system upgrade from CentOS 8 to Rocky Linux 8. Please see our Rebuild System Drive guide for more information.

Change Log

  • CDRouter: The following testvars now have a minimum configurable value of 10 seconds. [sc14112]

  • IPv6: A number of test cases are not supported when the testvar ipv6WanMode is set to a value of none, and will now be automatically skipped . [sc14055]

  • IPv6: Fixed a typo in a failure log message in the v6_cpe_2_3_b test case. [sc14215]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9891. [sc14447]

  • TR-069: Logging in the tr143_http module has been improved for clarity. [sc13172]

  • TR-069: CDRouter’s connection request logic has been updated to ensure that the testvars acsNumberCpeAttempts and acsDelayCpeAttempts are honored in all scenarios. [sc14184]

  • TR-069: The tp181_test_5.5.2, tp181_test_5.5.3, and tp181_test_5.5.4 have been updated to properly enable firewall rules when created. In addition, test metrics and logging have been clarified. [sc14399]

  • TR-069: Resolved a fatal error in the tp181_test_5.6.10 test case. [sc14423]

  • TR-069: Resolved an issue in the tp181_test_5.4.6 test case. In previous releases the wrong port map instance was configured by CDRouter. [sc14446]

  • USP: The default value of the testvars uspControllerVerifyRecordIntegrity and uspControllerUseNonPayloadProtection has been changed from yes to no. [sc12051]

  • USP: In tests that add a secondary USP controller, a Device.LocalAgent.MTP instance is now configured for the new controller. [sc14125]

  • USP: CDRouter’s protobuf parser has been re-factored. This leads to significant improvements in large message parsing times and a reduction in test durations in many scenarios. [sc14185]

  • USP: The NotifRetry field in the Set message in usp_conformance_1_59 has been removed since it is not needed. [sc14339]

  • USP: The usp_conformance_1_64 and usp_conformance_1_65 tests have been updated to abort early if the Agent does not support TraceRoute functionality. [sc14402]

  • USP: All USP permissions tests in the usp_conformance (tests 2.11 through 2.21) have been updated to abort and fail if the AssignedRole parameter exists but is empty. Likewise, if the AssignedRole parameter exists but is not empty, the tests will attempt to add a new Permission to the existing role. [sc14404]

  • USP: The usp_conformance_1_69 test case been removed since it has been obsoleted by the Broadband Forum. [sc14429]

  • USP: All USP Profile set tests with no writable parameters have been removed. [sc14443]

  • USP: The usp_conformance_7_2 test has been updated to set the WebSocket ws-extension header. [sc14445]

Notices

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Config upgrades: CDRouter 12.22 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.22 testvars using the config upgrade utility.

CDRouter 12.21

November 18, 2021

New Features

  • NTA1000: All NTA1000v7 systems are now eligible for an operating system upgrade from CentOS 8 to Rocky Linux 8. Please see our Rebuild System Drive guide for more information.

Change Log

  • CDRouter: CDRouter’s wireless LAN clients are now able to connect to hidden SSIDs. To test with hidden SSIDs, simply enable this feature within the DUT. No additional configuration is required within CDRouter. [sc12730]

  • Performance: Resolved a regression in CDRouter’s IPv4 performance tests that was introduced in CDRouter 12.20. This regression only impacts configurations where the testvar perfWanMac is set to the new default value of auto.

    We recommend that all customers running performance tests set the testvar perfWanMac to a fixed value to avoid potential MAC address conflicts:

      testvar perfWanMac b0:75:0c:dd:83:eb

    Additional changes related to MAC address assignments will be made in future releases. This work is needed to enable exciting new features that will be available in 2022. [sc14178]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9871. [sc14109]

  • TR-069: Resolved an issue with the performance web server used in the tr143_http test module that would prevent IPv6 tests in this module from starting up properly if they were run after any IPv4 tests in this module. [sc13399]

  • TR-069: The Device.IP.Diagnostics.IPPing.ProtocolVersion parameter is now explicitly set to a value of IPv4 or IPv6 as needed in the tr69_diagnostics test module. Previously, this parameter was not set, which could lead to unexpected behavior. [sc13849]

  • TR-069: Added warning messages to the tr69_diagnostics test module if the DUT does not support the Device.IP.Diagnostics.IPPing.ProtocolVersion parameter. [sc13851]

  • TR-069: The SetParameterValues variants of the profile verification tests (tests that end in _spv_5) have been removed for all profiles that do not have any writable parameters. This equates to the removal of 89 TR-069 profile tests in this release. [sc14264]

  • TR-069: The SetParameterValues variants of the profile verification tests (tests that end in _spv_5) will now fail if the DUT does not return any writable parameters in the initial GetParameterValues RPC issued by the ACS. [sc14264]

  • USP: Removed unnecessary pause commands from the usp_22 and usp_23 test cases and fixed a false pass scenario when testvar uspNotificationParamManualChange is set to yes. The default value of this testvar has also been changed to no. [sc13474]

  • USP: The USP profile verification tests will now fail if the EUT responds to any Get message with a GetResponse containing an inner error. [sc13796]

  • USP: Updated the WebSocket tests in the usp_conformance test module to better support all possible controller and agent client/server configurations. [sc13689]

  • USP: The Set variants of the profile verification tests (tests that end in _set_2) will now fail if the DUT does not return any writable parameters in the initial Get. [sc14264]

  • USP: The DTLS certificates used by the USP controller when acting as the CoAP client now respect the uspControllerMTPCertPath testvar. [sc13846]

  • USP: The usp_conformance_6_6, usp_conformance_6_7, and usp_conformance_6_10 test cases have been updated to use Device.LocalAgent.MTP.{I}.STOMP.DestinationFromServer to find the correct connection instead. [sc14131]

  • USP: The MQTT subscribe-topic property has been implemented. This property is required in certain USP conformance test cases, such as usp_conformance_9_9. [sc14123]

  • USP: Resolved a potential fatal error in CoAPS sessions that are not successfully established. [sc14159]

  • USP: The SetParameterValues variants of the profile verification tests (tests that end in _spv_5) have been removed for all profiles that do not have any writable parameters. This equates to the removal of 61 USP profile tests in this release. [sc14264]

  • USP: The usp_conformance_7_3 test has been removed.

  • USP: Updated the usp_conformance_7_8 test case to allow the DUT to reconnect gracefully at the end of the procedure. [sc14405]

Notices

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.21. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.21 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.21 testvars using the config upgrade utility.

CDRouter 12.20

October 21, 2021

New Features

  • TR-069: Sixteen (16) new bulk data test cases have been added to the tr69_annex_n test module. These new tests add coverage for ParameterPerColumn formatted CSV data and NameValuePair formatted JSON data. Descriptions for all tests in this module may be found here. [sc13341]

  • USP: Note for customers testing USP/TR-369: Version 1.1 of the official Broadband Forum test specification, TP-469, is scheduled for release later this year. It includes some fixes to the test metrics as well as new test cases. We are incorporating the upcoming changes now, and will make them available via an engineering build to USP expansion owners who want to test against the new plan. Please contact us if you would like to install this engineering build.

Change Log

  • CDRouter: MAC addresses for various stacks will be dynamically configured by CDRouter by default and in future releases. The testvar cdrouterOui may be used to set the OUI for all MAC addresses dynamically created by CDRouter. [sc13609]

    Additional changes related to MAC address assignments will be made in future releases. This work is needed to enable exciting new features that will be available in 2022.

    We recommend that all customers running performance tests set the testvar perfWanMac to a fixed value to avoid potential MAC address conflicts:

    testvar perfWanMac b0:75:0c:dd:83:eb

  • CDRouter: Fixed a few memory leaks within binaries that are linked to by CDRouter. [sc12107]

  • CDRouter: The wifi_10 test case has been updated with improved logging and support for WPA3 “transition mode”. [sc12141]

  • CDRouter: Resolved an issue in the web API when editing the testlist for a test package. In previous releases, testlists containing quoted test case names would corrupt the database preventing any further test package related operations. The web API will now treat any quoted test case names in a testlist as unknown tests. If you have experienced this issue and would like assistance, please contact support@qacafe.com. [sc13755]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9851. [sc13483]

  • TR-069: Updated many TR-069 tests to automatically force all wireless clients to reconnect in the event the DUT reboots. [sc12121]

  • TR-069: The tr69_annex_n test module has been updated to handle escaped control characters in CSV formatted data. [sc13419]

  • USP: Resolved an issue in the usp_8 and usp_9 test cases which were not using the correct testvars uspValidSearchPathResultParam and uspValidSearchPathResultValue. [sc13668]

  • USP: The default value of the testvar uspValidSearchPath has been updated to be a partial path. [sc13668]

  • USP: Added support for handling error messages mid-block transfer in with CoAP MTP. [sc13932]

Notices

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.20. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.20 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.20 testvars using the config upgrade utility.

CDRouter 12.19

September 23, 2021

Change Log

  • CDRouter: The dmz test module is not compatible with wireless LAN interfaces and will now be automatically skipped if no Ethernet LAN interfaces are defined in the config file. [ch12116]

  • CDRouter: The cdrouter_dmz_110 test case now primes the ARP cache of the DUT before verifying that pings from the WAN are forwarded to the DMZ host on the LAN. [ch12116]

  • CDRouter: CDRouter’s web server no longer supports TLS 1.0/1.1 and now receives an A+ rating when tested with the SSL Server Test from Qualys SSL Labs. [ch12900]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9830. [ch12527]

  • TR-069: CDRouter’s connection request logic for CWMP has been refactored to resolve an issue with connection request retries when the testvars are acsDelayCpeAttempts and acsNumberCpeAttempts are configured. [ch11311]

  • TR-069: The tp181_test_5.2.4 and tp181_test_5.2.5 test cases now include a filename in the Upload RPC that is issued by the ACS. [ch11438]

  • TR-069: Various log messages in the tp181_test_5.2.4 and tp181_test_5.2.5 test cases has been updated and improved for clarity. [ch11438]

  • TR-069: The accuracy of the FTP and HTTP received bytes has been improved in the tp181_test_5.2.4 and tp181_test_5.2.5 test cases. [ch11438]

  • TR-069: The tr69_diagnostics_201 through tr69_diagnostics_220 tests require Device:2 root data model support and will now be automatically skipped if the DUT supports the InternetGatewayDevice:1 root data model. [ch12881]

  • TR-069: Resolved a fatal error in the tp181_test_5.2.7 and tp181_test_5.4.9 when the testvar wanMode is set to a value of static. [ch12906]

  • TR-069: All tests in the tr69_diagnostics module have been updated to properly handle DiagnosticsState values of Complete or Completed based on the data model version supported by the DUT. [ch12907]

  • USP: The usp_scenario_1 test case is now automatically skipped if the testvar uspScenarioPath is not enabled or if the file or scenario that it specifies is invalid. [ch12509]

  • USP: The secondary controller in the usp_conformance_2_9 test case no longer uses TLS. This change avoids any trust issues that may be due to TLS which would lead to a false negative result. [ch13243]

  • USP: A typo of the enum value Anytime has been changed to the correct value AnyTime in the usp_conformance_9_8 test case. [ch13243]

  • USP: Resolved a parsing issue when explicitly specifying the DUT’s data model using the testvar uspSupportedDataModel. [ch13243]

Notices

  • NTA1000 rail kits now available: We now have sliding rack rail kits for NTA1000v6 and NTA1000v7 systems! Please contact support@qacafe.com for more information.

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.19. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.19 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.19 testvars using the config upgrade utility.

CDRouter 12.18

August 26, 2021

Change Log

  • CDRouter: CDRouter’s wireless LAN clients now wait 10 milliseconds after sending a DHCP Release message before deauthenticating from the access point. [ch11546]

  • CDRouter: CDRouter’s internal DNS servers are now case insensitive with when processing received DNS queries. [ch12357]

  • CDRouter: CDRouter’s internal packet processing for TLS data has been updated. This change improves stability in a number of test cases including some in the Top 100 and IPv6 Top 100. [ch12721]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9808. [ch12527]

  • TR-069: Resolved a fatal error in the tp181_test_5.3.1 test case when run with a wireless interface. [ch11447]

  • TR-069: Resolved a fatal error in the od128_test_8.1 through od128_test_8.7 test cases that was introduced in CDRouter 12.16. [ch11994]

  • USP: The testvar uspInactiveFirmwareSlot supports a new value of auto. This value forces CDRouter to use the first inactive firmware slot that is found. For DUTs that do not have a fail-safe/backup firmware image always configured this should make the configuration process easier. CDRouter will do the work of figuring out what slot is viable. This also means that if an agent fails to revert to a previous version additional firmware tests will still run properly. [ch12503]

  • USP: Many minor updates have been made to tests in the usp_conformance module [ch12503]:

    • usp_conformance_2_9: This test now supports controller instances over 9.
    • usp_conformance_3_2, usp_conformance_3_4, usp_conformance_3_6, usp_conformance_3_8, usp_conformance_9_2: These tests no longer shutdown and restart the controller.
    • usp_conformance_3_4: Additional guards have been added to ensure that record integrity checks are in place.
    • usp_30, usp_conformance_9_2, usp_conformance_9_3, usp_conformance_9_4, usp_conformance_9_5, usp_conformance_9_6, usp_conformance_9_7, usp_conformance_9_8: These tests have been updated to use the uspInactiveFirmwareSlot parameter.
    • usp_conformance_4_1: The TransportProtocol for MQTT is now explicitly configured when adding a new client.
    • usp_conformance_6_3: A delay has been added at the end of test to prevent errors with STOMP connections at the beginning of the next test.
    • usp_conformance_6_3: A check has been added to ensure values are returned in the retry parameters.
    • usp_conformance_9_1: A typo that could lead to a fatal error has been fixed in this test.
    • usp_conformance_9_4, usp_conformance_9_5: These tests have been updated to clean up the original downloaded firmware image.
    • usp_conformance_9_7: This test no longer expects an error message from the DUT; it expects an OperateResponse with a cmd_failure.
    • usp_conformance_9_7: The parameter path returned by the DUT is now validated to prevent using a parameter with a missing dot.
    • usp_conformance_9_8: This test now explicitly checks for an error response to either of the operations.
    • usp_conformance_1_58: This test now waits for notifications from the DUT to prevent events from spanning multiple tests.

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.18. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.18 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.18 testvars using the config upgrade utility.

CDRouter 12.17

July 29, 2021

Change Log

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9784. [ch11578]

  • TR-069: Added a IPv4/IPv6 address check to resolve a potential fatal error in the tp181_test_5.4.1 and tp181_test_5.4.3 test cases. [ch11452] [ch11456]

  • TR-069: All chunked encoding headers are now automatically removed by CDRouter during file uploads. [ch11695]

  • USP: The usp_conformance_6_7 and usp_conformance_6_10 test cases require a reboot and will now be automatically skipped unless the testvar cpeRebootMode is set to a value of reboot and the testvar RestartDut is configured. [ch11408]

  • USP: The usp_21, usp_22, usp_23, usp_27, and usp_28 test cases now restore the parameter specified by the testvar uspExternallyChangeableParam to its original value at the end of each test. [ch11408]

  • USP: The usp_conformance_2_9 test case has been updated to ensure consistent behavior across all MTPs. [ch11408]

  • USP: The usp_conformance_6_7 test case has been updated to resolve a potential false negative test result. [ch11408]

  • USP: The usp_conformance_6_10 test case has been updated to reset the Destination parameter on the agent at the end of the test. [ch11408]

  • USP: The certificates used for MQTTS are now configurable using the testvars uspControllerMTPCertPath and uspControllerMTPCaCertPath [ch11774]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.17. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.17 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.17 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.16

July 1, 2021

Change Log

  • CDRouter: The default value of the dhcpClientEnd testvar has been changed. The default LAN DHCP pool size is now much larger which is consistent with the default configuration of most devices. [ch9755]

  • CDRouter: The dns_301 test case and all variants will now automatically abort after five failures. This significantly reduces test test time in failure scenarios. [ch11166]

  • CDRouter: The default value of the lanWirelessMaxClients has been changed from 32 to auto. [ch10191]

  • Multiport: The cdrouter_lan_mp_40, cdrouter_lan_mp_45, ipv6_lan_mp_50 and ipv6_lan_mp_55 test cases have all been updated to send multiple packets during the forwarding portion of the test. These tests now send 10 packets and will pass if 80% or more are received. This improves compatibility hardware acceleration implementations that may drop the first few packets of a multicast stream. [ch11223]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9762. [ch11077]

  • TR-069: Resolved a fatal error condition in the od128_test_8.1, od128_test_8.2, od128_test_8.3, and od128_test_8.4 test cases when run with configurations that have a small free network range size. [ch10495]

  • TR-069: Resolved an issue with the FileType argument in the Download RPC issued by CDRouter’s ACS in the tr69_inactive_firmware_1 test case. [ch11160]

  • USP: Improved support for error messages from the Agent and fixed typos in parameter names in the following tests [ch11024]:

    • usp_conformance_2_15
    • usp_conformance_2_19
    • usp_conformance_2_20
    • usp_conformance_2_21
    • usp_conformance_2_22

  • USP: Updated Target to Targets in parameter names used in the following test cases [ch11024]:

    • usp_conformance_2_11
    • usp_conformance_2_12
    • usp_conformance_2_13
    • usp_conformance_2_14
    • usp_conformance_2_15
    • usp_conformance_2_16
    • usp_conformance_2_17
    • usp_conformance_2_18
    • usp_conformance_2_20

  • USP: Updated the following test cases to correctly set permissions at start of each test case: [ch11027]:

    • usp_conformance_2_11
    • usp_conformance_2_12
    • usp_conformance_2_13
    • usp_conformance_2_14
    • usp_conformance_2_15
    • usp_conformance_2_16
    • usp_conformance_2_19
    • usp_conformance_2_20
    • usp_conformance_2_21

  • USP: Updated the usp_conformance_2_19 test case to get only the PeriodicNotIfInterval parameter and not the entire controller object. [ch11027]

  • USP: Removed trailing single quote in MQTT messages. [ch11157]

  • USP: Removed the double printing of incoming MQTT messages in test logs. [ch11444]

  • USP: Resolved an issue with objects not being cleaned up in STOMP and MQTT testing. [ch11027]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.16. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.16 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.16 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.15

June 3, 2021

New Features

  • Multiport: Four new multi-client multicast tests have been added to this release. Please see cdrouter_lan_mp_40 and cdrouter_lan_mp_45 in the lan-mp test module, and the IPv6 versions of the same two tests ipv6_lan_mp_50 and ipv6_lan_mp_55 in the lan-mp-v6 test module for more information. [ch1887]

Change Log

  • CDRouter: Resolved a filtering bug on the logdir index page within the web UI. [ch10573]

  • IPv6: Improved the skip reason that is displayed when the testvar supportsIPv6 is disabled or set to a value of no. [ch9975]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9741. [ch10662]

  • TR-069: In previous releases the entire tp181 test module would be skipped if the testvar lanInterface was set to a value of none. This constraint has been relaxed. Now only the tests in this module that actually require a LAN interface will be skipped if one is not configured. [ch11034]

  • USP: Resolved an issue associated with starting up the secondary controller in the usp_conformance_2_9 test case. [ch10761]

  • USP: Resolved an issue in the usp_27 test case in which notifications were not enabled and disabled at the correct time leading to failures. [ch10889]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.15. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.15 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.15 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.14

May 6, 2021

New Features

  • CDRouter: A new DHCP client test case been added to this release. This test verifies that the DUT’s DHCP client on the WAN learns a new DHCP server if the primary DHCP server becomes unresponsive. Please see cdrouter_dhcp_70 in the dhcp-c module for more information. [ch10029]

  • Performance: Two new test modules have been added to this release:

    Test Module Address Family Number of Tests Description
    fixed-rate-perf-2-5 IPv4 308 IPv4 fixed rate performance tests, 1 to 2.5 Gbps
    fixed-rate-perf-2-5-v6 IPv6 308 IPv6 fixed rate performance tests. 1 to 2.5 Gbps

    These modules add fixed rate performance tests for target bandwidths between 1 and 2.5 Gbps. [ch9996]

Change Log

  • CDRouter: A new metric has been added to many of CDRouter’s EAPOL test cases. CDRouter’s wireless LAN clients will now actively fail if an EAP failure does not result in an 802.11 deauthentication event by the DUT’s access point. This change impacts tests that verify EAP failure conditions in the eap-radius, eapol, and eap-tls modules. [ch9130]

  • CDRouter: The default config template has been lightly reorganized for ease of use. [ch9402]

  • CDRouter: CDRouter’s LAN clients may now be configured to include DHCP option 0 using the testvar dhcpClientOptionCode. [ch9803]

  • CDRouter: Resolved a fatal error when enabling protected management frames (PMF) for WPA in certain configurations. [ch9851]

  • CDRouter: Resolved an issue with the Config Upgrade utility included with CDRouter releases 12.7 through 12.13. In these releases the Config Upgrade utility would add a Miscellaneous Testvars section for additional multiport interface configurations that would generate a config check error. [ch10072]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9719. [ch10108]

  • TR-069: Resolved a potential fatal error condition in the tr69_410 test case. [ch9953]

  • TR-069: Updated all HTTPS tests in the tr69_annex_n test module to use properly formatted URLs with an FQDN rather than an IP address when configuring the bulk data transfer on the DUT. [ch10031]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.14. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.14 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.14 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.13

April 8, 2021

Change Log

  • CDRouter: All warning log messages (highlighted in yellow) are now hidden if the Pass/Fail Only or Packets Only log filters are selected. This change cleans up the log viewer within the web UI and makes it easier to parse log output via the web API. [ch8719]

  • CDRouter: The wifi_10 test case has been updated to ensure that the LAN interface in use supports all of the modes and ciphers advertised by the DUT prior to validating them. Any modes and ciphers that are not supported by the LAN interface will be skipped and highlighted in the log. [ch9352]

  • CDRouter: The behavior of the testvar RestartDut has been modified. This testvar now defaults to the value none. When set to none, CDRouter begins the test run without executing any program or script and without displaying a manual restart prompt.

    This testvar can also be set to the value prompt to restore the previous default behavior of displaying a restart prompt at the start of each test run. Any other value is interpreted as a script or program to be executed at the start of the test run.

    Please see our knowledge base for more information. [ch9543]

  • HomeKit: Resolved an issue in which the HomeKit port scans were not respecting the expected closed ports defined in the config file. [ch9883]

  • IPv6: Additional constraints have been added to the testvar ipv6LanSubnetId to ensure that the configured value does not exceed the number of available subnet bits. [ch8664]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9698. [ch9665]

  • USP: Resolved a race condition associated with unencrypted MQTT MTP in the usp_30 test case. [ch9604]

  • USP: The usp_conformance_4_1 test case has been updated to send a properly formatted SendOnBoardRequest() command. Previously this test sent the command SendOnboardRequest() with a lower case b, which is invalid. [ch9608]

  • USP: The usp_conformance_4_1 test case has been updated to fully support TLSv1.3 MTP layer encryption. [ch9608]

  • USP: The usp_conformance_9_4 and usp_conformance_9_5 test cases have been updated to wait for both Boot! and OperationComplete events. [ch9611]

  • USP: The usp_conformance_9_9 test case has been updated to create and fully configure a new STOMP server at the start of the test. [ch9613]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.13. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.13 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.13 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.12

March 11, 2021

New Features

  • BBF.069: The BBF.069 expansion has been updated to Release 9.2 of the BBF.069 scripts from the UNH-IOL. Refer to the change log section below for details on the updates included in this release. [ch7395]

  • CDRouter: A new test case, cdrouter_dhcp_50, has been added to the dhcp-c test module. This test verifies that a DHCP client implements the exponential backoff algorithm for message retransmission as described in Section 4.1 of RFC 2131. [ch8718]

  • CDRouter: A new test case, cdrouter_dhcp_60, has been added to the dhcp-c test module. This test verifies that a DHCP client is able to obtain a lease when server responses are delayed. The delay is configurable using the new testvar dhcpServerResponseDelay. [ch9015]

  • TR-069: The CWMP Scenario Testing feature has been updated to allow the ACS to initiate file downloads and uploads with the DUT. The following new commands can now be included in custom CWMP Scenario test scripts: Download, Upload, TransferComplete. These commands allow users to test and verify downloads of arbitrary firmware or config files to the DUT, as well as uploads of current config settings and log files. File transfers to servers outside the CDRouter test setup are also supported with the CDRouter Security and ICS expansion. See the TR-069 User Guide for documentation and examples. [ch8071]

Change Log

  • BBF.069: The 5_105_default_active_notification_throttle test has been updated to use the bbf069ActiveParam, bbf069ActiveParamType, and bbf069ActiveParamValue testvars.

  • BBF.069: The 5_039_QOP_authentication test requires the digest qop-auth option and will now always enable this option when the test is run, regardless of the setting of the acsDigestQopAuth testvar.

  • BBF.069: Resolved potential fatal errors in the 5_098_inform_ip_address_change and 5_110_BPC test cases.

  • BBF.069: Resolved a failure in the 5_010_Multiple_TCP_conn when run from the command line.

  • BBF.069: The reboot timeout in all BBF.069 test cases is now configurable using the testvar tr69RebootTimeout. Previously this timeout was hard-coded to 60 seconds.

  • BBF.069: The 5_027_session_cookies_transactions was updated to improve Thumbs parsing of session cookies to prevent false failures.

  • CDRouter: Resolved an error in the cdrouter_dhcp_2 test case when the testvar dhcpLeaseTime was set to the maximum value of 4294967 seconds. Note that this fix applies to many other tests in the dhcp-c test module as well. [ch8951]

  • IPv6: The icmpv6_32 test case is now automatically skipped in routed WAN configurations. [ch8726]

  • IPv6: The mapt_42 test case has been updated to send bi-directional UDP traffic prior to each ICMPv4 Destination Unreachable messages that is validated within the test. This change is more realistic and allows the DUT to properly mark and track the connections associated with each ICMPv4 Destination Unreachable message. [ch8943]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9673. [ch9104]

  • TR-069: The CWMP Scenario Testing feature now supports a DelaySeconds command to specify a pause in the scenario script for a set number of seconds. This complements the existing “Delay” command, which specifies a pause in milliseconds. [ch8071]

  • TR-069: The Event command in the CWMP Scenario Testing feature now allows scenario scripts to verify more than one EventCode in the same Inform message received from the DUT. [ch8416]

  • TR-069: Removed an unnecessary reboot from the tr69_wireless_42 test case. [ch9011]

  • USP: All USP tests that verify or wait for notifications now have a configurable timeout defined by the new testvar uspNotificationTimeout. Previously these timeouts were hardcoded to 30 seconds. [ch8744]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.12. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.12 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.12 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.11

February 11, 2021

New Features

  • BBF.069: All BBF.069 tests are now distributed in plaintext. [ch8667]

  • CDRouter: CDRouter now supports wireless channel hopping which is a feature that enables frequency agility through dynamic channel selection within 802.11 access points.

    Channel hopping allows an access point to automatically reconfigure itself and hop to a different wireless channel if:

    • There is excessive interference, congestion, or latency on the current channel
    • Radar is detected (this is required for DFS regulatory compliance)

    Support for channel hopping is enabled by default and requires no additional configuration. If all of CDRouter’s wireless LAN clients are disassociated by the DUT during a test run the primary client will now automatically rescan and attempt to locate the DUT by SSID. If the DUT has changed channels CDRouter’s LAN clients will follow and attempt to re-associate on the new channel.

    Rescanning occurs between test cases only. As a result, a channel hopping event may produce a failure within the test case in which it occurred. The lanChannel and lanBSSID testvars can be used to restrict the movement of CDRouter’s wireless LAN clients if needed. [ch4566]

  • TR-069: CDRouter’s XMPP configuration has been enhanced. When XMPP is enabled, the ACS can now configure the DUT to connect to the XMPP Server using a static “ServerTable” entry, or through a standard DNS request. These options augment the preferred default method of discovering the XMPP server through a DNS-SRV record request. See the XMPP Connection Requests section of the TR-069 User Guide for configuration details. [ch8069]

Change Log

  • CDRouter: The testvar wirelessForceReconnect has been obsoleted and removed from the default config file. CDRouter’s wireless LAN clients will now only re-associate (if needed) between test cases, not within them. [ch4566]

  • CDRouter: SCTP (IP protocol type 132) has been removed from the default list of IP protocol types that is verified in the cdrouter_dmz_200 test case. [ch8121]

  • CDRouter: The dns_500 test case and all variants have been updated to support query resolution over either IPv4 or IPv6 on the WAN in dual-stack configurations. [ch9050]

  • IPv6: The jumbo-v6 module is now automatically skipped if IPv6 is not enabled. [ch9046]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9652. [ch8801]

  • TR-069: Fixed a 550 file does not exist error in the tp181_test_5.2.3 test case. [ch8061]

  • TR-069: Resolved a potential fatal error in the tp181_test_5.2.6 test case. [ch8397]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.11. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.11 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.11 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.10

January 14, 2021

New Features

  • CDRouter: Four new RDK specific test lists have been added to CDRouter! These test lists make it possible to quickly and easily replicate the quarterly RDK-B release validation testing performed by the RDK group using CDRouter. For more information on RDK-B testing with CDRouter, please contact support@qacafe.com. [ch7835]

  • TR-069: Two new tests, 5.1.11 and 5.1.12, have been added to the Broadband Forum TP-181 module. These tests verify vendor specific parameter functionality, and are the only tests that were omitted from the original implementation of this test plan within CDRouter. [ch8361]

    These tests operate on the list of vendor defined parameters specified by the new testvar cwmpVendorSpecificParams. Here is a simple example:

    testvar cwmpVendorSpecificParams         {
    { Device.X_VENDOR_SyslogCfg.ServerIPAddress string { 3.3.3.3 3.3.3.4 } }
}

  • TR-069 & USP: CDRouter now supports the Broadband Forum’s recently published Device:2.14 data model! This update adds 12 CWMP tests and 8 USP tests for the new AccessControl and IPLayerCapacity profiles. In addition the VoiceService:2 data model and associated profile tests have been updated. [ch7834]

Change Log

  • CDRouter: The DNS failover tests dns_45 and dns_46 (and all variants) have been re-factored for compatibility with current DNS proxy implementations. [ch7237]

    Most modern DNS proxies maintain a list of DNS servers and may use any or all of them at any point in time to resolve queries. What the DUT considers its primary DNS server may or may not be what is listed as the primary DNS server in CDRouter’s config file. Furthermore, the DUT’s primary DNS server may change over time as tests are run.

    These tests now attempt to detect the primary DNS server in use by the DUT before the failover behavior of each error code is verified. The new test procedure is:

    • For each error code that is tested, send three, valid DNS queries from a LAN client.
    • Determine which WAN DNS server(s) receive these queries.
    • If the same WAN DNS server receives all three queries, mark this server logically within CDRouter as the DUT’s primary DNS server.
    • If the queries are received by different WAN DNS servers, abort, since there is no way for CDRouter to predict the DUT’s behavior regarding DNS.
    • For a specific error code, set the auto-detected primary DNS server to return the error code and verify that the DUT does or does not send another query to one of the other backup WAN DNS servers.
    • Repeat the above steps for all DNS error codes.

  • CDRouter: Fixed a CDRouter startup error when running on systems that have been upgraded to CentOS 8.3. [ch8636]

  • CDRouter: Fixed a possible fatal error in the cdrouter_dyndns_1 test case. [ch8728]

  • Performance: The multi-client performance tests and logging have been re-factored to resolve a potential fatal error in certain configurations. [ch6912]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9623. [ch8245]

  • TR-069: Test procedures and test metrics have been added to all tests in the tp181 test module. [ch7295]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.10. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.10 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.10 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

CDRouter 12.9

December 3, 2020

This release adds a number of IPv6 test cases to the Apple HomeKit expansion and addresses a few smaller issues, particularly in the TR-069 expansion.

New Features

  • HomeKit: IPv6 support has been added to the Apple HomeKit expansion! Please see the homekit-v6 test module for more information. [ch7274]

Change Log

  • CDRouter: Support for infinite DHCP / DHCPv6 lease times on the WAN has been removed. [ch7652]

  • CDRouter: A number of dead links to older release notes in the config file template and testvar documentation have been fixed. [ch7846]

  • DOCSIS: An invalid reference to the DOCSIS 3.0 MULPI specification has been removed from the docsis_firewall_1, docsis_firewall_2, ipv6_docsis_firewall_1, and ipv6_docsis_firewall_2 test cases. [ch7850]

  • NTA1000: A new system update is available for NTA1000v7 systems running CentOS 8. This provides a new custom kernel and wireless firmware, as well as a few other enhancements. These updates can be applied by following the instructions here. [ch7562] [ch7567]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9604. [ch7739]

  • TR-069: The Broadband Forum has changed the name of the IR-181 test specification to TP-181. For consistency with the the Broadband Forum, the name of CDRouter’s ir181 module and all included tests have been updated to reference TP-181 instead of IR-181. Aliases for the original module and test names have been added to ensure that all existing test packages will continue to run without interruption. [ch6101]

  • TR-069: Resolved a fatal error associated with DST conversions in the ir181_test_5.1.2 and tr69_410 test cases. [ch7721]

  • USP: The maximum amount of time CDRouter will wait, in seconds, for a device to fully reboot when triggered during USP tests is now configurable using the new testvar uspRebootTimeout. Previously all USP related reboot timeouts were hard coded to 120 seconds. [ch7219]

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.9. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.9 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.9 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

  • Ruby gem deprecation: The CDRouter Ruby gem wrapper for CDRouter’s web API has been deprecated and is no longer supported. All scripts using this gem should be updated to use Python 3 and the cdrouter.py package instead.

CDRouter 12.8

November 5, 2020

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.8. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.8 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.8 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

  • Ruby gem deprecation: The CDRouter Ruby gem wrapper for CDRouter’s web API has been deprecated and is no longer supported. All scripts using this gem should be updated to use Python 3 and the cdrouter.py package instead.

New Features

  • Performance: Two new test modules have been added to this release:

    Test Module Address Family Number of Tests Description
    fixed-rate-perf IPv4 192 IPv4 fixed rate performance tests
    fixed-rate-perf-v6 IPv6 192 IPv6 fixed rate performance tests

    These test modules focus on fixed rate performance testing. Fixed rate performance tests set the transmit bandwidth (or rate) and the threshold to hard-coded values that are defined by the test case. This is in contrast to CDRouter’s existing configured rate performance tests, which instead rely on the transmit bandwidth/rate and thresholds that are defined by the user in the config file.

    Fixed rate performance tests require no additional configuration, are easy to interpret, are interface agnostic, and allow multiple rates to be verified in a single test run. Please see the Performance User Guide for more information. [ch6357]

  • USP: The usp_conformance test module has been updated to reflect the changes in version 1.0.3 of the Conformance Test Plan for User Services Platform Agents as defined in Broadband Forum TP-469 Issue 1 Corrigendum 3.

    More information on how to use the CDRouter USP Expansion to perform self-testing certification can be found here.

Change Log

  • CDRouter: In previous releases the cdrouter_dhcp_server_700 test case was not being properly skipped when the testvar dhcpInform was set to a value of no. This bug has been fixed. [ch7051]

  • CDRouter: Resolved a routing issue in the cdrouter_dmz_1 test case. [ch7396]

  • DOCSIS: The primary DHCP and DHCPv6 servers on the WAN will now ignore DHCP/DHCPv6 messages from DOCSIS clients if DOCSIS is disabled. [ch6440]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9583. [ch7415]

  • TR-069: The tr69_27 test case has been updated to support more specific vendor defined CWMP fault codes in the range 9800-9899. [ch6188]

  • TR-069: Resolved an issue with the cwmp_scenario_1 test case when calling the Reboot RPC from within a CWMP scenario. Prior to this release, the Reboot RPC would be issued with a CommandKey greater than 32 bytes which would generate a CWMP fault in some implementations. This release ensures that the CommandKey for Reboot RPC calls is always less than 32 bytes. [ch7620]

  • USP: Added a guard to prevent a possible fatal error in the usp_conformance_3_12 test case.[ch7553]

  • USP: The following USP conformance tests require DHCP and will now be automatically skipped if DHCP is not enabled. [ch7699]

    • usp_conformance_8_1
    • usp_conformance_8_2
    • usp_conformance_8_3
    • usp_conformance_8_4

CDRouter 12.7

October 8, 2020

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.7. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.7 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.7 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

  • Ruby gem deprecation: The CDRouter Ruby gem wrapper for CDRouter’s web API has been deprecated and is no longer supported. All scripts using this gem should be updated to use Python 3 and the cdrouter.py package instead.

New Features

  • CDRouter: AP mode in the 5 GHz band is now supported on ath9k based wireless cards. [ch7281]

  • Multiport: The testvar dutMgmtPort now accepts a list of ports which are verified in the guest_30 and ipv6_guest_30 test cases. [ch6426]

Change Log

  • CDRouter: The list of expansions in CDRouter’s default configuration file have been re-organized to improve navigation. [ch7138]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9562. [ch6673]

  • TR-069: Resolved a bug associated with the testvar acsCreatePortMapOnIGD when used with devices supporting the Device:2 root data model. [ch6186]

  • TR-069: Cleaned up an XML encoding bug in the SetParameterValues CWMP data model verification tests. Specifically, CWMP parameters with complex types of IPv4Address, IPv6Address, IPv4Prefix, IPv6Prefix, and Alias were transmitted with the complex type rather than the base type. [ch7220]

CDRouter 12.6

September 10, 2020

Notices

  • Important installation notes: If you are upgrading from CDRouter 11.x or earlier versions, all prerequisites listed in the CDRouter 12.0 Release Notes must be met prior to upgrading to CDRouter 12.6. Please contact support@qacafe.com for assistance if needed.

  • Config upgrades: CDRouter 12.6 includes many new features and configuration testvars. Config files may be easily upgraded to include all new CDRouter 12.6 testvars using the config upgrade utility.

  • Python 2 deprecation: Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

  • Ruby gem deprecation: The CDRouter Ruby gem wrapper for CDRouter’s web API has been deprecated and is no longer supported. All scripts using this gem should be updated to use Python 3 and the cdrouter.py package instead.

New Features

  • DOCSIS: The DOCSIS DHCP and DHCPv6 servers now support the configuration of custom options using the following new testvars: [ch6147]

  • Multiport: Seven new guest network tests have been added. These tests are designed to verify that two clients connected to the same guest network are fully isolated and cannot communicate with each other. [ch5254]

    New Test Cases Module Description
    guest_40 guest Verify ARP traffic is not leaked on the guest network
    guest_42 guest Verify unicast traffic is not leaked on the guest network
    guest_44 guest Verify broadcast traffic is not leaked on the guest network
    guest_46 guest Verify multicast traffic is not leaked on the guest network
    ipv6_guest_40 guest-v6 Verify IPv6 neighbor discovery traffic is not leaked on the guest network
    ipv6_guest_42 guest-v6 Verify IPv6 unicast traffic is not leaked on the guest network
    ipvs_guest_46 guest-v6 Verify IPv6 multicast traffic is not leaked on the guest network

Change Log

  • Apple HomeKit: Logging in all port scans has been quieted to reduce the size of logs files. A summary is printed at the end of every port scan indicating which ports were open, closed, or stealth. [ch6345]

  • BBF.069: Resolved a potential fatal error in the 5_110_BPC test case. [ch6478]

  • CDRouter: Added additional checks to a prevent a fatal error when running the scaling tests in certain configurations. [ch5831]

  • Security: The ET Open ruleset shipped with the CDRouter Security expansion has been updated to version 9545. [ch6362]

  • TR-069: The tr69_wireless_50 test case now verifies all 20 MHz WiFi channels supported by the DUT. [ch4178]

  • USP: The USP notification timeout is now configurable and is set to the same value as the USP message timeout using the testvar uspMessageTimeout. [ch6223]

  • Web API: A new jenkins.py script has been added to the /examples subdirectory of the cdrouter.py project. This script replicates the functionality that had been provided by the now deprecated CDRouter Ruby gem. Please see the updated “Using CDRouter with Jenkins” article in our Knowledge Base for an explanation of this new python script. [ch6428]

CDRouter 12.5

August 13, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.5. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.5 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.5 testvars using the config upgrade utility.

Python 2 Deprecation

Support for Python 2 within cdrouter.py has been deprecated and will be removed in a future release of CDRouter. All scripts using cdrouter.py should be updated to use Python 3, which is fully supported.

New Features and Enhancements

aliases: - /cdrouter/release-notes/cdrouter-12-5-release-notes/

CDRouter TR-069

  • New HTTP 301 redirect test cases

    Four new test cases for verifying that the DUT properly follows HTTP 301 redirects have been added to the tr69 test module. These new tests are clones of the existing HTTP 302 and 307 redirect tests. [ch5915]

    Note that while HTTP 301 redirects indicate that the resource has been moved permanently, Section 3.4.2 of TR-069 Amendment 6 states that all redirects, apply only for remainder of the current session:

    If the CPE is redirected, the redirected URL MUST apply only to the
remainder of the current Session or until a subsequent redirect occurs
later  in  the  same  Session. The redirected URL MUST NOT be saved by the
CPE (i.e. as the value of Management-Server.URL, as defined in [27],
[34] , and [35]) for use in any subsequent Session or any subsequent retries
of the Session.  This requirement MUST hold even if the 301 (Moved
Permanently) HTTP status code is used for redirection.

Testvar Updates

Testvars added to this release:

  • None.

Testvars modified or removed in this release:

New Test Modules and Test Cases

aliases: - /cdrouter/release-notes/cdrouter-12-5-release-notes/

CDRouter TR-069

  • New HTTP 301 redirect test cases for TR-069

    TEST: tr69_41
MODULE: tr69
DESCRIPTION: Verify CPE follows 301 redirects to new ACS server

    TEST: tr69_42
MODULE: tr69
DESCRIPTION: Verify CPE follows multiple 301 redirects to ACS server

    TEST: tr69_43
MODULE: tr69
DESCRIPTION: Verify CPE follows 301 redirects to new ACS server with a specified port number

    TEST: tr69_44
MODULE: tr69
DESCRIPTION: Verify CWMP session can be redirected from HTTP to HTTPS using 301

Notes

CDRouter TR-069

  • The tr69_wireless module and the related WiFi tests in the ir181 module have been updated to support configurations that include multiple LAN interfaces. [ch4017]

  • Fixed a bad log message in the tr69_37 test case. [ch5947]

CDRouter USP

  • Fixed a typo in the default value of the testvar uspObject2. [ch6413]

CDRouter Security

  • Updated the ET Open ruleset shipped with the CDRouter Security expansion to version 9524. [ch5979]

CDRouter 12.4

July 16, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.4. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.4 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.4 testvars using the config upgrade utility.

New Features and Enhancements

CDRouter USP

  • Updates to the conformance test plan for USP agents

    The usp_conformance test module has been updated to reflect the changes in version 1.0.2 of the Conformance Test Plan for User Services Platform Agents as defined in Broadband Forum TP-469 Issue 1 Corrigendum 2. [ch5495]

    More information on how to use the CDRouter USP Expansion to perform self-testing certification can be found here.

Testvar Updates

Testvars Added to This Release

  • None.

Testvars Modified or Removed in This Release

  • None.

New Test Modules and Test Cases

CDRouter

  • New Apple HomeKit tests

    TEST: homekit_TCSR015
MODULE: homekit
DESCRIPTION: HomeKit Test TCSR015

    TEST: homekit_TCSR027
MODULE: homekit
DESCRIPTION: HomeKit Test TCSR027

    TEST: homekit_TCSR028
MODULE: homekit
DESCRIPTION: HomeKit Test TCSR028

Notes

CDRouter TR-069

  • The acs.cdroutertest.com-ca.pem file has been updated to remove an expired intermediate CA. The default ACS and ACS download server certificate chains now contain only one intermediate CA. [ch5573]

  • The acs.qacafe.com certificate chain is now expired and has been removed [ch5621].

  • An alternate SHA1 certificate chain for acs.cdroutertest.com and acs-download.cdroutertest.com is now available on the support site. This may be needed for older legacy devices that do not support the current SHA384 certificate chain that is shipped with CDRouter. [ch5579]

  • The tr143_http module does not require a LAN interface and can now be run in configurations that have only a WAN interface defined. [ch3053]

  • Tests od128_test_8.1 through od128_test_7 have been updated to check the Device.DeviceInfo.SoftwareVersion parameter at the end of the test to verify that the DUT is running the new firmware image. The tr69DownloadImageVersion testvar should be properly set to match the version of the new firmware. These tests have also been updated to optionally reinstall the original firmware on the DUT at the end of the test. The tr69DownloadImageVersion testvar must be set to the path of the original firmware image in order for this to occur. [ch4904]

  • The tr143_http module has been updated to resolve an issue in PPPoE over IPv6 WAN configurations. [ch4452]

CDRouter Security

  • Updated the ET Open ruleset shipped with the CDRouter Security expansion to version 9496. [ch5541]

CDRouter USP

  • The wildcard.cdroutertest.com-ca.pem file has been updated to remove an expired intermediate CA. The default USP controller server certificate chain now contain only one intermediate CA. [ch5573]

  • The USP firmware download tests have been improved. This change impacts test cases usp_conformance_9_3 through usp_conformance_9_7 and usp_30. [ch5909]

CDRouter Performance

  • The version of iPerf shipped with CDRouter has been updated to 3.8.1. [ch4926]

CDRouter SNMP

  • The snmp_301, snmp_wan_301, ipv6_snmp_301, and ipv6_snmp_wan_301 test cases have been updated. A new step has been added to the test procedure. These tests now verify that a good community string can be walked before attempting to walk a bad community string. [ch5109]

CDRouter DOCSIS

  • The snmp_docsis_301 and ipv6_snmp_docsis_301 test cases have been updated. A new step has been added to the test procedure. These tests now verify that a good community string can be walked before attempting to walk a bad community string. [ch5109]

Apple HomeKit

  • Various tests in the homekit module have been improved. [ch5567]

CDRouter 12.3

June 18, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.3. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.3 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.3 testvars using the config upgrade utility.

New Features and Enhancements

Apple HomeKit

  • New HomeKit expansion for CDRouter!

    The HomeKit expansion for CDRouter provides fully automated testing of the Apple HomeKit-enabled Router Certification Test Plan. For more information, please contact sales@qacafe.com.

CDRouter

  • The Top 100 test list has been updated!

    All FTP and TFTP related test cases have been removed from the Top 100 test list in favor of more HTTP and HTTPS test cases. This change was made because FTP and TFTP are less relevant today and not as widely used as HTTP and HTTPS. In addition, three basic LAN side ARP test cases have been added.

    The table below summarizes the changes to the Top 100:

    Test Cases Removed Test Cases Added
    cdrouter_basic_1 arp_1
    cdrouter_app_2 arp_2
    cdrouter_app_3 arp_3
    cdrouter_app_10 cdrouter_http_300
    cdrouter_app_11 cdrouter_http_301
    cdrouter_app_12 cdrouter_http_250
    cdrouter_app_15 cdrouter_http_270
    cdrouter_app_16 cdrouter_http_280
    cdrouter_app_17 cdrouter_https_250
    cdrouter_app_18 cdrouter_https_300
    cdrouter_app_124 cdrouter_https_301

  • New WiFi band steering test case

    Band steering is a proprietary technique used to push, or steer, specific clients to either the 2.4 or 5 GHz frequency band. Steering is typically used for load balancing across multiple radios or to improve the overall aggregate performance of the AP by forcing older legacy clients to the 2.4 GHz band and/or newer more modern clients to the 5 GHz band.

    Band steering is not officially defined or included in any IEEE 802.11 specification. However, it is a widely supported feature in modern WiFi access points and is implemented in a variety of ways by different manufacturers. Band steering is only possible for dual-band clients and requires that the AP broadcast the same SSID and use the same security settings on all radios and bands.

    CDRouter’s new wifi_50 test case verifies the DUT’s band steering functionality. The new testvar lan80211BandSteering defines the expected band steering behavior of the DUT. If band steering is not supported or enabled, set this testvar to a value of none. If the DUT is configured to steer clients to either the 2.4 or 5 GHz band, set this testvar to a value of 2.4GHz or 5GHz, respectively. [ch3761]

Testvar Updates

Testvars added to this release:

  • The new testvar lan80211BandSteering is used in the wifi_50 test case to configure the expected WiFi band steering behavior of the DUT. [ch3761]

  • The new HomeKit expansion introduces six new testvars: supportsHomeKit, homeKitRouterName, homeKitHATHostname, homeKitHATRulesPath, homeKitRouterSetupCode, and homeKitManualEnabled.

Testvars modified or removed in this release:

  • The testvars lanChannel and wanApChannel have been updated to support twelve new 5 GHz channels: 68, 72, 76, 80, 84, 92, 96, 144, 169, 173, 177, and 181. [ch5110]

New Test Modules and Test Cases

CDRouter

  • New WiFi band steering test

    TEST: wifi_50
MODULE: wifi
DESCRIPTION: WiFi Band Steering test

Apple HomeKit

  • New expansion and test module for Apple Homekit-enabled Router Certification Test Plan

    MODULE: homekit
DESCRIPTION: Apple HomeKit Secure Router Certification Test Plan
NEW TEST CASES: 53

Notes

CDRouter

  • CDRouter’s wifi channel plan has been updated. Twelve new 5 GHz channels are now available: 68, 72, 76, 80, 84, 92, 96, 144, 169, 173, 177, and 181. These new channels are supported by CDRouter’s LAN clients and may also be used by CDRouter’s AP on the WAN.

    Note that when CDRouter is in AP mode on the WAN the list of available channels is restricted by the frequency band, regulatory settings, and capabilities of the underlying hardware and drivers. If the selected channel is not available or cannot be used, CDRouter will generate a warning and abort the test run. [ch5110]

  • The logging in tests cdrouter_dos_20, cdrouter_dos_21, cdrouter_dos_31, cdrouter_dos_33 and cdrouter_dos_34 has been updated to resolve some misleading log messages. [ch4381]

  • Updated the cdrouter_mcast_70 test case to resolve a false positive test result. [ch4921]

CDRouter Security

  • Updated the ET Open ruleset shipped with the CDRouter Security expansion to version 9477. [ch5176]

CDRouter USP

  • The Broadband Forum has changed the name of TR-469 to TP-469. All references to TR-469 within CDRouter have been updated to reflect this change. [ch5328]

  • In previous releases CDRouter’s USP controller used the msg_type field in the protobuf header to drive events. Changes in the USP 1.1 specification require a different approach. CDRouter now infers a message’s type from the decoded protobuf message instead of relying on the msg_type field. [ch5398]

CDRouter 12.2

May 21, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.2. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.2 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.2 testvars using the config upgrade utility.

New Features and Enhancements

CDRouter

  • Support for 64 wifi clients on ath10k based wireless adapters

    The maximum number of wifi clients supported by ath10k based wireless adapters within CDRouter has been increased from 32 to 64. [ch3689]

CDRouter USP

  • Broadband Forum USP Agent Certification

    CDRouter is the official test tool of the Broadband Forum’s USP Agent Certification program. This release of CDRouter includes a full implementation of TR-469 Conformance Test Plan for USP Agents in the usp_conformance test module. [ch4627]

    More information on how to use the CDRouter USP Expansion to perform self-testing certification can be found here.

CDRouter Web API

  • New parameter for fetching detailed data in Web API requests

    Many API calls which return a list of resources (configs, results, etc.) can now be modified to return all fields for that resource. Previously, only requests for an individual instance of a resource would provide detailed information, whereas requests for a list of resources yielded a summary view of the resource. See the CDRouter Web API documentation for details. The cdrouter.py Python module has also been updated to support the new detailed parameter. [ch4349]

Testvar Updates

Testvars added to this release:

  • The new testvar ipv6RelayServerGlobal can be used to specify the global IPv6 address of CDRouter’s 6rd/6to4 relay server. [ch4343]

Testvars modified or removed in this release:

  • None.

Notes

CDRouter

  • The libraries and utilities used by CDRouter have been rebuilt on CentOS 7 (previously these were built on CentOS 6 which is nearing end-of-life status). In addition, certain libraries and utilities will now be pulled in from the system automatically as dependencies when CDRouter is installed. [ch3424]

  • CDRouter’s Ethernet MTU is no longer automatically reduced when VLANs are enabled. [ch4766]

CDRouter USP

  • Updated the default value of the testvar uspParameterPath1 to Device.DeviceInfo.ModelName. [ch4572]

CDRouter Security

  • Updated the ET Open ruleset shipped with the CDRouter Security expansion to version 9456. [ch4533]

  • Added support for non-UDP/TCP security alerts which lack ports. Previously, CDRouter assumed all alert events coming from Suricata’s eve-log would contain src_port and dest_port keys, which is not true for alerts associated with, for example, ICMP packets. Therefore, CDRouter has been updated to support alerts without port information. [ch4556]

  • IPv6 internet connection sharing (ICS) now provides connectivity for all addresses within the WAN network defined by the testvars ipv6WanIspAssignIp and ipv6WanIspPrefixLen. Previously only addresses within the delegated prefix were given connectivity. [ch4158]

  • IPv6 internet connection sharing (ICS) can now be enabled in configurations that do not have DHCPv6 prefix delegation enabled. [ch4657]

CDRouter IPv6

  • CDRouter’s 6rd/6to4 relay server is now configured with the IPv6 global address specified by the new testvar ipv6RelayServerGlobal. Previously, CDRouter’s relay server was only configured with an IPv6 link-local address, which made it impossible for IPv6 packets originated by the relay server (for example, ICMPv6 Packet Too Big messages) to reach IPv6 LAN clients behind the DUT. Adding this new testvar and configuring the relay server with this IPv6 global address resolves this issue, allowing LAN clients performing Path MTU discovery to learn the PMTU of IPv6 hosts accessed over the tunnel. [ch4343]

CDRouter Performance

  • Improved logging for performance tests using more than one stream. [ch1770]

CDRouter TR-069

  • Updated tests tr143_http_11, tr143_http_12, tr143_http_13, tr143_http_14, and tr143_http_50 to support the Device:2.13 data model. [ch4471]

CDRouter 12.1

April 23, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.1. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.1 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.1 testvars using the config upgrade utility.

New Features and Enhancements

CDRouter

  • Support for 802.11ax

    CDRouter now supports 802.11ax WiFi in client mode on the LAN and AP mode on the WAN using the new NTA1000v7 platform which is also now available. If you are interested in learning more, or interested in upgrading your system to an NTA1000v7, please reach out to sales@qacafe.com.

NTA1000

  • New NTA1000v7 platform

    Version 7 of the NTA1000 platform is now available! The NTA1000v7 includes a new 2x2 dual-band 802.11ax capable wireless interface and is available in two hardware configurations:

    Hardware Configuration wifi0-acn WiFi Interface wifi1-ax WiFi Interface wifi2-ac2 WiFi Interface 10GBASE-T Interface
    NTA1000v7-S Yes Yes Yes No
    NTA1000v7-10G Yes Yes No Yes

    The NTA1000v7-S includes three WiFi interfaces and supports up to 65 WiFi clients (64 802.11ac capable clients + 1 802.11ax capable client). The NTA1000v7-10G includes two WiFi Interfaces and one dual-port 10GBASE-T Ethernet adapter and supports 33 WiFi clients (32 802.11ac capable clients + 1 802.11ax capable client).

    For more information, please see the NTA1000v7-S Quick Start Guide or contact sales@qacafe.com.

Testvar Updates

Testvars added to this release:

  • None.

Testvars modified or removed in this release:

  • The testvar dhcpv6WanEnablePD now has a dynamic default value, and will be set to yes if ipv6WanMode is autoconf, DHCP, unnumbered, or PPPoE (if ipv6PPPoEAddressMode is autoconf or DHCP). This dynamic default is only applied if forwardingMode is route. [ch2184]

  • The testvar wifiBeaconPhy has been updated to include a new supported value of ax. This makes it possible to verify the beacons of 802.11ax enabled devices with the wifi_20 test case. [ch3851]

  • The testvar lan80211Phy has been updated to include a new supported value of ax. [ch3851]

Notes

CDRouter

  • Updated many of the tests in the mcast and mcast-v6 modules to to protect against receiving unexpected multicast packets. This resolves an issue associated with test logic triggering on non-test multicast traffic. [ch4293]

  • Updated certificates for supporting WPA3 and Suite B profile for Transport Layer Security. [ch4427]

CDRouter Multiport

  • Resolved a race condition that could lead to a fatal error in the following test cases: guest_12, guest_13, guest_16, guest_17, ipv6_guest_12, ipv6_guest_13, ipv6_guest_16, and ipv6_guest_17. [ch4216]

CDRouter TR-069

  • Resolved a fatal error in test cases ir181_test_5.2.2, ir181_test_5.2.3, ir181_test_5.2.4, and ir181_test_5.2.5 when the Performance expansion is not enabled within the system’s license file. These tests will now run on systems that do not have the Performance expansion. [ch4016]

  • Updated the tr69_wireless_50 test case to test only channels that are supported by both the DUT and the wireless interface being used within CDRouter. [ch4326]

  • The Sectigo AddTrust External CA Root required to validate CDRouter’s ACS and ACS download server certificates will expire in May of 2020. This root CA has been replaced with the new Sectigo USERTrust RSA CA that expires in 2038. The Sectigo root is located in the acs.cdroutertest.com-rootca.pem in the /usr/cdrouter/tests/ directory.

    Note that the old Sectigo root CA used SHA1 with RSA encryption. The new root uses SHA384 with RSA encryption. Some DUT’s may need to have the new root CA installed in order to properly validate CDRouter’s ACS and ACS download server certificates.

    For more information on Sectigo Chain Hierarchy and Intermediate Roots, please see this page. [ch4263]

CDRouter IPv6

  • CDRouter will automatically enable DHCPv6 prefix delegation on the WAN for IPv6 WAN modes of autoconf, DHCP, unnumbered, or PPPoE (if the PPPoE address mode is either autoconf or DHCP). Note that this change does not apply to bridge mode configurations. [ch2184]

  • Updated the mape_21, mapt_21, and dslite_42 test cases to ensure that the ECN bits within the TOS / Traffic Class field are always set to a value of 0x00 to avoid translation issues with ECN capable implementations. [ch4461]

CDRouter USP

  • Resolved a fatal error condition in the usp_basic_4 test case. [ch4382]

  • Updated the usp_conformance_1_60 to remove an unneeded check for the subscription_id in an OnBoardRequest. [ch4433]

  • Numerous updates to the usp_conformance test module in preparation for the Broadband Forum’s USP certification program. [ch3917]

CDRouter Security

  • CDRouter’s internet connection sharing (ICS) feature has been updated to support routed test setups where one or more router hops are present on the WAN. In addition, the ICS feature is now enabled on all configured WAN interfaces. Previously, ICS was enabled only on the primary WAN interface. [ch4158]

CDRouter BBF.069

  • The BBF.069 tests require IPv4 and will now be skipped if IPv4 is not enabled. [ch4215]

CDRouter 12.0

March 26, 2020

Notices

Important Installation Notes

The following prerequisites must be met before upgrading to CDRouter 12.0:

➊ New minimum system requirements

CDRouter 12.0 requires a CentOS 7 or CentOS 8 operating system. The Ubuntu and CentOS 6 operating systems are no longer supported, and CDRouter 12.0 will not install if you are using one of these operating systems.

NTA1000 platforms running CentOS 6 should be upgraded using the Rebuild the NTA1000 Operating System guide prior to installing CDRouter 12.0.

If you do not have an NTA1000 or are otherwise unable to upgrade your operating system from Ubuntu or CentOS 6, please contact support@qacafe.com for assistance.

➋ Minimum CDRouter version requirement

The auto-upgrade utility in CDRouter’s web interface will not be able to install CDRouter 12.0 unless you are already running version 11.8.2. You must install CDRouter 11.8.2 before upgrading to CDRouter 12.0 using the auto-upgrade methods in the web UI.

If you are running an earlier release of CDRouter, you may upgrade to CDRouter 12.0 or later versions using the manual upgrade procedure via the CLI. Please follow the “Manual installation” instructions in the CDRouter Installation and Upgrade Guide to manually upgrade your system.

➌ New procedure for installing CDRouter

CDRouter 12.0 and subsequent versions will now be distributed as an rpm file that is only supported by the CentOS 7 and 8 operating systems.

The CDRouter Installation and Upgrade Guide has been updated with instructions for manually installing and upgrading CDRouter with the new installer format.

Please contact support@qacafe.com if you need any assistance.

➍ Config upgrades

CDRouter 12.0 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.0 testvars using the config upgrade utility.

See the Testvar Updates section below for important notes about config file changes in this release.

New Features and Enhancements

CDRouter

  • New Security Expansion!

    We are very excited to introduce the CDRouter Security expansion! This expansion includes a number of features designed to test and evaluate the overall security of a CPE device. Included with the Security expansion are port scanning tools utilizing Nmap, a new traffic analysis feature based on Suricata, and two new test modules for verifying schedule-based internet access restrictions which is a common parental controls feature.

    Please see the CDRouter Security User Guide for more information.

  • New config editor view for displaying only modified testvars

    The config editor within CDRouter’s web UI includes a new button labeled Expand Changed that will collapse all SECTIONs and testvar_groups in the config file that do not contain any changes. This makes it easier to see which testvars are not set to their default values. Previously, config files were displayed with all sections collapsed. Note that the expand changed view is also now the default view for all config files. [ch3673]

CDRouter USP

  • New USP controller domain name and TLS server certificates

    The USP controller certificates shipped with previous releases of CDRouter have been replaced by a new set of test certificates signed by Sectigo.

    In addition, the Common Name (CN) field of these certificates has been changed from controller.qacafe.com to controller.cdroutertest.com. The default value of the uspControllerDomain testvar, which identifies the fully-qualified domain name (FQDN) of CDRouter’s USP controller, has also been changed from controller.qacafe.com to controller.cdroutertest.com.

    It is important to note that these changes may break some existing CDRouter configurations. CPE devices may fail to resolve the controller IP address through DNS and and will not be able to validate the expired TLS server certificates until your configurations have been updated.

Testvar Updates

Testvars added to this release:

Testvars modified or removed in this release:

  • With the addition of the new CDRouter Security Expansion, testvars for the NMAP and ICS features have been moved and are no longer found at the top level of the config file hierarchy. These testvars can now be found immediately under the “CDRouter Security Expansion” section.

    Note that upgrading older config files will automatically reformat all testvars and move the NMAP and ICS testvar sections from their previous location to the “CDRouter Security Expansion” section.

    SECTION "CDRouter Security Expansion" {

    # testvar enableSuricata                   no

    SECTION "CDRouter ICS" {

        # testvar enableICS                        no
        # testvar icsInterface                     none
        # testvar icsShareIPv4                     yes
        # testvar icsShareIPv6                     yes

    }

    SECTION "CDRouter Nmap" {

        # testvar enableNmap                       no
        # testvar nmapPorts                        0-65535
        # testvar nmapScanTimeout                  600
        # testvar nmapTimingTemplate               5

    }

    SECTION "Parental Controls" {↔}

}

  • The testvars supportsNmap and supportsICS have been deprecated in favor of the new testvars enableNmap and enableICS, respectively. The original testvar names will continue to work until they are removed in a future release. All configs utilizing these testvars should be updated to use the new testvar names.

  • The testvars supportsH323AlgOutbound, supportsH323AlgInbound, and inboundH323Host are obsolete and have been removed from this release.

  • All wireless LAN and WAN testvars and testvar values that were deprecated in CDRouter 11.5 as part of the update required to support WPA3 have been removed. Any configs using deprecated testvars or testvar values must be updated.

Notes

CDRouter

  • The wildcard test certificates shipped with CDRouter have been updated. These certificates are used by CDRouter’s DNS servers when testing DNS over TLS (DoT) or DNS over HTTPS (DoH). Configurations that reference the old wildcard certificates will need to be updated for compatibility with CDRouter 12.0. Please see this Knowledge Base article for more information. [ch3773]

  • The test cases cdrouter_app_200, cdrouter_app_205, cdrouter_app_207, cdrouter_app_220, cdrouter_app_225, and cdrouter_app_227 are obsolete and have been removed from the apps test module. [ch3891]

  • All wireless LAN and WAN testvars and testvar values that were deprecated in CDRouter 11.5 as part of the update required to support WPA3 have been removed. Any configs using deprecated testvars or testvar values must be updated. [ch4014]

  • In certain configurations some wireless country codes are not fully supported by the underlying wifi drivers used by CDRouter. This may result in the drivers failing to load and the wifi interface(s) disappearing from the system.

    CDRouter now attempts to restore the system to a fully working state when this error condition is detected. Specifically, CDRouter will automatically reconfigure the system to use US/840 to restore the missing interface(s) and then attempt to set the regulatory domain to the system’s default which is based on timezone. If this fails CDRouter will attempt to set the domain to US/840, and generate an error to alert the user if this is unsuccessful.

    In addition, when determining the system’s default regulatory domain, which is based on timezone, US/840 will be used if the derived alpha2 domain code is considered invalid. [ch4134]

CDRouter TR-069

  • The wireless configuration verification tests in the tr69_wireless and ir181 test modules now validate that the DUT includes the client MAC in the AssociatedDevice table 5 seconds after the basic traffic verification step has been performed. This provides ample time for the DUT to update the AssociatedDevice table. [ch3915]

  • Resolved a fatal error with the wireless configuration tests in the tr69_wireless and ir181 test modules when run in multiport configurations utilizing both wireless and wired LAN interfaces. [ch3938]

  • Resolved an issue with CDRouter’s device data model version detection algorithm. Also addressed an issue with a Complete versus Completed error associated with the Device:2.13 data model in the tr143_http test module [ch3944]

CDRouter Storage

  • Resolved a false pass related to an error condition in the FTP storage tests if the initial connection was successfully established but subsequently timed out. [ch3936]