Skip to content

MINOR: update the reassign-partition script results in docs#11845

Closed
showuon wants to merge 1 commit intoapache:trunkfrom
showuon:reassignPartitionUpdate
Closed

MINOR: update the reassign-partition script results in docs#11845
showuon wants to merge 1 commit intoapache:trunkfrom
showuon:reassignPartitionUpdate

Conversation

@showuon
Copy link
Copy Markdown
Member

@showuon showuon commented Mar 4, 2022

  1. Remove decommissioning brokers section
    When reading decommissioning brokers section in document, it makes me confused:
    image

The partition reassignment tool does not have the ability to automatically generate a reassignment plan for decommissioning brokers yet.

We should be able to auto generate a reassignment plan for decommissioning brokers via --generate argument

the reassignment needs to ensure that all the replicas are not moved from the decommissioned broker to only one other broker.

We already can move the replicas evenly across all the brokers

To make this process effortless, we plan to add tooling support for decommissioning brokers in the future.

This section is written in 2015, and I don't think we still have plan to support it (or we already supported)

Remove the section.

  1. Update the --generate replicas plan with current version.

Also, the example in the --generate command, it assign all the partition preferred leader to the same one (broker 5), which will confuse users to think this tool is unreliable. After running a test, I confirmed we can generate a plan evenly assigning the replicas across the brokers. Update it.
image

  1. Update the throttle updated command by adding --additional
    After KIP-455 and this PR, we have to provide --additional flag to allow change the throttle config.

  2. Update the reassign-partition script output with current version

Committer Checklist (excluded from commit message)

  • Verify design and implementation
  • Verify test coverage and CI build status
  • Verify documentation (including upgrade notes)

Comment thread docs/ops.html
Comment on lines -261 to +266
"partitions":[{"topic":"foo1","partition":2,"replicas":[1,2]},
{"topic":"foo1","partition":0,"replicas":[3,4]},
{"topic":"foo2","partition":2,"replicas":[1,2]},
{"topic":"foo2","partition":0,"replicas":[3,4]},
{"topic":"foo1","partition":1,"replicas":[2,3]},
{"topic":"foo2","partition":1,"replicas":[2,3]}]
"partitions":[{"topic":"foo1","partition":0,"replicas":[2,1]},
{"topic":"foo1","partition":1,"replicas":[1,3]},
{"topic":"foo1","partition":2,"replicas":[3,4]},
{"topic":"foo2","partition":0,"replicas":[4,2]},
{"topic":"foo2","partition":1,"replicas":[2,1]},
{"topic":"foo2","partition":2,"replicas":[1,3]}]
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update the current partition replica assignment with the one in my local env, which has preferred partition leader evenly distributed across all brokers.

Comment thread docs/ops.html
Comment on lines -272 to +277
"partitions":[{"topic":"foo1","partition":2,"replicas":[5,6]},
{"topic":"foo1","partition":0,"replicas":[5,6]},
{"topic":"foo2","partition":2,"replicas":[5,6]},
{"topic":"foo2","partition":0,"replicas":[5,6]},
"partitions":[{"topic":"foo1","partition":0,"replicas":[6,5]},
{"topic":"foo1","partition":1,"replicas":[5,6]},
{"topic":"foo2","partition":1,"replicas":[5,6]}]
{"topic":"foo1","partition":2,"replicas":[6,5]},
{"topic":"foo2","partition":0,"replicas":[5,6]},
{"topic":"foo2","partition":1,"replicas":[6,5]},
{"topic":"foo2","partition":2,"replicas":[5,6]}]
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the proposed reassignment with current script result, having the preferred partition leader evenly distributed.

Comment thread docs/ops.html
{"topic":"foo1","partition":1,"replicas":[5,6]},
{"topic":"foo2","partition":1,"replicas":[5,6]}]
}</code></pre>
Successfully started partition reassignments for foo1-0,foo1-1,foo1-2,foo2-0,foo2-1,foo2-2
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We only show Successfully started partition reassignments for... in current script. Update it.

Comment thread docs/ops.html
Comment on lines -307 to +305
Reassignment of partition [foo1,0] completed successfully
Reassignment of partition [foo1,1] is in progress
Reassignment of partition [foo1,2] is in progress
Reassignment of partition [foo2,0] completed successfully
Reassignment of partition [foo2,1] completed successfully
Reassignment of partition [foo2,2] completed successfully</code></pre>
Reassignment of partition [foo1,0] is completed
Reassignment of partition [foo1,1] is still in progress
Reassignment of partition [foo1,2] is still in progress
Reassignment of partition [foo2,0] is completed
Reassignment of partition [foo2,1] is completed
Reassignment of partition [foo2,2] is completed</code></pre>
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change the verify result with current script version

Comment thread docs/ops.html
Comment on lines -344 to -345
<h4 class="anchor-heading"><a id="basic_ops_decommissioning_brokers" class="anchor-link"></a><a href="#basic_ops_decommissioning_brokers">Decommissioning brokers</a></h4>
The partition reassignment tool does not have the ability to automatically generate a reassignment plan for decommissioning brokers yet. As such, the admin has to come up with a reassignment plan to move the replica for all partitions hosted on the broker to be decommissioned, to the rest of the brokers. This can be relatively tedious as the reassignment needs to ensure that all the replicas are not moved from the decommissioned broker to only one other broker. To make this process effortless, we plan to add tooling support for decommissioning brokers in the future.
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove decommissioning brokers section

Comment thread docs/ops.html
Comment on lines +374 to +375
<pre class="language-bash">$ bin/kafka-reassign-partitions.sh --bootstrap-server localhost:9092 --execute --reassignment-json-file bigger-cluster.json --additional --throttle 700000000
The inter-broker throttle limit was set to 700000000 B/s</code></pre>
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should add --additional argument in the script to change the throttle value.

@showuon
Copy link
Copy Markdown
Member Author

showuon commented Mar 4, 2022

@hachikuji @cmccabe , please take a look. Thanks.

@showuon
Copy link
Copy Markdown
Member Author

showuon commented Apr 21, 2022

@hachikuji @cmccabe , please take a look. Thanks.

1 similar comment
@showuon
Copy link
Copy Markdown
Member Author

showuon commented Apr 30, 2022

@hachikuji @cmccabe , please take a look. Thanks.

@showuon showuon changed the title MINOR: update the reassign-partition script results and argument MINOR: update the reassign-partition script results in docs May 19, 2022
@showuon
Copy link
Copy Markdown
Member Author

showuon commented May 19, 2022

@hachikuji @dajac , please take a look when available. Thanks.

@showuon
Copy link
Copy Markdown
Member Author

showuon commented May 31, 2022

@hachikuji @dajac , please take a look. Thank you.

@showuon
Copy link
Copy Markdown
Member Author

showuon commented Jun 2, 2022

Addressed in #12237

@showuon showuon closed this Jun 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants