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

CDRouter 3.8.1 Release Notes

                     
Welcome to CDRouter version 3.8.1!

What's new in CDRouter version 3.8.1:


  CDRouter 3.8.1 does not add any additional test cases. This relase
  does introduce several new configuration options and improved
  feature support.


  Fedora Core 7
  -------------

  CDRouter release 3.8.1 now supports Fedora Core 7. There are a few
  things to address before running CDRouter on Fedora Core 7.

   *) Fedora Core 7 does not install Tcl by default. We recommend 
      installing Tcl before installing CDRouter. 

      # yum install tcl

   *) SELinux must be disabled in order to run CDRouter.

      See http://www.qacafe.com/kb/articles/show/178

   *) If a wireless interface is used, the kernel should be upgraded
      to a kernel built with 16K stacks.

      See http://www.qacafe.com/kb/articles/show/135
  
   *) CDRouter is not compatible with the Xen virtualization service.
      Xen should not be enabled on your CDRouter machine.

   *) Before attempting to install driverloader, you need to install
      wget.

      # yum install wget
   

 
  Improved HTTP Proxy Support
  ---------------------------

  Some existing test cases were sending HTTP 1.1 GET Requests without
  the "Host" header. RFC 2616 requires the "Host" header in all
  HTTP 1.1 Requests. This release updates the use of all HTTP 1.1 GET
  Requests to be compilant with RFC 2616.

  Previously, some HTTP proxies could return "Bad Request" if the "Host"
  header was missing from the HTTP GET Request.



  DHCP Client Renewal
  -------------------

  In the previous releases, CDRouter would renew the DHCP client for
  each LAN interface before starting the next case. This only occurs
  if the T1 timer for the LAN DHCP lease had expired. If very short 
  LAN side DHCP lease times are used, the DHCP lease may actually 
  be expired before CDRouter attempts to renew it. In this release, 
  CDRouter will now restart the DHCP DISCOVERY process if the lease has
  expired rather than attempting to renew.

  NOTE: The LAN side DHCP lease on the CPE should normally be 
  configured with a value such that CDRouter's LAN clients are not
  expiring during a test case. If a LAN client lease expires, CDRouter
  will continue to use the IP address until the test case is
  complete. Before starting the next test case, CDRouter will restart
  the DHCP DISCOVERY process to obtain a new DHCP lease.



  DMZ IP Protocol Configuration
  -----------------------------

  DMZ test case cdrouter_dmz_200 now allows a list of IP protocol exceptions
  to be configured. If the DMZ functionality of the router does not
  support a specific IP protocol, this protocol can now be skipped. For
  example to skip IGMP (IP protocol 2) and GRE (IP protocol 47), the 
  following new testvar can be configured:

     testvar lanDmzIpProtoExceptions "2,47"

  The testvar lanDmzIpProtoExceptions takes a comma seperated or space
  seperated list of IP protocol numbers. Whitespace in the list is
  optional but the value should be double quoted if whitespace is used.



  Multicast Testing over PPTP
  ---------------------------

  CDRouter 3.8.1 fixes a bug in running multicast tests over PPTP. In all
  other previous releases, any IGMP packet sent on the WAN was not sent
  over the PPTP tunnel. With this fix, all IGMP packets are sent over
  the PPTP tunnel.

  This change only impacts PPTP. No other WAN modes are impacted.



  NAT Timeout Testing
  -------------------

  CDRouter 3.8.1 fixes a bug in the nat-timeout.tcl module testing routers
  that are configured to Reset (Rst) TCP connections originating on the 
  WAN if there is no active TCP connection. The test previously assumed
  the router's firewall would ignore incoming TCP packets from the WAN 
  if no active TCP session exists.



  ACS Intermediate CA Configuration 
  ---------------------------------

  CDRouter now allows the configuration of an intermediate CA for the
  ACS server certifiate when SSL is enabled on the ACS. If the
  intermediate CA is not already installed on the CPE, the intermediate
  CA may be configured on CDRouter. When the SSL session is established,
  CDRouter will send both its server certificate and the intermediate CA.

  To configure an intermediate CA, use the new testvar acsCaCertPath.
  All certificate files must be in *.pem format.

  Example:

    testvar acsCaCertPath /home/lab/myca.pem


  
  CPE Connection Request User and Password for LAN Side TR-069 Devices
  --------------------------------------------------------------------

  CDRouter 3.8.1 now allows the CPE Connection Request username and 
  password to be individually configured for each LAN side TR-069 device.

  The new testvar values that should be placed in the testvar_group for
  the LAN side device are acsCpeDefaultUser and acsCpeDefaultPassword.

  For example:

    testvar_group tr069_device2 {

        # -- the ACS user and password that the CPE should use
        testvar acsDefaultUser cpeA
        testvar acsDefaultPassword login123

        # -- the CPE Connection Request URL user and password
        testvar acsCpeDefaultUser tr069
        testvar acsCpeDefaultPassword login123

        ...
        ...
    }



  Port Map Creation for LAN Side TR-069 Devices
  ---------------------------------------------

  In order to make testing of LAN side TR-069 devices easier, CDRouter TR-069
  can automatically detect the presence of NAT between a LAN side TR-069
  device and the CDRouter ACS and automatically create a port mapping on the
  IGD that allows the ACS to use the device's CPE Connection Request URL 
  through NAT. The IGD must also support TR-069.

  This feature can be enabled on a LAN side TR-069 device by configuring
  the testvar acsCreatePortMapOnIGD to yes in the testvar_group for the
  LAN side TR-069 device.

  By default, CDRouter will use the public port number 20000 when 
  creating the port mapping. The port number can also be configured
  using the testvar acsPortMapPublicPort.

  Example

    testvar_group tr069_device2 {

        # -- additional TR-069 devices on the LAN
        testvar acsDefaultUser cpeA
        testvar acsDefaultPassword login123
        testvar acsCpeDefaultUser tr069
        testvar acsCpeDefaultPassword login123

        testvar tr69DeviceOui 000A123
        testvar tr69DeviceSn  1234
        testvar tr69DownloadImage       /home/qacafe/firmware.bin

        # -- set the device type
        testvar tr69DeviceType STB

        # -- create port mapping automatically
        testvar acsCreatePortMapOnIGD   yes

        # -- use port 3334 for the public port mapping for this device
	testvar acsPortMapPublicPort    3334

    }

  Note: At the end of the test session, CDRouter will automatically delete
  all port mappings created on the IGD.