| Linux |
/opt/couchbase/bin/couchbase-cli
|
| Windows |
C:\Program Files\couchbase\server\bin\couchbase-cli.exe
|
| Mac OS X |
/Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/couchbase-cli
|
このツールは、Couchbase Serverクラスタ、ノードおよびバケットのさまざまな管理操作へのアクセスを提供します。基本的な使用形式は次のとおりです。
couchbase-cli COMMAND CLUSTER [OPTIONS]ここで：
COMMANDには、のコマンドを指定します。表7.3「管理 —Couchbaseのツールコマンド」
CLUSTERは、クラスタ仕様です。次のいずれかを使用できます。
--cluster=HOST[:PORT]または短縮形：
-c HOST[:PORT]OPTIONSは、指定無しか、多くのオプションが指定出来ます。
表7.3 管理 —Couchbaseのツールコマンド
| コマンド | 説明 |
|---|---|
server-list
| クラスタ内のすべてのサーバーを一覧表示します。 |
server-info
| あるサーバー上の詳細を表示します。 |
server-add
| クラスタに1つ以上のサーバを追加します。 |
server-readd
| クラスタにフェイルオーバしたサーバを再追加します。 |
rebalance
| クラスタリバランスを開始します。 |
rebalance-stop
| 実行中のリバランスを停止します。 |
rebalance-status
| 実行中のリバランスの状態を示します。 |
failover
| １つまたは複数のサーバをフェイルオーバします。 |
cluster-init
| クラスタのユーザ名、パスワード、ポートを設定します。 |
node-init
| ノードの固有パラメータを設定します。 |
bucket-list
| クラスタ内のすべてのバケットの一覧を表示します。 |
bucket-create
| クラスタに新しいバケットを追加します。 |
bucket-edit
| 既存のバケットを修正します。 |
bucket-delete
| 既存のバケットを削除します。 |
bucket-flush
| 指定したバケットをフラッシュします。 |
help
| 使用方法/ヘルプと例を示します。 |
表7.4 管理 —Couchbaseのツール標準オプション
| オプション | コマンド | 説明 |
|---|---|---|
--user=USERNAME,-u USERNAME | クラスタにアクセスするための管理者ユーザ名 | |
--password=PASSWORD,-p PASSWORD | クラスタにアクセスするための管理者パスワード | |
--output=KIND,-o KIND | 出力の種類として、JSON形式のjsonか、コマンドのネイティブ形式であるstandardのいづれかを指定 | |
--debug,-d | デバッグ情報を出力 | |
--server-add=HOST[:PORT]
| server-add,server-readd,rebalance | 追加するサーバ |
--server-add-username=USERNAME
| server-add,server-readd,rebalance | 追加するサーバの管理者ユーザ名 |
--server-add-password=PASSWORD
| server-add,server-readd,rebalance | 追加するサーバの管理者パスワード |
--server-remove=HOST[:PORT]
|
rebalance
| 削除するサーバ |
--server-failover=HOST[:PORT]
|
failover
| フェイルオーバするサーバ |
--cluster-init-username=USER
|
cluster-init
| 新しい管理者ユーザ名 |
--cluster-init-password=PASSWORD
|
cluster-init
| 新しい管理者パスワード（少なくとも6文字でなければなりません） |
--cluster-init-port=PORT
|
cluster-init
| 新しいクラスタポート |
--cluster-init-ramsize=300
|
cluster-init
| 新しいRAMの割当 |
--bucket=BUCKETNAME
|
bucket*
| バケットの指定 |
--bucket-type=TYPE
|
bucket*
| Memcached もしくはCouchbase |
--bucket-port=PORT
|
bucket*
| ASCIIプロトコルと認証なしをサポート |
--bucket-password=PASSWORD
|
bucket*
| バケットポート以外の標準的なポート |
--bucket-ramsize=RAMSIZEMB
|
bucket*
| RAMの割当（MB） |
--bucket-replica=COUNT
|
bucket*
| レプリケーション数 |
例：
クラスタ内のサーバ一覧：
shell> couchbase-cli server-list -c 192.168.0.1:8091サーバ情報：
shell> couchbase-cli server-info -c 192.168.0.1:8091クラスタにノードを追加、但し、リバランスはしない：
shell> couchbase-cli server-add -c 192.168.0.1:8091 \ --server-add=192.168.0.2:8091
クラスタにノードを追加し、リバランスする：
shell> couchbase-cli rebalance -c 192.168.0.1:8091 \ --server-add=192.168.0.2:8091
クラスタからノードを削除し、リバランスする：
shell> couchbase-cli rebalance -c 192.168.0.1:8091 \ --server-remove=192.168.0.2:8091
クラスタからノードを削除、および追加し、リバランスする：
shell> couchbase-cli rebalance -c 192.168.0.1:8091 \ --server-remove=192.168.0.2 \ --server-add=192.168.0.4
実行中のリバランスを停止：
shell> couchbase-cli rebalance-stop -c 192.168.0.1:8091shell> couchbase-cli cluster-init -c 192.168.0.1:8091 \ --cluster-init-username=Administrator \ --cluster-init-password=password \ --cluster-init-port=8080 \ --cluster-init-ramsize=8192
クラスタ内のバケット一覧：
shell> couchbase-cli bucket-list -c 192.168.0.1:8091専用ポートで新しいcouchbaseのバケットを作成：
shell> couchbase-cli bucket-create -c 192.168.0.1:8091 --bucket=test_bucket \ --bucket-type=couchbase --bucket-port=11222 --bucket-ramsize=200 \ --bucket-replica=1
新しいsasl memcachedバケットを作成：
shell> couchbase-cli bucket-create -c 192.168.0.1:8091 --bucket=test_bucket \ --bucket-type=memcached--bucket-password=password \ --bucket-ramsize=200
専用ポートバケットを変更：
shell> couchbase-cli bucket-edit -c 192.168.0.1:8091 --bucket=test_bucket \ --bucket-port=11222 --bucket-ramsize=400
バケットを削除：
shell> couchbase-cli bucket-delete -c 192.168.0.1:8091 --bucket=test_bucket