Skip to content

Warn about refreshing grains after upgrading master to 3008.x - #88

Merged
twangboy merged 1 commit into
saltstack:mainfrom
twangboy:add_3008_warning
Jul 10, 2026
Merged

Warn about refreshing grains after upgrading master to 3008.x#88
twangboy merged 1 commit into
saltstack:mainfrom
twangboy:add_3008_warning

Conversation

@twangboy

@twangboy twangboy commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Salt 3008.0 restructured the master's minion data cache, splitting grains into a dedicated cache bank instead of a combined per-minion blob. Cached data from a pre-3008 master isn't migrated, so grain targeting (-G), mine.get, and cached pillar/grains lookups can return stale or empty results until minions re-sync.

Add a warning to the general upgrade procedure telling admins to run saltutil.refresh_grains on minions after upgrading a 3006.x/3007.x master to 3008.x.

(Fixes will close the ticket after merging. Relate will leave the ticket open
after merging.)

Merge requirements satisfied? (FOR REVIEWER USE ONLY)

  • Verify the pipeline is passing
  • Check rendered output to ensure formatting is correct for any special
    directives such as notes, tables, lists, and images

Salt 3008.0 restructured the master's minion data cache, splitting
grains into a dedicated cache bank instead of a combined per-minion
blob. Cached data from a pre-3008 master isn't migrated, so grain
targeting (-G), mine.get, and cached pillar/grains lookups can return
stale or empty results until minions re-sync.

Add a warning to the general upgrade procedure telling admins to run
saltutil.refresh_grains on minions after upgrading a 3006.x/3007.x
master to 3008.x.
@twangboy
twangboy merged commit 53aca6c into saltstack:main Jul 10, 2026
2 checks passed
@twangboy
twangboy deleted the add_3008_warning branch July 10, 2026 19:19
@twangboy twangboy self-assigned this Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant