Skip to content

docs: add THOR 10 to 11 upgrade guide - #206

Closed
Neo23x0 wants to merge 3 commits into
masterfrom
codex/thor11-upgrade-guide
Closed

Neo23x0 wants to merge 3 commits into
masterfrom
codex/thor11-upgrade-guide

Conversation

@Neo23x0

@Neo23x0 Neo23x0 commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Release hold: merge only when THOR 11 is released. Keep this pull request in draft until the release and engineering review are complete.

Adds an upgrade guide to the THOR 10 manual on master, linked from the contents, Update, and Configuration chapters. It explains how to obtain a fresh TechPreview package or upgrade an existing installation, and how to replace an old thor.yml with --reinitialize-config before reapplying custom settings.

The chapter covers renamed options, changed units and defaults, the new thor.yml.defaults reference, an estimated 40% increase in memory usage, and the --help short, --help long, and --help detailed options. In particular, it calls out the changed meaning of bare minmem values and the separate Info reporting threshold.

It also documents JSONL with JSON log format v3 as the new default, the explicit --text option, and possible differences in text logs reconstructed from THOR 11 objects. A separate section covers changed Thunderstorm response structures and the need to validate service clients before upgrading. The existing Output Options and Thunderstorm deployment sections link to this guidance.

Before merging at the THOR 11 release

  • Incorporate engineering feedback and any additional migration requirements.
  • Confirm the release upgrade/download commands.
  • Confirm old-configuration warning behavior and handling of max_file_size_intense.
  • Validate the memory estimate and documented defaults against the release build.
  • Validate JSON/parser and Thunderstorm response migration guidance against the release build and add any further deployment-specific changes.

Validation

  • Sphinx HTML build passes with warnings treated as errors.
  • git diff --check passes.
  • Generated HTML checks confirm the tables, cross-references, and hidden editorial notes.
  • Both external reference links in the upgrade chapter pass the targeted link check.
  • The full manual link check previously found an existing ASGARD helper-script 404 and timeouts for existing Splunkbase and VALHALLA links.

@Neo23x0 Neo23x0 added the documentation Improvements or additions to documentation label Sep 30, 2026
@phantinuss
phantinuss changed the base branch from master to v11 October 14, 2026 09:14
@phantinuss
phantinuss changed the base branch from v11 to master October 14, 2026 09:15
@phantinuss

Copy link
Copy Markdown
Contributor

reimplemented in #220. This PR has the wrong merge base.

@phantinuss phantinuss closed this Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants