Manage server groups
couchbase-cli group-manage [--cluster <url>] [--username <user>]
[--password <password>] [--create] [--delete] [--list] [--rename <group>]
[--move-servers] [--group-name <name>] [--from-group <name>]
[--to-group <name>]
This command is used to manage server groups in a Couchbase cluster. When moving servers between groups it is possible that you may need to rebalance the cluster since the cluster topology may be changing. You should always run man:couchbase-cli-rebalance[1] after running this command.
- --create
-
Creates a new server group.
- --delete
-
Deletes a server group.
- --list
-
Lists all server groups.
- --rename <group>
-
Renames a server group. It takes the new name of the group as a parameter.
- --move-servers <server_list>
-
A list of servers to move between groups.
- --group-name <name>
-
The name of the server group.
- --from-group <name>
-
The group to move servers from.
- --to-group <name>
-
The group to move servers to. This group must already exists.
To create a new server group called "rack1" run the following command.
$ couchbase-cli group-manage -c 192.168.1.5 -u Administrator \ -p password --create --group-name rack1
To rename the server group "rack1" to "rack2" run the following command.
$ couchbase-cli group-manage -c 192.168.1.5 -u Administrator \ -p password --group-name rack1 --rename rack2
To list all of the server groups in a cluster run the following command.
$ couchbase-cli group-manage -c 192.168.1.5 -u Administrator \ -p password --list
To delete the server group "rack2" run the following command.
$ couchbase-cli group-manage -c 192.168.1.5 -u Administrator \ -p password --delete --group-name rack2
To move the servers 192.168.1.5 and 192.168.1.6 from server group "rack3" to server group "rack4" run the following command.
$ couchbase-cli group-manage -c 192.168.1.5 -u Administrator \ -p password --move-servers 192.168.1.5,192.168.1.6 --from-group rack3 \ --to-group rack4
man:couchbase-cli-rebalance[1], man:couchbase-cli-server-add[1]