Skip to content

DOCS-2607 / 26 / Docs 2607 update core migration, boot environment rollbacks, and ad config (by micjohnson777) - #4790

Merged
tonyriv3 merged 1 commit into
26from
DOCS-2607-26
Sep 9, 2026
Merged

DOCS-2607 / 26 / Docs 2607 update core migration, boot environment rollbacks, and ad config (by micjohnson777)#4790
tonyriv3 merged 1 commit into
26from
DOCS-2607-26

Conversation

@bugclerk

@bugclerk bugclerk commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

This PR adds information on rolling back boot environments where AD is joined and possible desynchronization issues that can happen. It updates the MigratePrep.md and MigratingFromCORE.md articles with AD related preparation and roll-back information, and updates the ManageBootEnviron.md and ConfigAD.md articles with rolling back and resolving desynchronization issue instructions.

Backport to 25.10 and 26

Thanks for contributing to TrueNAS documentation! By opening a Pull Request, you're acknowledging that your changes will be distributed under the Creative Commons 4.0 license.

Original PR: #4785
Jira URL: https://ixsystemsinc.atlassian.net/browse/DOCS-2607

…ntent

This PR updates the MigratePrep.md article with an AD health check step.
Updates MigratingFromCore.md by adding information on what to do if the user needs to revert back to CORE when AD is involved.
Adds a Rolling Back section in the ManageBootEnviron.md article to address possible desynchronization issues with AD if rollback is required, and how to avoid or resolve the issues. And adds a new snippet file used in two of the articles.

(cherry picked from commit be933a7)
@bugclerk
bugclerk requested a review from a team as a code owner September 9, 2026 12:57
@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown

Vale Style Guide Issues

📊 Summary: 169 issues found in changed files - 12 errors, 2 warnings, 155 suggestions

Changed files with issues:

content/Credentials/DirectoryServices/ConfigAD.md (61 issues)

  • Line 30 - suggestion: Spell out 'PAM' on first use
  • Lines 38, 50 - suggestion: Consider 'TrueNAS' instead of 'TrueNAS'
  • Lines 44, 69, 84, 128, 130, 136, 143 - suggestion: Use active voice instead of passive voice
  • Line 44 - error: Use 'Controller 1' instead of 'controller a'
  • Line 48 - error: Remove the spaces around ' — '.
  • Line 61 - suggestion: Spell out 'PDC' on first use
  • Line 61 - suggestion: Spell out 'FSMO' on first use
  • Lines 138, 140, 143, 148, 150, 154, 156, 180 - suggestion: Spell out 'IDMAP' on first use
  • Lines 138, 154 - error: Don't use 'Backend'. See the A-Z word list for details.
  • Lines 143, 192, 196 - suggestion: Spell out 'RID' on first use
  • Lines 143, 192 - suggestion: Spell out 'SID' on first use
  • Lines 143, 162, 199 - suggestion: Keep sentences under 30 words
  • Lines 180, 190, 196 - error: Don't use 'backend'. See the A-Z word list for details.
  • Line 180 - suggestion: Spell out 'UNIX' on first use
  • Lines 182, 184, 186, 192 - suggestion: Spell out 'UID' on first use
  • Lines 182, 184, 186, 192 - suggestion: Spell out 'GID' on first use
  • Line 182 - suggestion: Spell out 'SFU' on first use
  • Line 188 - suggestion: Spell out 'NSS' on first use
  • Line 194 - suggestion: Spell out 'TDB' on first use

content/GettingStarted/Migrate/MigratePrep.md (60 issues)

  • Line 19 - warning: Don't use end punctuation in headings.
  • Lines 26, 32 - suggestion: Avoid using first-person plural (we, us, our)
  • Lines 32, 60, 74, 108, 146, 159, 169, 200 - suggestion: Keep sentences under 30 words
  • Line 38 - error: Avoid contractions. Use 'have not' instead of 'haven't'.
  • Lines 43, 197 - error: Don't add '(s)' to a singular noun. Use plural instead.
  • Line 58 - suggestion: Use 'backup' instead of 'back up'
  • Lines 64, 149, 150, 179, 180, 197, 198, 200 - suggestion: Spell out 'UID' on first use
  • Lines 64, 149, 150, 179, 180, 197, 198, 200 - suggestion: Spell out 'GID' on first use
  • Lines 64, 89, 117, 168, 169 - suggestion: Use active voice instead of passive voice
  • Lines 83, 85 - suggestion: Spell out 'CORE' on first use
  • Line 99 - suggestion: Spell out 'LAGG' on first use
  • Line 115 - suggestion: Use 'backup' instead of 'Back up'
  • Line 128 - suggestion: Spell out 'ISO' on first use
  • Line 146 - warning: For a general audience, use 'address' rather than 'URL'.
  • Line 166 - suggestion: Use Oxford comma before 'and' in lists

content/GettingStarted/Migrate/MigratingFromCORE.md (23 issues)

  • Line 3 - suggestion: Spell out 'ISO' on first use
  • Lines 27, 143 - suggestion: Keep sentences under 30 words
  • Lines 40, 75, 143 - suggestion: Use active voice instead of passive voice
  • Line 78 - suggestion: Use 'login' instead of 'log in'
  • Line 78 - error: Use 'login' instead of 'log in'
  • Line 91 - suggestion: Spell out 'CHECK' on first use
  • Line 91 - suggestion: Spell out 'FOR' on first use
  • Line 93 - suggestion: Spell out 'FILE' on first use
  • Line 97 - suggestion: Spell out 'SAVE' on first use
  • Line 106 - suggestion: Spell out 'APPLY' on first use
  • Lines 116, 122 - suggestion: Use 'signin' instead of 'sign in'
  • Line 133 - suggestion: Spell out 'GRUB' on first use

content/SystemSettings/Boot/ManageBootEnviron.md (19 issues)

  • Lines 26, 35, 68, 77, 151 - suggestion: Use active voice instead of passive voice
  • Lines 57, 84, 150 - suggestion: Keep sentences under 30 words
  • Line 94 - suggestion: Use 'rollback' instead of 'roll back'
  • Line 95 - suggestion: Spell out 'CORE' on first use

static/includes/ADandBERollBacks.md (6 issues)

  • Line 3 - suggestion: Keep sentences under 30 words
  • Line 3 - suggestion: Use active voice instead of passive voice
  • Line 3 - suggestion: Use 'rollback' instead of 'roll back'
  • Line 9 - suggestion: Use Oxford comma before 'and' in lists

🔧 To fix: Review the issues above and update your documentation accordingly.

@tonyriv3
tonyriv3 merged commit 0be931b into 26 Sep 9, 2026
2 checks passed
@tonyriv3
tonyriv3 deleted the DOCS-2607-26 branch September 9, 2026 13:00
@bugclerk

bugclerk commented Sep 9, 2026

Copy link
Copy Markdown
Contributor Author

This PR has been merged and conversations have been locked.
If you would like to discuss more about this issue please use our forums or raise a Jira ticket.

@truenas truenas locked as resolved and limited conversation to collaborators Sep 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants