[ 
https://issues.apache.org/jira/browse/HBASE-7410?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13619258#comment-13619258
 ] 

Sergey Shelukhin commented on HBASE-7410:
-----------------------------------------

First paragraph initially says that the only ways yto do X are these, then 
discusses snapshots. Maybe it should qualify the previous methods differently, 
like as "the previously discussed".
I think it would be even better if the first paragraph could start with what 
snapshots allow you to do and only mention the disadvantages of the other stuff 
after that.

bq.   the the region server 
dup

bq. HBase Snapshots allow you to take a snapshot of the table without too much 
impact and cloning/restoring 
*a* table, and "clone/restore"?

bq. set to true the <varname>hbase.snapshot.enabled</varname> property.
"set the ... to true"   

bq. that is enable or disabled.
"enabled"; or "regardless of whether it is enabled or disabled".

bq. involve any data-copy operation
any data copying?

bq.  but after a compaction, or table deletion the files needed by the snapshot 
are moved to an archive directory instead of being deleted.
Is user supposed to know what this means? I personally have hard time 
understanding the implications :)

bq. doesn't involve data copies
"data copying"?

bq. restore operation require
requires

bq.  snapshot state
snapshotted state/the state at the time when the snapshot was taken?

bq. stop replication and redo the bootstra
This sentence doesn't appear to be fi :)

bq. The ExportSnapshot tool allows to copy all the data related to a snapshot 
(hfiles, logs, snapshot metadata) and copy it to another cluster.
"allows one" or remove allows and just say "copies"?
Double "copy". Also, from admin's perspective, should it just say that the tool 
copies entire snapshot to another cluster, and not enumerate the files?

bq. The tool execute
executes

bq. and since it works at file-system level the hbase cluster can be offline.
Maybe "does not have to be online" to avoid potential confusion would be better.

                
> [snapshots] add snapshot/clone/restore/export docs to ref guide
> ---------------------------------------------------------------
>
>                 Key: HBASE-7410
>                 URL: https://issues.apache.org/jira/browse/HBASE-7410
>             Project: HBase
>          Issue Type: Improvement
>          Components: documentation, snapshots
>    Affects Versions: hbase-6055
>            Reporter: Jonathan Hsieh
>            Priority: Blocker
>             Fix For: 0.95.0
>
>         Attachments: HBASE-7410-v0.patch
>
>
> This will include additions to the ref guide about the different operations 
> provided and how to use them.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to