Skip to content

HDDS-13229. [Doc] Fix incorrect CLI argument order in OM upgrade docs #8598

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jojochuang merged 4 commits into from
Jun 10, 2025
Merged

HDDS-13229. [Doc] Fix incorrect CLI argument order in OM upgrade docs #8598

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2133d47
HDDS-13229. [Doc] Fix incorrect CLI argument order in OM upgrade docs
smengcl Jun 10, 2025
3c90ff0
Update hadoop-hdds/docs/content/design/omprepare.md
jojochuang Jun 10, 2025
cb44a0e
Update hadoop-hdds/docs/content/design/omprepare.md
jojochuang Jun 10, 2025
1c993ff
Update hadoop-hdds/docs/content/design/upgrade-dev-primer.md
jojochuang Jun 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions hadoop-hdds/docs/content/design/omprepare.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,19 +42,20 @@ author: Aravindan Vijayan
# Usage

## How do you prepare an Ozone manager quorum
ozone admin om -id=<om-sevice-id> prepare


ozone admin om prepare -id=<om-service-id>

This leaves the Ozone manager in a state where it cannot accept new writes.

## How do you cancel a "prepared" Ozone manager quorum

In the case of a cancelled upgrade, the OM can be brought out off the
prepared state by using the following command.
ozone admin om -id=<om-sevice-id> cancelprepare

ozone admin om cancelprepare -id=<om-service-id>

# Link

https://issues.apache.org/jira/secure/attachment/13015491/OM%20Prepare%20Upgrade.pdf

https://issues.apache.org/jira/secure/attachment/13015411/OM%20Prepare%20Upgrade%2CDowngrade.jpg
https://issues.apache.org/jira/secure/attachment/13015411/OM%20Prepare%20Upgrade%2CDowngrade.jpg
8 changes: 4 additions & 4 deletions hadoop-hdds/docs/content/design/upgrade-dev-primer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,12 +84,12 @@ An action run once during finalization of layout version (feature). This action
Used to flush all transactions to disk, take a DB snapshot, and purge the logs, leaving Ratis in a clean state without unapplied log entries. This prepares the OM for upgrades/downgrades so that no request in the log is applied to the database in the old version of the code in one OM, and the new version of the code in another OM.

To prepare an OM quorum, run
ozone admin om -id=<om-sevice-id> prepare

ozone admin om prepare -id=<om-sevice-id>

To cancel preparation of an OM quorum, run
ozone admin om -id=<om-sevice-id> cancelprepare

ozone admin om cancelprepare -id=<om-service-id>


## When do you bring in a change as a Layout feature?
Expand Down