Status

Current state: Under DiscussionVoting

Discussion thread: https://lists.apache.org/thread/mwcljxdnyobthsszy4n2qr2tqcf9cxcf

...

The new script will accept an optional parameter `[--process-role`role], with the value indicating whether to kill Kafka broker processes or controller processes.

...

The new script will accept an optional parameter `[--node-id`id], with the value indicating the specific process, identified by its node id, that the user wishes to kill.

...

The change can be tested through command line. 

Rejected Alternatives

One rejected alternatives is using an optional field "[--required-config <name = value>]" to allow users to stop Kafka processes with any arbitrary name = value based on the node's configuration file. This argument gives the users freedom to choose any field in the configuration file to indicate the process they want to kill. However, upon discussion, we think this approach based on configs is a bit too open-ended and not very user friendly. Therefore, we decided to simply provide flags for the things a user may care about the most, i.e, two specific and mutually exclusive parameters process-role  and node-id . We agree that it is more user-friendly than the --required-config  arg, and it comes at the possible expense of generality.