diff --git a/hadoop-common-project/hadoop-common/src/site/apt/CommandsManual.apt.vm b/hadoop-common-project/hadoop-common/src/site/apt/CommandsManual.apt.vm index 18114bbc3b..f4fabab726 100644 --- a/hadoop-common-project/hadoop-common/src/site/apt/CommandsManual.apt.vm +++ b/hadoop-common-project/hadoop-common/src/site/apt/CommandsManual.apt.vm @@ -306,9 +306,9 @@ Administration Commands Runs a cluster balancing utility. An administrator can simply press Ctrl-C to stop the rebalancing process. See - {{{../hadoop-hdfs/HdfsUserGuide.html#Rebalancer}Rebalancer}} for more details. + {{{../hadoop-hdfs/HdfsUserGuide.html#Balancer}Balancer}} for more details. - Usage: <<]>>> + Usage: <<] [-policy ]>>> *------------------------+-----------------------------------------------------------+ || COMMAND_OPTION | Description @@ -316,6 +316,11 @@ Administration Commands | -threshold | Percentage of disk capacity. This overwrites the | default threshold. *------------------------+-----------------------------------------------------------+ +| -policy | <<>> (default): Cluster is balanced if each datanode is balanced. \ + | <<>>: Cluster is balanced if each block pool in each datanode is balanced. +*------------------------+-----------------------------------------------------------+ + + Note that the <<>> policy is more strict than the <<>> policy. * <<>> diff --git a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt index 93adae633b..268276c12f 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt +++ b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt @@ -452,6 +452,8 @@ Release 2.5.0 - UNRELEASED HDFS-6545. Finalizing rolling upgrade can make NN unavailable for a long duration. (kihwal) + HDFS-6530. Fix Balancer documentation. (szetszwo) + OPTIMIZATIONS HDFS-6214. Webhdfs has poor throughput for files >2GB (daryn) diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/Federation.apt.vm b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/Federation.apt.vm index 45d43f19f6..3d27b8e218 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/Federation.apt.vm +++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/Federation.apt.vm @@ -287,13 +287,14 @@ HDFS Federation Policy could be: - * <<>> - this is the policy. This balances the storage at + * <<>> - this is the policy. This balances the storage at the datanode level. This is similar to balancing policy from prior releases. * <<>> - this balances the storage at the block pool level. Balancing at block pool level balances storage at the datanode level also. - Note that Balander only balances the data and does not balance the namespace. + Note that Balancer only balances the data and does not balance the namespace. + For the complete command usage, see {{{../hadoop-common/CommandsManual.html#balancer}balancer}}. ** Decommissioning diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsUserGuide.apt.vm b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsUserGuide.apt.vm index 9d6aeb97fb..443ace6bae 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsUserGuide.apt.vm +++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HdfsUserGuide.apt.vm @@ -77,7 +77,7 @@ HDFS Users Guide * <<>>: a utility to fetch DelegationToken and store it in a file on the local system. - * Rebalancer: tool to balance the cluster when the data is + * Balancer: tool to balance the cluster when the data is unevenly distributed among DataNodes. * Upgrade and rollback: after a software upgrade, it is possible @@ -316,7 +316,7 @@ HDFS Users Guide For command usage, see {{{../hadoop-common/CommandsManual.html#namenode}namenode}}. -* Rebalancer +* Balancer HDFS data might not always be be placed uniformly across the DataNode. One common reason is addition of new DataNodes to an existing cluster. @@ -338,7 +338,7 @@ HDFS Users Guide Due to multiple competing considerations, data might not be uniformly placed across the DataNodes. HDFS provides a tool for administrators that analyzes block placement and rebalanaces data across the DataNode. - A brief administrator's guide for rebalancer as a PDF is attached to + A brief administrator's guide for balancer is available at {{{https://issues.apache.org/jira/browse/HADOOP-1652}HADOOP-1652}}. For command usage, see {{{../hadoop-common/CommandsManual.html#balancer}balancer}}.