Skip to content

ES install: add cgroup v2 compatibility warning for affected versions - #7983

Open
kunisen wants to merge 5 commits into
mainfrom
kunisen-docpr-stl-1913
Open

ES install: add cgroup v2 compatibility warning for affected versions#7983
kunisen wants to merge 5 commits into
mainfrom
kunisen-docpr-stl-1913

Conversation

@kunisen

@kunisen kunisen commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a cgroup v2 compatibility warning for Elasticsearch versions 8.0.0–8.4.3 and 7.15.1–7.17.6, which fail to start on Linux hosts running pure cgroup v2 due to a bug in the bundled JDK.

This PR adds a new ### Linux cgroups version subsection to the Supported operating systems and JVMs section of the Install Elasticsearch page, and a corresponding bullet in the Important system configuration checklist, both pointing to the KB article for detailed guidance.

Related: elastic/support-tech-lead#1913

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

Tool(s) and model(s) used: Claude (Anthropic) via Cowork

@kunisen
kunisen requested a review from a team as a code owner August 18, 2026 05:09
@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@kunisen
kunisen requested review from gigerdo and jowiho August 18, 2026 05:10
@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs Style Checker (Vale)

Summary: 2 suggestions found

💡 Suggestions (2): Optional style improvements. Apply when helpful.
File Line Rule Message
deploy-manage/deploy/self-managed/installing-elasticsearch.md 114 Elastic.Wordiness Consider using 'sometimes' instead of 'In some cases'.
deploy-manage/deploy/self-managed/installing-elasticsearch.md 114 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@kunisen kunisen self-assigned this Aug 18, 2026
@kunisen kunisen added supportability ability enable self-service or support of product Team:Admin Issues owned by the Admin Docs Team docs labels Aug 18, 2026

@github-actions github-actions Bot 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.

Docs review summary

Focus areas

  • Style and clarity: Two new sentences use literal "Elasticsearch" instead of the {{es}} substitution used consistently throughout both pages — flagged inline with suggested fixes. Also flagged unnecessary "Note that" preamble.
  • Jargon: None found — "cgroups" and "JDK" are used in context with a linked man-page reference.
  • Frontmatter and applies_to: No frontmatter changes in this PR; existing applies_to/products metadata untouched and still valid for both files.
  • Content type fit: Both are how-to/reference pages; the new content is a short warning bullet/subsection consistent with surrounding structure. No mismatch.
  • Contradictions: No contradictions found — the new cgroups v2 warning is additive and consistent with Elastic's published KB guidance on this bug.
  • Parent issue satisfaction: Satisfied — the PR adds the requested warning in both the installation page and the system configuration checklist, each linking to the KB article.

Nits

  • Vale flagged several pre-existing "may" → "can/might" and "In some cases" → "sometimes" suggestions in installing-elasticsearch.md; these are in unchanged surrounding text and not required for this PR.

Notes

  • Reviewed only the two eligible changed markdown files per repo-wide-markdown scope.

Generated by Docs review agent for #7983 · sonnet50 · 31.6 AIC · ⌖ 6.64 AIC · ⊞ 17.1K

Comment thread deploy-manage/deploy/self-managed/installing-elasticsearch.md Outdated
Comment thread deploy-manage/deploy/self-managed/important-system-configuration.md Outdated
kunisen and others added 4 commits August 18, 2026 14:21
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs supportability ability enable self-service or support of product Team:Admin Issues owned by the Admin Docs Team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant