CDRouter 11.8

Release Type Release Number Release Date
Original CDRouter 11.8 Build 1 January 23, 2020
Maintenance Release 1 CDRouter 11.8 Build 2 February 27, 2020

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

Attention: Operating System Deprecation Notice

Ubuntu and CentOS 6 will not be suported in future releases

All CDRouter systems will require the CentOS 7 operating system in order to install CDRouter 12.0 and beyond.

Support for the Ubuntu operating system and CentOS 6 has been deprecated. CDRouter systems running on Ubuntu or CentOS 6 will now see warning messages during installation and in the ‘start’ log of a test run.

Support for both of these operating systems will be officially removed with the next major version of CDRouter (12.0). Please contact support@qacafe.com for additional information and assistance in migrating to a supported operating system.

January 23, 2020

New Features and Enhancements

CDRouter

  • New PPPoE pass-through test case

    A new test case has been added to the pppoe-pt (PPPoE pass-through) test module. This new test, cdrouter_pppoept_3, verifies PPPoE pass-through sessions using a random session ID whereas the other tests in this module use sequential session IDs. [ch1606]

CDRouter TR-069

  • Support for the Device:2.13 data model

    CDRouter now supports the Broadband Forum’s Device:2.13 data model for CWMP as defined in TR-181 Issue 2 Amendment 13. [ch585]

  • Updated CWMP profiles

    CDRouter’s Device2_profiles test module has also been updated to support the Device:2.13 data model. All profiles defined in the following data models are now supported:

    Data Model Version
    InternetGatewayDevice:1 1.14
    Device:1 1.14
    Device:2 2.13
    STBService:1 1.4
    VoiceService:1 1.1
    VoiceService:2 2.0
    StorageService:1 1.3
    FAPService:1 1.1
    FAPService:2 2.1

    This update adds support for the new Device:2 profiles listed below:

    Test Module Profile
    Device2_profiles PacketCaptureDiagnostics:1
    Device2_profiles SELTDiagnostics:1
    Device2_profiles MQTTClientCon:1

    In addition, one test, FAPService2_REMLTE_ado_6, has been removed due to changes in Device:2.13 data model requirements. [ch585]

CDRouter USP

  • Support for the Device:2.13 data model

    CDRouter now supports the Broadband Forum’s Device:2.13 data model for USP as defined in TR-181 Issue 2 Amendment 13. [ch585]

  • Updated CWMP profiles

    CDRouter’s USP_Device2_profiles test module has also been updated to support the Device:2.13 data model. All profiles defined in the following data models are now supported:

    Data Model Version
    Device:2 2.13
    STBService:1 1.4
    VoiceService:2 2.0
    StorageService:1 1.3
    FAPService:2 2.1

    This update adds support for the new Device:2 profiles listed below:

    Test Module Profile
    USP_Device2_profiles MQTTClientCon:1
    USP_Device2_profiles BinaryControl:1
    USP_Device2_profiles LevelControl:1
    USP_Device2_profiles LevelControlIntensity:1
    USP_Device2_profiles EnumControl:1
    USP_Device2_profiles BinarySensor:1
    USP_Device2_profiles LevelSensor:1
    USP_Device2_profiles LevelSensorLowThreshold:1
    USP_Device2_profiles LevelSensorHighThreshold:1
    USP_Device2_profiles MultiLevelSensor:1
    USP_Device2_profiles EnumSensor:1
    USP_Device2_profiles SELTDiagnostics:1
    USP_Device2_profiles PacketCaptureDiagnostics:1
    USP_Device2_profiles CoAPAgent:1
    USP_Device2_profiles WebSocketAgent:1
    USP_Device2_profiles MQTTAgent:1
    USP_Device2_profiles CoAPController:1
    USP_Device2_profiles WebSocketController:1
    USP_Device2_profiles MQTTController:1
    USP_Device2_profiles ControllerTrust:1

    In addition, one test, USP_FAPService2_REMLTE_ado_6, has been removed due to changes in Device:2.13 data model requirements. [ch585]

NTA1000

  • New 7.0 Golden Image

    Version 7.0 of the NTA1000 operating system image, aka the golden image, is now available. This version is supported on all NTA1000v2 through NTA1000v6 platforms and is based on CentOS 7. For more information, please see the Golden Image Release Notes.

Testvar updates

Testvars added to this release:

  • None.

Testvars modified or removed in this release:

New Test Modules and Test Cases

CDRouter TR-069

  • New Device:2.13 profile tests

    PROFILE: PacketCaptureDiagnostics:1
MODULE: Device2_profiles
NEW TEST CASES: 6

    PROFILE: SELTDiagnostics:1
MODULE: Device2_profiles
NEW TEST CASES: 6

    PROFILE: MQTTClientCon:1
MODULE: Device2_profiles
NEW TEST CASES: 6

CDRouter USP

  • New Device:2.13 profile tests

    PROFILE: MQTTClientCon:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: BinaryControl:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: LevelControl:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: LevelControlIntensity:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: EnumControl:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: BinarySensor:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: LevelSensor:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: LevelSensorLowThreshold:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: LevelSensorHighThreshold:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: MultiLevelSensor:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: EnumSensor:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: SELTDiagnostics:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: PacketCaptureDiagnostics:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: CoAPAgent:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: WebSocketAgent:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: MQTTAgent:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: CoAPController:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: WebSocketController:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: MQTTController:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

    PROFILE: ControllerTrust:1
MODULE: USP_Device2_profiles
NEW TEST CASES: 4

Notes

CDRouter

  • Updated version of Tcl shipped with CDRouter to 8.6.10. [ch2468]

  • The test constraints and skip logic for configurations utilizing wireless virtualization have been re-factored. These changes impact tests within the incompatible-with-multiple-wireless-radio skip label. This makes it possible to run any test cases that require the creation of LAN clients with specific user defined MAC addresses if at most one wireless interface that supports virtualization is enabled. Previously, these tests were skipped if one or more wireless interfaces with virtualization support were enabled. [ch1921]

  • Created a new requires-wired-wan skip label. All tests that require virtualization on the WAN are now contained within this label and will therefore only run in configurations that utilize a wired WAN interface. [ch1921]

  • The cdrouter_dos_10 test is not compatible with configurations where the wanMode is set to a value of none and will now be skipped automatically in these configurations. [ch2350]

  • Updated the dns_60 test case and all variants to wait dnsFailoverDelay seconds before verifying that the original servers have been restored. Previously these tests waited a fixed 5 seconds which was not always sufficient. [ch2147]

  • CDRouter now generates a configuration error if both the lanMode and ipv6LanMode testvars are set to a value of none. This prevents a fatal error in certain configurations from occurring. [ch2983] [ch2502]

CDRouter TR-069

  • The value Completed for the UploadDiagnosticsState and DownloadDiagnosticsSate parameters in the Device:2.13 data model has been deprecated and replaced with the value Complete. A number of tests in the ir181 and tr143_http test modules have been updated to handle this change. Devices implementing Device2:12 or earlier MUST use a value of Completed for these two parameters, whereas devices implementing Device:2.13 may use values of Completed or Complete. [ch2669]

CDRouter Multiport

  • Resolved an issue associated with reconnection of CDRouter’s wireless LAN clients if disassociated during a test run. Previously, only one wireless client would reconnect - all other clients would not reconnect, resulting in failures in all subsequent tests. [ch2620]

CDRouter IPv6

  • CDRouter’s relay server for 6to4 and 6rd will now be configured with a link-local IPv6 address which can be used by the DUT for Neighbor Unreachability Detection, as defined in Section 9 of RFC 5969 and Section 3.8 of RFC 4213. [ch2230]

CDRouter Performance

  • Resolved a fatal error when running perf_multi_2, perf_multi_4, ipv6_perf_multi_2, or ipv6_perf_multi_4 test cases in PPPoE mode on the WAN. [ch2197]

CDRouter USP

  • Resolved an issue with parameters specified by the testvar uspSkipParameters not being properly skipped during USP profile validation tests. [ch3066]

February 27, 2020

New Features and Enhancements

CDRouter Multiport

  • New LAN multiport routing test cases

    Four new test cases have been added to the CDRouter Multiport expansion. These tests verify TCP and UDP routing over IPv4 and IPv6 between LAN clients.

    The cdrouter_lan_mp_21 and cdrouter_lan_mp_22 test cases verify TCP and UDP routing between LAN clients over IPv4, respectively. The ipv6_lan_mp_21 and ipv6_lan_mp_22 test cases verify the same functionality over IPv6.

CDRouter TR-069

  • New ACS domain name and 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).

    The Common Name (CN) field of these certificates has been changed from acs.qacafe.com and acs-download.qacafe.com to acs.cdroutertest.com and acs-download.cdroutertest.com, respectively. The default value of the acsDomain testvar, which identifies the fully-qualified domain name (FQDN) of CDRouter’s ACS, has also been changed from acs.qacafe.com to acs.cdroutertest.com.

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

    Please see the following Knowledge Base article for instructions to update your configurations:

    [Updating the TR-069 ACS Domain Name] (/cdrouter/knowledge-base/updating-the-acs-domain-name)

CDRouter IPv6

  • New DS-Lite test case

    A new test case, dslite_42, has been added to the dslite module. This test verifies that the DUT copies the IPv4 TOS field into the IPv6 Traffic Class field and vice versa when handling DS-Lite traffic, as defined in Section 7.1 of RFC6333.

Testvar updates

Testvars added to this release:

