Connected Devices Agent Release Versions

Note: some releases include updates to dependency libraries. These versions only apply for builds of the Device Agent that do not use the versions of those libraries as supplied by the system firmware. For a listing of all libraries that are included in a particular Device Agent build, check the included COPYING file with the agent binary.

6.2

Release Date: 2025-02-11

Updates

• Updates the trusted certificates list to the August 2024 release of the Cisco Core Bundle.

• Supports the Device Agent v6.2 for Hitron’s Wi-Fi 7 OS362x range (Aria 3629).

6.1

Release Date: 2024-09-26

Updates

• Adds RDK-B support (dmcli) to the generic agent.

Fixed Issues

• Fixes an issue where routers/devices using the bspeed accelerator would incorrectly detect the message format version to use, when using Broadcom's OpenBFC major version 24 or higher.

• UDP speed test fixes for cleanup flows after server retries.

• The background traffic monitoring service no longer fails when relying on an external binary in the agent to retrieve the WAN interface (used to track the byte counter to measure cross-traffic).

• Fixes an issue where platforms using the Broadcom bspeed accelerator with OpenBFC 24.1 were failing because it only permits the /dev/iperf0 file to be opened once.

Package Updates

• ffmpeg updated to 6.1.2

6.0

Release Date: 2024-08-16

Updates

• Video conferencing test: improves handling of ICMP, logging and reducing execution time.

• Video conferencing test now accurately selects nearest server target from known discovered servers.

• YouTube test: retrieves test configuration via HTTPS.

• UDP speed test: improves measurement accuracy.

• UDP speed test: now retries (up to 5 times) to increase success rate when server usage is high.

• UDP speed test: makes it possible to override build time speed setting using CLI parameter.

• Gameplay test is now able to produce a detailed report of all server targets (no datacenter prefiltering).

• Gameplay test has added CLI option to exclude successful results, simplifying maintenance.

• Gameplay test: makes server selection rounds configurable via target config.

• HTTP test (download/upload speeds): adds support for more than one iperf driver version.

• Improves the error reporting of the HTTP test (download/upload speeds).

• CDN test: has added alibaba, tencent, fastly and limelight targets as services to test against.

• Improves the efficiency and speed of handling target server config by enabling HTTP compression of responses by default.

• Improves security as the agent now builds as a position-independent executable, enabling ASLR to protect against various security vulnerabilities.

• Improves security of the agent, now adopting CiscoSSL instead of OpenSSL.

• Removes support for outdated SSL protocol (SSLv3 excluded).

• Removes support for outdated TLS protocols (TLS 1.0, TLS 1.1 and DTLS 1.0 excluded).

• When router agent starts, checks that random number entropy source can be trusted.

• Router agent now provides CLI option to provide runtime state, system config and install directory paths.

• Router agent now terminates any previously running test when it starts.

• Adds multi-region support for ThousandEyes cloud services.

• Adds support for changing logging options in skagent.cfg.

• Increased security of test target URLs that are user-supplied by validating with context specific filters.

• Adds support for dual schedules.

Fixed Issues

• Fixes a crash when HTTP test (download/upload speeds) is configured with latency-under-load, but the continuous UDP latency test that is required for this metric, is not running.

• Fixes the bandwidth for YouTube and other tests that could not be determined by the HTTP test (download/upload speeds), if running with IPv6 only.

• Improvements in speed and stability to test mechanism of application tests, mainly affecting the gameplay test.

• Target config: ensures different HTTP server implementations are supported for test config.

• Fixes an issue wehre UDP latency test didn't report disconnections below the minimum duration threshold.

Package Updates

• spdlog updated to 1.13.0

• boost updated to 1.84.0

• libcurl updated to 8.8.0

• nghttp2 updated to 1.62.1

• zlib updated to 1.3.1

5.15

Release Date: 2024-08-12

Fixed Issues

• Does not report false latency under load data when the load generation fails.

• UDP latency test: disconnections below the minimum duration threshold are not reported.

• Fixes buffer overflow in udplatency when configured with a very short period between packets (e.g. 0.5s) and long reporting period (e.g. 60 minutes).

5.14

Release Date: 2024-07-19

Fixed Issues

• Fixes YouTube test issue where highest quality levels are not available in the manifest.

Known Issues

• Buffer overflow in continuous UDP latency test when configured with a very short period between packets (e.g. 0.5s) and long reporting period (e.g. 60 minutes).

5.13

Release Date: 2024-07-03

Fixed Issues

• Fixes the continuous UDP latency client crashing on some devices when there is a WAN disconnection.

5.12

Release Date: 2024-06-07

Fixed Issues

• Different test failure modes in accelerated HTTP test variant bcm_spdt (imbalanced streams, invalid byte counter values, stream freezes, streams that transfer no data at all) are now reported as failures in the HTTP speed test using appropriate error codes.

5.11

Release Date: 2024-05-08

Fixed Issues

• Fixes YouTube issue reporting only 'SD' quality level (use iOS manifest and accept different media container types).

5.10

Release Date: 2024-05-01

Package Updates

• libcurl updated to 8.4.0

• openssl updated to 3.2.1

5.9

Release Date: 2024-04-22

Fixed Issues

• Fixes crash around the DST change affecting devices with libmusl.

• Changes to the background traffic monitoring thresholds were not applied until the service restarted (due to a scheduled test running, which requires the traffic level to be below the old threshold). This is now fixed, and as soon as the LMAP schedule with new thresholds arrives, the new thresholds are applied.

• Resolves the responsiveness test failing on upload testing since v5.8.

5.8

Release Date: 2024-03-08

Package Updates

• libzmq updated to 4.3.5

• nghttp2 updated to 1.59.0

5.7

Release Date: 2024-03-07

Updates

• The request time of the LMAP schedule is now randomised, to avoid traffic spikes. The default interval is now between 45 and 75 minutes.

• Improves disconnection reporting for devices where the WAN interface disappears when the cable is unplugged.

• Enhances compatibility of game stores test with server lists in certain regions, resulting in improved success rate.

• Reduces RAM usage.

5.6

Release Date: 2024-02-08

Fixed Issues

• Traceroute measurements: 'HOP' vs 'TARGET' reports were misreported under certain conditions. This has been fixed.

• Long disconnections could be reported with wrong duration values. This has been fixed.

• Ping and traceroute tests failed under certain incorrect IPv6 connectivity configurations. This has been fixed.

Known Issues

• Continuous UDP Latency measurement: on devices where the WAN interface disappears when the connection goes down, during disconnections the sendto() fails in such a way that the actual packet loss is not reported.

5.5

Release Date: 2024-01-22

Fixed Issues

• Resolves an issue on certain SamKnows hardware platforms only, where a broken WiFi driver caused multiple agent reboots.

5.4

Release Date: 2023-12-20

Updates

• Backend requests for associating IPv6 and IPv4 addresses of agents and reporting LAN configuration are now spread more evenly to reduce load.

5.3

Release Date: 2023-11-30

Updates

• Adds support for some older devices which require software kernel timestamping.

• Adds support for configuring test duration to the UDP speed test.

• UDP speed test: adds support for caching previously discovered speed measurement ladder.

• Gameplay test: removes UDP port from Server IP result field.

Fixed Issues

• Fixes test target hostname resolution under certain IPv6 dual-stack configurations.

5.2

Release Date: 2023-11-07

Fixed Issues

• The target resolution function could hang when no groups are defined. This has been fixed.

5.1

Release Date: 2023-10-13

Fixed Issues

• Fixes an issue where the game store test crashed on certain devices.

Known Issues

• The task execution hangs if no group is defined in the test schedule. This is fixed in v5.2.

5.0

Release Date: 2023-09-21

Updates

• Adds support for setting DSCP and ECN flags for outbound packets and reporting the ToS/TClass value on inbound packets in the continuous UDP latency and jitter tests.

• Adds support for resolving server groups to the responsiveness test.

• Adds support for IPv6 to the software backend of the UDP speed test.

• Adds reboot task: this allows us to reboot the unit via scheduled or triggered task. This is intended for use in exceptional support situations.

• Adds support to server groups to the UDP accelerated speed test.

• Reduces space usage of agent measurement applications.

• Changes speedtest_client name to udpspeedtest. This clarifies that it is based on UDP and it is now matching the file system structure.

• Switches to using public PKI for TLS connections to DCS.

• Disables parallel ping when resolving target groups, to avoid triggering DDoS protections.

• Updates game store test methodology to be more representative.

Fixed Issues

• Fixes an issue where the target resolution function could hang when a "random" group was unreachable.

• Fixes game store test over-reporting. The time spent downloading a chunk was measured incorrectly, showing excessive speeds.

Known Issues

• The task execution hangs if no group is defined in the test schedule. This is fixed in v5.2.

Package Updates

• Catch2 updated to 3.4.0

• croncpp updated to v2023.03.30

• curl updated to 8.1.2

• mdns updated to 1.4.3

• miniupnpc updated to 2.2.5

• nghttp2 updated to 1.55.1

• pjsip updated to 2.13.1

• Updates libzmq to unreleased ec013f3a17beaa475c18e8cf5e93970800e2f94a, relicensed under Mozilla Public License v2.0.

4.9

Release Date: 2023-06-09

Updates

• Adds --opensync-order option for skagent -o (local instant test API). It allows it to specify the order of tests. For example: skagent -o --opensync-order LUD runs latency, then upload, then download test. When not specified, the order is LDU.

  • This can be also used to run a single test: --opensync-order D runs the download test only.

• Adds any IP version option to the Webget (web page load lite) test. The test can now automatically pick between IPv4 and IPv6.

• Adds triggerable ping test.

• Adds triggerable traceroute test.

• Adds initial release of responsiveness test.

Fixed Issues

• Fixes an issue wehre some streaming tests were using a wrong bandwidth limit.

• Fixes an issue where with some test schedules, latency under load was not always reported.

Package Updates

• Router Agent now requires C++14

• Catch2 updated to 3.3.2

