HDFS-7752. Improve description for "dfs.namenode.num.extra.edits.retained" and "dfs.namenode.num.checkpoints.retained" properties on hdfs-default.xml. Contributed by Wellington Chevreuil.
(cherry picked from commit b9a17909ba
)
This commit is contained in:
parent
eaeaf80d39
commit
5c2c6b00dd
|
@ -39,6 +39,11 @@ Release 2.7.0 - UNRELEASED
|
||||||
|
|
||||||
IMPROVEMENTS
|
IMPROVEMENTS
|
||||||
|
|
||||||
|
HDFS-7752. Improve description for
|
||||||
|
"dfs.namenode.num.extra.edits.retained"
|
||||||
|
and "dfs.namenode.num.checkpoints.retained" properties on
|
||||||
|
hdfs-default.xml (Wellington Chevreuil via harsh)
|
||||||
|
|
||||||
HDFS-7055. Add tracing to DFSInputStream (cmccabe)
|
HDFS-7055. Add tracing to DFSInputStream (cmccabe)
|
||||||
|
|
||||||
HDFS-7186. Document the "hadoop trace" command. (Masatake Iwasaki via Colin
|
HDFS-7186. Document the "hadoop trace" command. (Masatake Iwasaki via Colin
|
||||||
|
|
|
@ -852,9 +852,9 @@
|
||||||
<property>
|
<property>
|
||||||
<name>dfs.namenode.num.checkpoints.retained</name>
|
<name>dfs.namenode.num.checkpoints.retained</name>
|
||||||
<value>2</value>
|
<value>2</value>
|
||||||
<description>The number of image checkpoint files that will be retained by
|
<description>The number of image checkpoint files (fsimage_*) that will be retained by
|
||||||
the NameNode and Secondary NameNode in their storage directories. All edit
|
the NameNode and Secondary NameNode in their storage directories. All edit
|
||||||
logs necessary to recover an up-to-date namespace from the oldest retained
|
logs (stored on edits_* files) necessary to recover an up-to-date namespace from the oldest retained
|
||||||
checkpoint will also be retained.
|
checkpoint will also be retained.
|
||||||
</description>
|
</description>
|
||||||
</property>
|
</property>
|
||||||
|
@ -863,8 +863,15 @@
|
||||||
<name>dfs.namenode.num.extra.edits.retained</name>
|
<name>dfs.namenode.num.extra.edits.retained</name>
|
||||||
<value>1000000</value>
|
<value>1000000</value>
|
||||||
<description>The number of extra transactions which should be retained
|
<description>The number of extra transactions which should be retained
|
||||||
beyond what is minimally necessary for a NN restart. This can be useful for
|
beyond what is minimally necessary for a NN restart.
|
||||||
audit purposes or for an HA setup where a remote Standby Node may have
|
It does not translate directly to file's age, or the number of files kept,
|
||||||
|
but to the number of transactions (here "edits" means transactions).
|
||||||
|
One edit file may contain several transactions (edits).
|
||||||
|
During checkpoint, NameNode will identify the total number of edits to retain as extra by
|
||||||
|
checking the latest checkpoint transaction value, subtracted by the value of this property.
|
||||||
|
Then, it scans edits files to identify the older ones that don't include the computed range of
|
||||||
|
retained transactions that are to be kept around, and purges them subsequently.
|
||||||
|
The retainment can be useful for audit purposes or for an HA setup where a remote Standby Node may have
|
||||||
been offline for some time and need to have a longer backlog of retained
|
been offline for some time and need to have a longer backlog of retained
|
||||||
edits in order to start again.
|
edits in order to start again.
|
||||||
Typically each edit is on the order of a few hundred bytes, so the default
|
Typically each edit is on the order of a few hundred bytes, so the default
|
||||||
|
|
Loading…
Reference in New Issue