HBASE-13129 Add troubleshooting hints around WAL retention from replication

Signed-off-by: Jonathan Hsieh <jon@cloudera.com>
Signed-off-by: Sean Busbey <busbey@apache.org>
This commit is contained in:
Misty Stanley-Jones 2015-12-18 12:40:00 -08:00 committed by Sean Busbey
parent 58177c103f
commit dbdfd8e8d1
2 changed files with 13 additions and 5 deletions

View File

@ -1361,7 +1361,10 @@ list_peers:: list all replication relationships known by this cluster
enable_peer <ID>::
Enable a previously-disabled replication relationship
disable_peer <ID>::
Disable a replication relationship. HBase will no longer send edits to that peer cluster, but it still keeps track of all the new WALs that it will need to replicate if and when it is re-enabled.
Disable a replication relationship. HBase will no longer send edits to that
peer cluster, but it still keeps track of all the new WALs that it will need
to replicate if and when it is re-enabled. WALs are retained when enabling or disabling
replication as long as peers exist.
remove_peer <ID>::
Disable and remove a replication relationship. HBase will no longer send edits to that peer cluster or keep track of WALs.
enable_table_replication <TABLE_NAME>::
@ -1501,6 +1504,8 @@ The default behavior is augmented so that if a log is past its TTL, the cleaning
If the log is not found in any queues, the log will be deleted.
The next time the cleaning process needs to look for a log, it starts by using its cached list.
NOTE: WALs are saved when replication is enabled or disabled as long as peers exist.
[[rs.failover.details]]
==== Region Server Failover

View File

@ -859,11 +859,14 @@ Snapshots::
HBase Shell commands for managing them. For more information, see <<ops.snapshots>>.
WAL::
Write-ahead logs (WALs) are stored in subdirectories of `/hbase/.logs/`, depending
on their status. Already-processed WALs are stored in `/hbase/.logs/oldWALs/` and
corrupt WALs are stored in `/hbase/.logs/.corrupt/` for examination.
If the size of any subdirectory of `/hbase/.logs/` is growing, examine the HBase
Write-ahead logs (WALs) are stored in subdirectories of the HBase root directory,
typically `/hbase/`, depending on their status. Already-processed WALs are stored
in `/hbase/oldWALs/` and corrupt WALs are stored in `/hbase/.corrupt/` for examination.
If the size of one of these subdirectories is growing, examine the HBase
server logs to find the root cause for why WALs are not being processed correctly.
+
If you use replication and `/hbase/oldWALs/` is using more space than you expect,
remember that WALs are saved when replication is disabled, as long as there are peers.
*Do not* manage WALs manually via HDFS.