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.