Release esb3024-1.16.0

Build date

2024-12-04

Release status

Type: production

Compatibility

This release is compatible with the following product versions:

• Orbit, ESB2001-3.6.0 (see Known limitations below)
• SW-Streamer, ESB3004-1.36.0
• Convoy, ESB3006-3.4.0
• Request Router, ESB3008-3.2.1

Breaking changes from previous release

• Access logs are now saved to disk at /var/log/acd-router/access.log instead of being handled by journald.

Change log

• NEW: Collect metrics per account [ESB3024-911]
• NEW: Strip whitespace from beginning and end of names in configuration [ESB3024-954]
• NEW: Improved reselection logging [ESB3024-1089]
• NEW: Access log to file instead of journald. Access logs can now be found in /var/log/acd-router/access.log [ESB3024-1164]
• NEW: Additional Lua checksum functions [ESB3024-1229]
• NEW: Symlink logging directory /var/log/acd-router to /opt/edgeware/acd/router/log [ESB3024-1232]
• FIXED: Convoy Bridge retries errors too fast [ESB3024-1120]
• FIXED: Memory safety issue. Certain circumstances could cause the director to crash [ESB3024-1123]
• FIXED: Too high severity on some log messages [ESB3024-1171]
• FIXED: Session Proxy sends lowercase header names, which are not supported by Agile Cache [ESB3024-1183]
• FIXED: Translation functions hostRequest and request fail when used together [ESB3024-1184]
• FIXED: Lua hashing functions do not accept binary data [ESB3024-1196]
• FIXED: Session Proxy has poor throughput [ESB3024-1197]
• FIXED: Configuration doesn’t handle nested Lua tables as argument to conditions [ESB3024-1218]

Deprecations from previous release

• None

System requirements

• The ACD Router requires a minimum CPU architecture level of x86-64-v2 due to inclusion of Oracle Linux 9 inside the container. While all modern CPUs support this archetecture level, virtual hypervisors may default to a CPU type that has more compatibility with older processors. If this minimum CPU architecture level is not attained the containers may refuse to start. See Operating System Compatibility and Building Red Hat Enterprise Linux 9 for the x86-64-v2 Microarchitecture Level for more information.

Known limitations

• The Telegraf metrics agent might not be able to read all relevant network interface data on ESB2001 releases older than 3.6.0. 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() until the issue is resolved on ESB2001.