• curl updated to 8.1.0

• fmt updated to 10.0.0

• nghttp2 updated to 1.53.0

• openssl updated to 3.1.1

4.8

Release Date: 2023-04-18

Updates

• Improves activation algorithm: the retry time is now randomised, so the backend load is reduced and the activation probability increases when a large amount of devices is deployed at the same time.

• Adds network checks, so the agent can report when the network configuration is not optimal.

• Adds payload-size option to the UDP speed test, to support some non-standard testing servers.

• Adds IPv4 and IPv6-only options to DNS test.

Fixed Issues

• Improves task scheduling: avoids duplicate tests when the device clock is not precise enough and the test frequency is low.

• Fixes an issue where the test execution time evaluation could fail near the spring DST change, causing an agent restart.

• Fixes phantom disconnections during UDP speed test.

4.7

Release Date: 2023-03-14

Updates

• Fixes another corner condition under which the agent could restart when terminating a child process.

• Improves error logging for unexpected terminations of background traffic detection service.

• Adds tuning of Broadcom HW accelerator's window sizes.

• Adds restore of Broadcom HW accelerator state, to resume testing without needing a reboot in case of unexpected test termination.

• Adds check to prevent running a foreground process while a background instance is already active.

• Adds collection of HW TCP accelerator module version as metadata (on applicable devices).

Fixed Issues

• skagent version 4.6 introduced a bug which segfaults during the activation phase. Subsequent activations work after the device gets a unitid. This version contains a fix for this and the activation phase works as intended.

Known Issues

• Daylight savings “DST bug”: this version is affected by a bug in the “cron” library. Once a year, when the DST (daylight savings) starts (in spring, in the northern hemisphere, and in autumn in the southern hemisphere), this software is unable to compute the time of the next test execution and it crashes. We performed several tests and this crash might happen repeatedly over a period lasting from 0 to 22 hours, depending on the schedule. If the init system managing the agent is not configured correctly, this might result in the agent failing to resume execution until the entire device is rebooted.

4.6

Release Date: 2023-03-03

Fixed Issues

• Fixes a corner condition under which the agent could restart when terminating a child process.

• Fixes an issue where triggered UDP speed tests (instant tests) did not specify in the intermediate output whether a status update was for an upload or a download test.

4.5

Release Date: 2023-02-06

Fixed Issues

• Social media test and YouTube test: fixes a programming error that could cause test failure (introduced in v4.4).

4.4

Release Date: 2023-01-31

Updates

• Adds components to support local Real Speed device discovery mechanism.

• Improves cleanup of stuck processes. This can prevent situations where hardware accelerators are unable to run tests until the unit is rebooted.

• Increases logging of test outputs, to improve the ability to diagnose testing issues.

• Improves ping test result consistency by adding a pre-test probe.

• Introduces skspdt, the SamKnows adaptation library for Broadcom HW accelerated TCP testing. It supports speeds up to 10 Gbps. This library depends on the Broadcom SPDT API, which internally communicates over Netlink with the kernel. Supported functionality is both 'HTTP' protocol and 'Iperf TCP' protocol, which are two separate modes in the HW accelerator. The role of the skspdt library is to make SPDT API usage safe and make it possible for several tests to use HW accelerated functionality.

• Adds support for SPDT HW acceleration in the HTTP Speed Test. The test application is based on socket APIs, which is not compatible with the SPDT API. The two worlds are connected with the help of the syscall handler backend concept. This enables all common use cases such as scheduled uplink/downlink tests, interactive triggered testing sessions, over IPv4/IPv6 using 1-4 concurrent TCP streams

Fixed Issues

• Improves resiliency of the DATAUSAGE reporting. Some units could fail to update their counters. This has been fixed.

• The triggered testing service doesn't fail to connect any more when the name resolver returns first an unreachable IP, like an IPv6 address in a system without IPv6 connectivity.

• Improves server selection for gameplay tests. Those tests can now pick the correct server, even when another one is not responding.

• Improves reporting of a skipped test condition due to high network usage. Sometimes the traffic details were not reported.

Package Updates

• Catch2 updated to 2.13.10

• boost updated to 1.81.0

• croncpp updated to 5c28f410db1af9507ef8469c9796a7070e5e8e2e

• curl updated to 7.86.0

• ffmpeg updated to 5.1.2

• miniupnpc updated to 2.2.4

• nghttp2 updated to 1.51.0

• openssl updated to 3.0.7

• pjsip updated to 2.13

• trompeloeil updated to 43

4.3

Release Date: 2022-12-13

Fixed Issues

• The udpspeed test could run even if cross-traffic was detected. This has been resolved.

• Fixes an issue on targets that do not perform background traffic monitoring (e.g. Docker agents or Raspberry Pi agents) where attempting to run data usage collection would prevent the agent from running.

• Resolves a race condition that could occur which prevented the background traffic monitor from reporting that the network was clear for tests to run. This was introduced in v4.0 and was triggered by the use of the data usage monitoring feature.

Known Issues

• The rpi target package does not include the third party open source licenses used.