Skip to content

Docs: Review and Update Drive Replacement Process #427

@rstark-verge

Description

@rstark-verge

Summary

Review and update the existing drive replacement documentation to ensure accuracy, completeness, and alignment with current VergeOS behavior.

Type

How-to Guide (Review/Update)

Existing Documentation

Suggested Review Areas

  • Audience: System administrators managing physical hardware in VergeOS clusters
  • Prerequisites: Familiarity with VergeOS UI, maintenance mode, vSAN concepts

Key sections to review/verify:

  • Scenario 1 (Failed/Missing drive) steps are accurate with current UI
  • Scenario 2 (Proactive replacement) steps match current workflow — particularly the Close/Take Offline → Format → Initialize sequence
  • LED identification steps reflect current diagnostics UI behavior (LED Status field labels, menu options)
  • "During the Repair Process" warnings are current and complete
  • Troubleshooting section covers known failure modes (e.g., Replace Drive option grayed out, drive not detected after insertion)
  • Consider consolidating or updating the KB article (currently pinned to 4.12.6) — either update version reference or redirect to main procedure
  • Verify screenshots are current and match the UI
  • Add tags/categories to the main doc (currently empty)

Context

Requested via support interaction. The main procedure doc appears recently updated, but the knowledge base article references a very old version (4.12.6) and may confuse customers. A holistic review pass would ensure consistency across both pages.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions