Release esb3024-1.22.1

Build date

2026-02-05

Release status

Type: production

Compatibility

This release has been tested with the following product versions:

  • AgileTV CDN Manager, ESB3027-1.4.1
  • 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 3.2.9

Breaking changes since release esb3024-1.22.0

  • If the system has a lot of entries in the selection input, services.routing.tuning.general.selectionInputItemLimit needs to be tweaked, otherwise it will not work after upgrading.

Change log

  • NEW: Performance optimizations and improvements
  • NEW: Show number of selection input entries in Grafana [ESB3024-1582]
  • NEW: Monitor Lua memory usage [ESB3024-1591]
  • NEW: Monitor memory and CPU usage [ESB3024-1592]
  • NEW: Improved expiration handling of messages read from Kafka [ESB3024-1594]
  • FIXED: Selection input item limit does not work [ESB3024-1472]
  • FIXED: The Director does not reconnect when a Kafka topic is recreated [ESB3024-1491]
  • FIXED: Segmentation fault when connection to Kafka is lost [ESB3024-1523]
  • FIXED: SELinux being set to enforced without consent [ESB3024-1586]
  • FIXED: Migraton script missing for integration.gui config [ESB3024-1621]
  • FIXED: Installation fails if firewalld is disabled [ESB3024-1623]

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

  • 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.