Testvars modified or removed in this release:

  • mapTunnelTrafficClass - this testvar supports the new value of auto, which indicates that the IPv6 Traffic Class field is expected to be copied from the IPv4 Type of Service (TOS) field of the original IPv4 header in test case mape_21. [ch2168]
  • acsDomain - the default value of this testvar has been changed from acs.qacafe.com to acs.cdroutertest.com.
  • acsCertPath - the default value of this testvar has been updated to the location of the new ACS server certificate.
  • acsCaCertPath - the default value of this testvar has been updated to the location of the new ACS CA bundle.
  • acsDownloadCertPath - the default value of this testvar has been updated to the location of the new ACS download server certificate.
  • acsDownloadCaCertPath - the default value of this testvar has been updated to the location of the new ACS download server CA bundle.
  • supportsH323AlgOutbound - this testvar is now deprecated and will be removed in the next release of CDRouter.
  • supportsH323AlgInbound - this testvar is now deprecated and will be removed in the next release of CDRouter.
  • inboundH323Host - this testvar is now deprecated and will be removed in the next release of CDRouter.

New Test Modules and Test Cases

CDRouter IPv6

  • New DS-Lite test case

    TEST: dslite_42
MODULE: dslite
DESCRIPTION: Verify IPv4 TOS is copied to IPv6 Traffic Class

CDRouter Multiport

  • New TCP and UDP LAN to LAN routing tests

    TEST: cdrouter_lan_mp_21
MODULE: lan-mp
DESCRIPTION: Verify TCP routing between multiple LAN ports

    TEST: cdrouter_lan_mp_22
MODULE: lan-mp
DESCRIPTION: Verify UDP routing between multiple LAN ports

    TEST: ipv6_lan_mp_21
MODULE: lan-mp-v6
DESCRIPTION: Verify HTTPv6 routing between multiple IPv6 LAN ports

    TEST: ipv6_lan_mp_22
MODULE: lan-mp-v6
DESCRIPTION: Verify UDP routing between multiple IPv6 LAN ports

Notes

CDRouter

  • The arrangement of the Auto-Update and test navigation buttons within the web UI have been switched. This prevents the navigation buttons from moving when a test is finished versus running. [ch3088]

  • Updated the Visualize Package feature to properly escape special characters in package names. [ch3159]

  • CDRouter’s HTTP client no longer includes the Accept-Encoding: gzip header option in requests. [ch2551]

  • The CDRouter web UI no longer supports HTTP/2. This resolves an issue with the Automatic and Manual upgrade features within the CDRouter web UI when initiated over HTTPS with a browser that supports HTTP/2. HTTP/2 support will be re-enabled in the future when the underlying library has been patched. [ch3719]

  • Certain wifi cards manage their regulatory domain via firmware and cannot be configured for a specific country code. CDRouter will now ignore these cards when setting the country code. This resolves a fatal error on certain systems. [ch2464]

  • The following tests which involve H323 ALG functionality will be removed in the next release of CDRouter: cdrouter_app_200, cdrouter_app_205, cdrouter_app_207, cdrouter_app_220, cdrouter_app_225, and cdrouter_app_227. [ch3891]

CDRouter TR-069

  • CDRouter will now generate a config check warning if IPv6 is disabled and the testvar acsIp is set to an IPv6 address. Previously this configuration would generate a fatal error at run time. [ch3047]

  • Resolved an issue with the tr69_wireless module in which the original PSK was not being properly restored at the end of each test. This issue was introduced in CDRouter 11.5 and impacted only tests utilizing WPA in configurations where the testvar lanSecurity was set to the value WPA. [ch3382]

CDRouter BBF.069

  • Resolved a race condition with XMPP based connection requests. This issue has also been reported upstream to the UNH-IOL. [ch3781]

CDRouter IPv6

  • Update the logic for the mape_21 test case to recognize the new auto value for mapTunnelTrafficClass such that the test case will pass if and only if the DUT copies the IPv4 TOS field into the IPv6 Traffic Class field when performing MAP-E translation. [ch2168]

  • Resolved an off by one issue with CDRouter’s LAN side DHCPv6 pool size calculation. [ch3858]

CDRouter Storage

  • Resolved an issue in the storage tests in which a failed initial connection to the server would result in a test case pass rather than failure. [ch3512]

CDRouter USP

  • A new testvar, uspControllerUseNonPayloadProtection has been added. This testvar controls whether or not CDRouter’s USP Controller sends a mac_signature value. [ch2053]

  • General improvements to session management within the USP Controller. [ch2053]

  • Added heartbeat support for STOMP. [ch2053]

  • Numerous improvements based on initial verification testing of the USP conformance test plan (Broadband Forum TR-469). [ch2053]

  • Minor bugfixes in USP scenarios. [ch2056]