From Fedora Project Wiki

Trafficserver 10.0

Summary

Upgrade Apache Traffic Server in Fedora to version 10.0.

Owner

Current status

Detailed Description

Apache Traffic Server in Fedora will be upgraded to v10.0.

More details on Traffic Server 10.x are available from the upstream What's New page. Notably, there is a breaking change in configuration file format, as ATS 10.x changes records.conf to records.yaml and does not support the previous configuration format. Many additional parameter changes and removals are also documented in the upstream Upgrading page.

Feedback

After discussion, it was agreed that records.config would be automatically updated to records.yaml (preserving the previous file as an .rpmsave) by a separate systemd unit trafficserver-10-update.service. This has been implemented.

Benefit to Fedora

Fedora includes the latest version of ATS, which will also be proposed for EPEL 10.

Scope

  • Proposal owners:
    • Upgrade trafficserver package to 10.x
    • Discuss propriety of running convert2yaml.py on records.config as part of post-install script

Upgrade/compatibility impact

Users will be upgraded to Traffic Server 10.x.

records.config will be automatically converted to records.yaml. Due to some fields changing or becoming deprecated, it is recommended that administrators review this automatically converted file.

How To Test

Install package, or upgrade from older release. Review systemd unit logs for warnings related to deprecated configuration options. Verify operation.

User Experience

In most cases, existing Traffic Server 9 installations will have configuration automatically updated when the systemd unit is next started. Due to some fields changing or becoming deprecated, it is recommended that administrators review this automatically converted file.

Dependencies

None outside of this Change.

Contingency Plan

  • Contingency mechanism: Roll back the trafficserver packages.
  • Contingency deadline: Beta freeze
  • Blocks release? No.

Documentation

N/A (not a System Wide Change)

Release Notes

Apache Traffic Server (trafficserver) in Fedora has been upgraded to version 10.x. The /etc/trafficserver/records.config file will be automatically updated to the new records.yaml format. Additional upgrade steps may be required if removed features or APIs are in use; please review the upstream documentation at https://docs.trafficserver.apache.org/en/10.0.x/release-notes/upgrading.en.html