KR.ADMIN SET-MEMBER-STATUS

Overrides the status of a cluster member.

Syntax

KR.ADMIN SET-MEMBER-STATUS <member-id> <status>

Parameters

Parameter	Type	Description
`member-id`	string	Full 40-character hex member ID or a 4-character prefix. A prefix is resolved against currently registered members.
`status`	string	Target status. One of `RUNNING`, `UNAVAILABLE`, `STOPPED`, `UNKNOWN`. Case-insensitive.

Return Value

Simple string. Returns OK on success.

Behavior

Updates the status of the specified member and notifies the cluster so that other members observe the change promptly.

Typical workflow: set a member to STOPPED before calling REMOVE-MEMBER to cleanly decommission it.

Errors

Argument errors:

Error Code	Error message	Cause
`ERR`	`Invalid number of parameters`	-
`ERR`	`Unknown member status: '<value>'`	-
`ERR`	`Invalid memberId: <id>`	The value is neither a 40-character member ID nor a 4-character prefix.

Cluster errors:

Error Code	Error message	Cause
`ERR`	`cluster has not been initialized yet`	-
`ERR`	`Member: <member-id> not registered`	-
`ERR`	`Member: <member-id> not registered properly`	The member directory exists but contains no member data.
`ERR`	`no member found with prefix: <prefix>`	-
`ERR`	`more than one member found with prefix: <prefix>`	-

Examples

Mark a member as STOPPED:

127.0.0.1:3320> KR.ADMIN SET-MEMBER-STATUS 006cdc459c59e600c76494e8388857fc3cba2fa8 STOPPED
OK

Using a 4-character prefix:

127.0.0.1:3320> KR.ADMIN SET-MEMBER-STATUS 006c STOPPED
OK

Invalid status:

127.0.0.1:3320> KR.ADMIN SET-MEMBER-STATUS 006cdc459c59e600c76494e8388857fc3cba2fa8 some-status
(error) ERR Unknown member status: 'some-status'

Member not found:

127.0.0.1:3320> KR.ADMIN SET-MEMBER-STATUS a3f18b2e74d9c5601f82e4a7b390d612c8f7e149 RUNNING
(error) ERR Member: a3f18b2e74d9c5601f82e4a7b390d612c8f7e149 not registered