From 1bc974d536788dd00f651554861d32360bef3a70 Mon Sep 17 00:00:00 2001 From: Gyuho Lee Date: Mon, 5 Mar 2018 10:52:59 -0800 Subject: [PATCH] etcdctl: highlight "defrag" command caveats Signed-off-by: Gyuho Lee --- etcdctl/README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/etcdctl/README.md b/etcdctl/README.md index 52f78d9f2..9f8978317 100644 --- a/etcdctl/README.md +++ b/etcdctl/README.md @@ -876,10 +876,11 @@ If NOSPACE alarm is present: ### DEFRAG [options] -DEFRAG defragments the backend database file for a set of given endpoints while etcd is running, or directly defragments an -etcd data directory while etcd is not running. When an etcd member reclaims storage space from deleted and compacted keys, the -space is kept in a free list and the database file remains the same size. By defragmenting the database, the etcd member -releases this free space back to the file system. +DEFRAG defragments the backend database file for a set of given endpoints while etcd is running, or directly defragments an etcd data directory while etcd is not running. When an etcd member reclaims storage space from deleted and compacted keys, the space is kept in a free list and the database file remains the same size. By defragmenting the database, the etcd member releases this free space back to the file system. + +**Note that defragmentation to a live member blocks the system from reading and writing data while rebuilding its states.** + +**Note that defragmentation request does not get replicated over cluster. That is, the request is only applied to the local node. Specify all members in `--endpoints` flag.** #### Options