Release Notes for esb3024-1.24.0

Build date

2026-04-23

Release status

Type: production

Compatibility

This release has been tested with the following product versions:

  • AgileTV CDN Manager, ESB3027-1.6.0
  • Orbit, ESB2001-4.2.2 (see Known limitations below)
  • SW-Streamer, ESB3004-2.6.2
  • Convoy, ESB3006-3.8.0
  • Request Router, ESB3008-3.10.1
  • GUI 4.0.3

Breaking changes since release esb3024-1.22.1

  • None

Change log

  • NEW: Add configuration feedback [ESB3024-122]
  • NEW: Add module based logging [ESB3024-505]
  • NEW: Support for QoE based routing [ESB3024-641]
  • NEW: Add nested expressions to condition language [ESB3024-1099]
  • NEW: Logging performance improvements [ESB3024-1163]
  • NEW: Forward the last error code from CDN to client [ESB3024-1625]
  • NEW: Log name of loaded GeoIP database [ESB3024-1646]
  • NEW: Restructure logging configuration [ESB3024-1654]
  • NEW: Improved logs when connection is closed prematurely [ESB3024-1769]
  • FIXED: Dash variants not detected for QoE Streams [ESB3024-390]
  • FIXED: Quotation marks not supported in classifier patterns [ESB3024-695]
  • FIXED: Restart loop when directory Lua directory is manually created by user root [ESB3024-705]
  • FIXED: Invalid JSON makes confd-transformer crash [ESB3024-1041]
  • FIXED: Internal Server Error on requests from unknown instream sessions [ESB3024-1376]
  • FIXED: Response translate function not invoked when no route found [ESB3024-1377]
  • FIXED: Lua response body not set for instream sessions [ESB3024-1378]
  • FIXED: Confd schema accepts config without mandatory properties [ESB3024-1583]
  • FIXED: Connection header is not respected [ESB3024-1655]

Deprecated functionality

Deprecated since ESB3024-1.18.0:

  • Lua function epochToTime has been deprecated in favor of epoch_to_time.
  • Lua function timeToEpoch has been deprecated in favor of time_to_epoch.
  • The session proxy has been deprecated. Its functionality is replaced by the new “Send HTTP requests from Lua code” function.

System requirements

See the current system requirements in Getting Started.

Known limitations

  • Downgrading to a version prior to 1.22.1 will fail if the configuration is missing an integration.routing section. When this happens, the acd-confd-migration tool will print an error message and exit. The workaround is to add an empty integration.routing section to the configuration before downgrading.

    This is the error message that is printed:

    Migration failed at migrations.v1_22_1.00_add_missing_gui_integration: 'routing'

  • It is recommended to set services.routing.tuning.general.overloadThreshold to 128. This is particularly important if the Director will receive messages from Kafka.

  • Sometimes the ACD Confd Transformer does not start correctly after the ACD Director has been upgraded. This can be identified by typing systemctl status acd-confd-transformer.service after the upgrade is complete. If it shows that the service is not running, it needs to be started manually by typing systemctl start acd-confd-transformer.service. [ESB3024-1675]

  • When configured to use TLS, acd-telegraf-metrics-database might log the following error message: http: TLS handshake error from <client ip>: client sent an HTTP request to an HTTPS server when receiving metrics from caches even though the Telegraf agents are configured to use TLS. The Telegraf logs on the caches do not show any errors related to this. However, the data is still received over TLS and stored correctly by acd-telegraf-metrics-database. The issue seemingly resolved itself during investigation and is not reproducible. Current hypothesis is a logging bug in Telegraf.

  • The Telegraf metrics agent might not be able to read all relevant network interface data on ESB2001 releases older than 3.6.2. The predictive load balancing function host_has_bw() and the health check function interfaces_online() might therefore not work as expected.

    • The recommended workaround for host_has_bw() is to use host_has_bw_custom(), documented in Built-in Lua functions. host_has_bw_custom() accepts a numeric argument for the host’s network interface capacity which can be used if the data supplied by the Telegraf metrics agents do not contain this information.
    • It is not recommended to use interfaces_online() for ESB2001 instances until they are updated to 3.6.2 or later.