Skip to content

Add traffic_ctl cache clear command - #13418

Merged
bneradt merged 1 commit into
apache:masterfrom
bneradt:traffic-ctl-cache-clear
Aug 4, 2026
Merged

bneradt merged 1 commit into
apache:masterfrom
bneradt:traffic-ctl-cache-clear

Conversation

@bneradt

@bneradt bneradt commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Cache resets currently require restarting Traffic Server or manually
changing the cache generation. This complicates repeatable workload
comparisons and their automation.

This adds a traffic_ctl cache clear command backed by a restricted
JSON-RPC method that advances the global HTTP cache generation. This
also documents the logical purge semantics and exercises the command in
the cache-generation AuTest.

Fixes: #9399

Cache resets currently require restarting Traffic Server or manually
changing the cache generation. This complicates repeatable workload
comparisons and their automation.

This adds a traffic_ctl cache clear command backed by a restricted
JSON-RPC method that advances the global HTTP cache generation. This
also documents the logical purge semantics and exercises the command in
the cache-generation AuTest.

Fixes: apache#9399
@bneradt bneradt added this to the 11.0.0 milestone Jul 21, 2026
Copilot AI review requested due to automatic review settings July 21, 2026 23:06
@bneradt bneradt self-assigned this Jul 21, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@bneradt
bneradt merged commit 2d9d666 into apache:master Aug 4, 2026
15 checks passed
@bneradt
bneradt deleted the traffic-ctl-cache-clear branch August 4, 2026 19:59
@github-project-automation github-project-automation Bot moved this to For v10.2.0 in ATS v10.2.x Aug 10, 2026
cmcfarlen pushed a commit that referenced this pull request Aug 10, 2026
Cache resets currently require restarting Traffic Server or manually
changing the cache generation. This complicates repeatable workload
comparisons and their automation.

This adds a traffic_ctl cache clear command backed by a restricted
JSON-RPC method that advances the global HTTP cache generation. This
also documents the logical purge semantics and exercises the command in
the cache-generation AuTest.

Fixes: #9399
(cherry picked from commit 2d9d666)
@cmcfarlen cmcfarlen moved this from For v10.2.0 to Picked v10.2.0 in ATS v10.2.x Aug 10, 2026
@cmcfarlen cmcfarlen modified the milestones: 11.0.0, 10.2.0 Aug 10, 2026
@cmcfarlen

Copy link
Copy Markdown
Contributor

Cherry-picked to the 10.2.x branch as 0f4a5da for the 10.2.0 release.

cmcfarlen added a commit to cmcfarlen/trafficserver that referenced this pull request Aug 10, 2026
Picks up apache#13328 (shared-memory cache directory for fast restart) and
apache#13418 (traffic_ctl cache clear). The shm directory gets its own section
since it is a new opt-in feature with four new records and a traffic_ctl
subcommand.
cmcfarlen added a commit to cmcfarlen/trafficserver that referenced this pull request Aug 10, 2026
Picks up apache#13328 (shared-memory cache directory for fast restart) and
apache#13418 (traffic_ctl cache clear). The shm directory gets its own section
since it is a new opt-in feature with four new records and a traffic_ctl
subcommand.
cmcfarlen added a commit that referenced this pull request Aug 10, 2026
* Add 10.2.0 changelog and release notes

Generate CHANGELOG-10.2.0 from the 10.2.0 milestone and document the
release in whats-new and upgrading. The connect retry change (#13102)
is called out as a necessary incompatible change, since the retry
limits were not previously applied according to origin state.

* Address review: fix PR count and token_key markup

The PR count was 655 before five stale milestone entries were dropped;
the changelog has 650. Use :ts:cv: for
proxy.config.quic.server.token_key.filename, which is documented on
10.2.x even though it is absent from master, where it was first checked.

* Add late 10.2.x additions to changelog and release notes

Picks up #13328 (shared-memory cache directory for fast restart) and
#13418 (traffic_ctl cache clear). The shm directory gets its own section
since it is a new opt-in feature with four new records and a traffic_ctl
subcommand.

* Add July 2026 security fixes to changelog and release notes

The Release 2 security bundle (#13452) landed directly on 10.2.x without
public PRs, so those commits never appear in a milestone. Source them
from the commit range with the changelog tool's git-range mode and append
them as bare subjects, matching how CHANGELOG-10.1.4 lists them. Link
the advisory from whats-new for the CVE mapping.

* Add #13352, #13517 and #13523 to the changelog

Three late bug fixes on 10.2.x. All are fixes with no new configuration,
metrics or API surface, so only the changelog and the commit/PR counts
change.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Picked v10.2.0

Development

Successfully merging this pull request may close these issues.

Provide ability to clear cache with traffic_ctl

3 participants