HDFS命令指南

末蓝、 2022-02-18 10:07 544阅读 0赞

# HDFS命令指南 #

*  概览
 *  [User Commands][]
    
     *  [classpath][]
     *  [dfs][]
     *  [envvars][]
     *  [fetchdt][]
     *  [fsck][]
     *  [getconf][]
     *  [groups][]
     *  [httpfs][]
     *  [lsSnapshottableDir][]
     *  [jmxget][]
     *  [oev][]
     *  [oiv][]
     *  [oiv\_legacy][oiv_legacy]
     *  [snapshotDiff][]
     *  [version][]
 *  [Administration Commands][]
    
     *  [balancer][]
     *  [cacheadmin][]
     *  [crypto][]
     *  [datanode][]
     *  [dfsadmin][]
     *  [dfsrouter][]
     *  [dfsrouteradmin][]
     *  [diskbalancer][]
     *  [ec][]
     *  [haadmin][]
     *  [journalnode][]
     *  [mover][]
     *  [namenode][]
     *  [nfs3][]
     *  [portmap][]
     *  [secondarynamenode][]
     *  [storagepolicies][]
     *  [zkfc][]
 *  [Debug Commands][]
    
     *  [verifyMeta][]
     *  [computeMeta][]
     *  [recoverLease][]

## 概观 ##

所有HDFS命令都由bin/hdfs脚本调用。不带任何参数运行hdfs脚本会打印所有命令的描述。

用法： hdfs \[SHELL\_OPTIONS\] COMMAND \[GENERIC\_OPTIONS\] \[COMMAND\_OPTIONS\]

Hadoop有一个选项解析框架，它使用解析通用选项以及运行类。

<table> 
 <thead> 
  <tr> 
   <th>COMMAND_OPTIONS</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>SHELL_OPTIONS</td> 
   <td>常见的shell选项集。这些内容记录在“&nbsp;<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/CommandsManual.html#Shell_Options" rel="nofollow">命令手册”</a>页面上。</td> 
  </tr> 
  <tr> 
   <td>GENERIC_OPTIONS</td> 
   <td>多个命令支持的通用选项集。有关更多信息，请参阅“Hadoop&nbsp;<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/CommandsManual.html#Generic_Options" rel="nofollow">命令手册</a>&nbsp;”。</td> 
  </tr> 
  <tr> 
   <td>COMMAND COMMAND_OPTIONS</td> 
   <td>以下各节介绍了各种命令及其选项。这些命令已分组为“&nbsp;<a rel="nofollow">用户命令”</a>和“&nbsp;<a rel="nofollow">管理命令”</a>。</td> 
  </tr> 
 </tbody> 
</table>

## 用户命令 ##

对hadoop集群的用户有用的命令。

### **类路径** ###

用法：hdfs classpath \[--glob | --jar <path> | -h | --help\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>--glob</td> 
   <td>扩展通配符</td> 
  </tr> 
  <tr> 
   <td>--jar&nbsp;<em>path</em></td> 
   <td>将类路径写为jar命名<em>路径中的</em>清单</td> 
  </tr> 
  <tr> 
   <td>-h， -&nbsp;help</td> 
   <td>打印帮助</td> 
  </tr> 
 </tbody> 
</table>

打印获取Hadoop jar和所需库所需的类路径。如果不带参数调用，则打印由命令脚本设置的类路径，该脚本可能在类路径条目中包含通配符。其他选项在通配符扩展后打印类路径，或将类路径写入jar文件的清单中。后者在无法使用通配符且扩展类路径超过支持的最大命令行长度的环境中非常有用。

### **dfs** ###

用法：hdfs dfs \[COMMAND \[COMMAND\_OPTIONS\]\]

在Hadoop支持的文件系统上运行filesystem命令。可以在[File System Shell Guide中][File System Shell Guide]找到各种COMMAND\_OPTIONS 。

### envvars ###

用法：hdfs envvars

显示计算的Hadoop环境变量。

### **fetchdt** ###

用法：hdfs fetchdt <opts> <token\_file\_path>

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>--webservice&nbsp;<em>NN_Url</em></td> 
   <td>要连接NN的网址（以http或https开头）</td> 
  </tr> 
  <tr> 
   <td>--renewer&nbsp;<em>name</em></td> 
   <td>委托令牌更新程序的名称</td> 
  </tr> 
  <tr> 
   <td>--cancel</td> 
   <td>取消委托令牌</td> 
  </tr> 
  <tr> 
   <td>--renew</td> 
   <td>续订委托令牌。必须使用-renewer&nbsp;<em>name</em>选项获取委派令牌。</td> 
  </tr> 
  <tr> 
   <td>--print</td> 
   <td>打印委托令牌</td> 
  </tr> 
  <tr> 
   <td><em>token_file_path</em></td> 
   <td>用于存储令牌的文件路径。</td> 
  </tr> 
 </tbody> 
</table>

从NameNode获取委托令牌。有关详细信息，请参阅[fetchdt][fetchdt 1]。

### **fsck的** ###

用法：

hdfs fsck <path>
              [-list-corruptfileblocks |
              [-move | -delete | -openforwrite]
              [-files [-blocks [-locations | -racks | -replicaDetails | -upgradedomains]]]
              [-includeSnapshots] [-showprogress]
              [-storagepolicies] [-maintenance]
              [-blockId <blk_Id>]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><em>path</em></td> 
   <td>从这条路径开始检查。</td> 
  </tr> 
  <tr> 
   <td>-delete</td> 
   <td>删除损坏的文件。</td> 
  </tr> 
  <tr> 
   <td>-files</td> 
   <td>打印出要检查的文件。</td> 
  </tr> 
  <tr> 
   <td>-files&nbsp;-blocks</td> 
   <td>打印出块报告</td> 
  </tr> 
  <tr> 
   <td>-files&nbsp;-blocks&nbsp;-locations</td> 
   <td>打印每个块的位置。</td> 
  </tr> 
  <tr> 
   <td>-files&nbsp;-blocks&nbsp;-racks</td> 
   <td>打印数据节点位置的网络拓扑。</td> 
  </tr> 
  <tr> 
   <td>-files&nbsp;-blocks&nbsp;-replicaDetails</td> 
   <td>打印出每个副本的详细信息。</td> 
  </tr> 
  <tr> 
   <td>-files&nbsp;-blocks&nbsp;-upgradedomains</td> 
   <td>打印每个块的升级域。</td> 
  </tr> 
  <tr> 
   <td>-includeSnapshots</td> 
   <td>如果给定路径指示快照目录或其下有快照目录，则包括快照数据。</td> 
  </tr> 
  <tr> 
   <td>-list-corruptfileblocks</td> 
   <td>打印出所属的缺失块和文件列表。</td> 
  </tr> 
  <tr> 
   <td>-move</td> 
   <td>将损坏的文件移至/ lost + found。</td> 
  </tr> 
  <tr> 
   <td>-openforwrite</td> 
   <td>打印出用于写入的文件。</td> 
  </tr> 
  <tr> 
   <td>-showprogress</td> 
   <td>打印出输出点的点。默认为OFF（无进度）。</td> 
  </tr> 
  <tr> 
   <td>-storagepolicies</td> 
   <td>打印出块的存储策略摘要。</td> 
  </tr> 
  <tr> 
   <td>-maintenance</td> 
   <td>打印出维护状态节点详细信息。</td> 
  </tr> 
  <tr> 
   <td>-blockId</td> 
   <td>打印出有关块的信息。</td> 
  </tr> 
 </tbody> 
</table>

运行HDFS文件系统检查实用程序。有关详细信息，请参阅[fsck][fsck 1]。

### **getconf** ###

用法：

hdfs getconf -namenodes
       hdfs getconf -secondaryNameNodes
       hdfs getconf -backupNodes
       hdfs getconf -journalNodes
       hdfs getconf -includeFile
       hdfs getconf -excludeFile
       hdfs getconf -nnRpcAddresses
       hdfs getconf -confKey [key]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-namenodes</td> 
   <td>获取集群中的名称节点列表。</td> 
  </tr> 
  <tr> 
   <td>-secondaryNameNodes</td> 
   <td>获取群集中的辅助名称节点列表。</td> 
  </tr> 
  <tr> 
   <td>-backupNodes</td> 
   <td>获取群集中的备份节点列表。</td> 
  </tr> 
  <tr> 
   <td>-journalNodes</td> 
   <td>获取群集中的日记节点列表。</td> 
  </tr> 
  <tr> 
   <td>-includeFile</td> 
   <td>获取包含文件路径，该路径定义可以加入群集的datanode。</td> 
  </tr> 
  <tr> 
   <td>-excludeFile</td> 
   <td>获取排除文件路径，该路径定义需要停用的数据节点。</td> 
  </tr> 
  <tr> 
   <td>-nnRpcAddresses</td> 
   <td>获取namenode rpc地址</td> 
  </tr> 
  <tr> 
   <td>-confKey&nbsp;[key]</td> 
   <td>从配置中获取特定密钥</td> 
  </tr> 
 </tbody> 
</table>

从配置目录中获取配置信息，进行后处理。

### groups ###

用法：hdfs groups \[username ...\]

返回给定一个或多个用户名的组信息。

### **httpfs** ###

用法：hdfs httpfs

运行HttpFS服务器，HDFS HTTP网关。

### **lsSnapshottableDir** ###

用法：hdfs lsSnapshottableDir \[-help\]

获取快照目录列表。当它以超级用户身份运行时，它将返回所有快照目录。否则，它返回当前用户拥有的那些目录。

### **jmxget** ###

Usage: hdfs jmxget \[-localVM ConnectorURL | -port port | -server mbeanserver | -service service\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-help</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-localVM&nbsp;ConnectorURL</td> 
   <td>连接到同一台计算机上的VM</td> 
  </tr> 
  <tr> 
   <td>-port&nbsp;<em>mbean server port&nbsp;</em></td> 
   <td>指定mbean服务器端口，如果缺少它将尝试连接到同一VM中的MBean Server</td> 
  </tr> 
  <tr> 
   <td>-server</td> 
   <td>指定mbean服务器（默认为localhost）</td> 
  </tr> 
  <tr> 
   <td>-service&nbsp;NameNode | DataNode</td> 
   <td>指定jmx服务。默认情况下为NameNode。</td> 
  </tr> 
 </tbody> 
</table>

服务的快照信息

###  ###

### **oev** ###

Usage: hdfs oev \[OPTIONS\] -i INPUT\_FILE -o OUTPUT\_FILE

必需的命令行参数：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-i， -&nbsp;inputFile&nbsp;<em>arg</em></td> 
   <td>编辑要处理的文件，xml（不区分大小写）扩展名表示XML格式，任何其他文件名表示二进制格式</td> 
  </tr> 
  <tr> 
   <td>-o， -&nbsp;outputFile&nbsp;<em>arg</em></td> 
   <td>输出文件的名称。如果指定的文件存在，则将覆盖该文件，文件的格式由-p选项确定</td> 
  </tr> 
 </tbody> 
</table>

可选的命令行参数：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-f， --fix-txids</td> 
   <td>重新编号输入中的事务ID，以便没有间隙或无效的事务ID。</td> 
  </tr> 
  <tr> 
   <td>-h，--help</td> 
   <td>显示使用信息并退出</td> 
  </tr> 
  <tr> 
   <td>-r，--recover</td> 
   <td>读取二进制编辑日志时，请使用恢复模式。这将使您有机会跳过编辑日志的损坏部分。</td> 
  </tr> 
  <tr> 
   <td>-p， --processor&nbsp;<em>arg</em></td> 
   <td>选择要对图像文件应用的处理器类型，当前支持的处理器是：二进制（Hadoop使用的本机二进制格式），xml（默认，XML格式），统计信息（打印有关编辑文件的统计信息）</td> 
  </tr> 
  <tr> 
   <td>-v， --verbose</td> 
   <td>更详细的输出，打印输入和输出文件名，用于写入文件的处理器，也输出到屏幕。在大图像文件上，这将大大增加处理时间（默认为false）。</td> 
  </tr> 
 </tbody> 
</table>

Hadoop离线编辑查看器。有关详细信息，请参阅[脱机编辑查看器指南][Link 1]。

###  ###

### **oiv** ###

用法：hdfs oiv \[OPTIONS\] -i INPUT\_FILE

必需的命令行参数：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-i&nbsp;|&nbsp;--inputFile&nbsp;<em>input file</em></td> 
   <td>指定要处理的输入fsimage文件（或XML文件，如果使用ReverseXML处理器）。</td> 
  </tr> 
 </tbody> 
</table>

可选的命令行参数：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-o， --outputFile <em>output file</em></td> 
   <td>如果指定的输出处理器生成一个，请指定输出文件名。如果指定的文件已存在，则会以静默方式覆盖该文件。（默认情况下输出到stdout）如果输入文件是XML文件，它还会创建&lt;outputFile&gt; .md5。</td> 
  </tr> 
  <tr> 
   <td>-p，--processor<em>processor</em></td> 
   <td>指定要对图像文件应用的图像处理器。目前有效的选项是Web（默认），XML，Delimited，FileDistribution和ReverseXML。</td> 
  </tr> 
  <tr> 
   <td>-addr&nbsp;<em>address</em></td> 
   <td>指定要侦听的地址（主机：端口）。（localhost：默认为5978）。此选项与Web处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-maxSize&nbsp;<em>size</em></td> 
   <td>指定要以字节为单位分析的文件大小的范围[0，maxSize]（默认为128GB）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-step size</td> 
   <td>以字节为单位指定分发的粒度（默认为2MB）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-format</td> 
   <td>以人类可读的方式而不是多个字节格式化输出结果。（默认为false）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-delimiter&nbsp;<em>arg</em></td> 
   <td>定界字符串以与分隔处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-t， -&nbsp;temp&nbsp;<em>temporary dir</em></td> 
   <td>使用临时目录缓存中间结果以生成分隔输出。如果未设置，则分隔处理器在输出文本之前在内存中构造命名空间。</td> 
  </tr> 
  <tr> 
   <td>-h， -&nbsp;help</td> 
   <td>显示工具使用情况和帮助信息并退出。</td> 
  </tr> 
 </tbody> 
</table>

Hadoop离线图像查看器，用于Hadoop 2.4或更高版本中的图像文件。有关详细信息，请参阅“ [脱机图像查看器][Link 2]

### **oiv\_legacy** ###

用法：hdfs oiv\_legacy \[OPTIONS\] -i INPUT\_FILE -o OUTPUT\_FILE

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-i， -&nbsp;inputFile&nbsp;<em>input file</em></td> 
   <td>指定要处理的输入fsimage文件。</td> 
  </tr> 
  <tr> 
   <td>-o， -&nbsp;outputFile&nbsp;<em>output file</em></td> 
   <td>如果指定的输出处理器生成一个，请指定输出文件名。如果指定的文件已存在，则会以静默方式覆盖该文件。</td> 
  </tr> 
 </tbody> 
</table>

可选的命令行参数：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-p|--processor<em>processor</em></td> 
   <td>指定要对图像文件应用的图像处理器。有效选项包括Ls（默认），XML，分隔符，缩进，FileDistribution和NameDistribution。</td> 
  </tr> 
  <tr> 
   <td>-maxSize&nbsp;<em>size</em></td> 
   <td>指定要以字节为单位分析的文件大小的范围[0，maxSize]（默认为128GB）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-step size</td> 
   <td>以字节为单位指定分发的粒度（默认为2MB）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-format</td> 
   <td>以人类可读的方式而不是多个字节格式化输出结果。（默认为false）。此选项与FileDistribution处理器一起使用。</td> 
  </tr> 
  <tr> 
   <td>-skipBlocks</td> 
   <td>不要枚举文件中的单个块。这可以节省具有非常大的文件的命名空间上的处理时间和outfile文件空间。Ls处理器读取块以正确确定文件大小并忽略此选项。</td> 
  </tr> 
  <tr> 
   <td>-printToScreen</td> 
   <td>将处理器的输出管道输出到控制台以及指定的文件。在极大的命名空间上，这可能会使处理时间增加一个数量级。</td> 
  </tr> 
  <tr> 
   <td>-delimiter&nbsp;<em>arg</em></td> 
   <td>与分隔处理器一起使用时，将默认选项卡分隔符替换为<em>arg</em>指定的字符串。</td> 
  </tr> 
  <tr> 
   <td>-h&nbsp;| --help</td> 
   <td>显示工具使用情况和帮助信息并退出。</td> 
  </tr> 
 </tbody> 
</table>

适用于旧版Hadoop的Hadoop离线图像查看器。有关详细信息，请参阅[oiv\_legacy命令][oiv_legacy 1]。

### **snapshotDiff** ###

用法：hdfs snapshotDiff <path> <fromSnapshot> <toSnapshot>

确定HDFS快照之间的差异。有关更多信息，请参阅[HDFS快照文档][HDFS]。

### **version** ###

Usage: hdfs version

打印版本。

## 管理命令 ##

对hadoop集群的管理员有用的命令。

### balancer ###

用法：

hdfs balancer
              [-policy <policy>]
              [-threshold <threshold>]
              [-exclude [-f <hosts-file> | <comma-separated list of hosts>]]
              [-include [-f <hosts-file> | <comma-separated list of hosts>]]
              [-source [-f <hosts-file> | <comma-separated list of hosts>]]
              [-blockpools <comma-separated list of blockpool ids>]
              [-idleiterations <idleiterations>]
              [-runDuringUpgrade]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-policy&nbsp;&lt;policy&gt;</td> 
   <td>datanode（默认值）：如果每个datanode均衡，则群集是平衡的。<br> blockpool：如果每个datanode中的每个块池都是平衡的，则群集是平衡的。</td> 
  </tr> 
  <tr> 
   <td>-threshold&nbsp;&lt;threshold&gt;</td> 
   <td>磁盘容量的百分比。这会覆盖默认阈值。</td> 
  </tr> 
  <tr> 
   <td>-exclude -f&nbsp;&lt;hosts-file&gt; |&nbsp;&lt;comma-separated list of hosts&gt;</td> 
   <td>排除指定的数据节点被平衡器平衡。</td> 
  </tr> 
  <tr> 
   <td>-include -f&nbsp;&lt;hosts-file&gt; |&nbsp;&lt;comma-separated list of hosts&gt;</td> 
   <td>仅包括由平衡器平衡的指定数据节点。</td> 
  </tr> 
  <tr> 
   <td>-source -f&nbsp;&lt;hosts-file&gt; |&nbsp;&lt;comma-separated list of hosts&gt;</td> 
   <td>仅选择指定的数据节点作为源节点。</td> 
  </tr> 
  <tr> 
   <td>-blockpools&nbsp;&lt;comma-separated list of blockpool ids&gt;</td> 
   <td>平衡器仅在此列表中包含的块池上运行。</td> 
  </tr> 
  <tr> 
   <td>-idleiterations&nbsp;&lt;iterations&gt;</td> 
   <td>退出前的最大空闲迭代次数。这会覆盖默认的空闲状态（5）。</td> 
  </tr> 
  <tr> 
   <td>-runDuringUpgrade</td> 
   <td>是否在正在进行的HDFS升级期间运行平衡器。这通常是不希望的，因为它不会影响过度使用的机器上的已用空间。</td> 
  </tr> 
  <tr> 
   <td>-h&nbsp;|&nbsp;- help</td> 
   <td>显示工具使用情况和帮助信息并退出。</td> 
  </tr> 
 </tbody> 
</table>

运行集群平衡实用程序。管理员只需按Ctrl-C即可停止重新平衡过程。有关详细信息，请参阅[Balancer][]。

请注意，blockpool策略比datanode策略更严格。

除了上述命令选项外，还引入了一个固定功能，从2.7.0开始，以防止某些副本被平衡器/移动器移动。默认情况下，此固定功能处于禁用状态，可通过配置属性“dfs.datanode.block-pinning.enabled”启用。启用时，此功能仅影响写入create（）调用中指定的favored节点的块。对于HBase regionserver等应用程序，我们希望维护数据局部性时，此功能非常有用。

### **cacheadmin** ###

用法：

hdfs cacheadmin [-addDirective -path <path> -pool <pool-name> [-force] [-replication <replication>] [-ttl <time-to-live>]]
    hdfs cacheadmin [-modifyDirective -id <id> [-path <path>] [-force] [-replication <replication>] [-pool <pool-name>] [-ttl <time-to-live>]]
    hdfs cacheadmin [-listDirectives [-stats] [-path <path>] [-pool <pool>] [-id <id>]]
    hdfs cacheadmin [-removeDirective <id>]
    hdfs cacheadmin [-removeDirectives -path <path>]
    hdfs cacheadmin [-addPool <name> [-owner <owner>] [-group <group>] [-mode <mode>] [-limit <limit>] [-maxTtl <maxTtl>]]
    hdfs cacheadmin [-modifyPool <name> [-owner <owner>] [-group <group>] [-mode <mode>] [-limit <limit>] [-maxTtl <maxTtl>]]
    hdfs cacheadmin [-removePool <name>]
    hdfs cacheadmin [-listPools [-stats] [<name>]]
    hdfs cacheadmin [-help <command-name>]

有关更多信息，请参阅[HDFS缓存管理文档][HDFS 1]。

### crypto ###

用法：

hdfs crypto -createZone -keyName <keyName> -path <path>
      hdfs crypto -listZones
      hdfs crypto -provisionTrash -path <path>
      hdfs crypto -help <command-name>

有关更多信息，请参阅[HDFS透明加密文档][HDFS 2]。

### **数据节点** ###

用法：hdfs datanode \[-regular | -rollback | -rollingupgrade rollback\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-regular</td> 
   <td>正常的datanode启动（默认）。</td> 
  </tr> 
  <tr> 
   <td>-rollback</td> 
   <td>将datanode回滚到以前的版本。这应该在停止datanode并分发旧的hadoop版本后使用。</td> 
  </tr> 
  <tr> 
   <td>-rollingupgrade&nbsp;rollback</td> 
   <td>回滚滚动升级操作。</td> 
  </tr> 
 </tbody> 
</table>

运行HDFS datanode。

### **dfsadmin** ###

用法：

hdfs dfsadmin [-report [-live] [-dead] [-decommissioning] [-enteringmaintenance] [-inmaintenance]]
        hdfs dfsadmin [-safemode enter | leave | get | wait | forceExit]
        hdfs dfsadmin [-saveNamespace [-beforeShutdown]]
        hdfs dfsadmin [-rollEdits]
        hdfs dfsadmin [-restoreFailedStorage true |false |check]
        hdfs dfsadmin [-refreshNodes]
        hdfs dfsadmin [-setQuota <quota> <dirname>...<dirname>]
        hdfs dfsadmin [-clrQuota <dirname>...<dirname>]
        hdfs dfsadmin [-setSpaceQuota <quota> [-storageType <storagetype>] <dirname>...<dirname>]
        hdfs dfsadmin [-clrSpaceQuota [-storageType <storagetype>] <dirname>...<dirname>]
        hdfs dfsadmin [-finalizeUpgrade]
        hdfs dfsadmin [-rollingUpgrade [<query> |<prepare> |<finalize>]]
        hdfs dfsadmin [-upgrade [query | finalize]
        hdfs dfsadmin [-refreshServiceAcl]
        hdfs dfsadmin [-refreshUserToGroupsMappings]
        hdfs dfsadmin [-refreshSuperUserGroupsConfiguration]
        hdfs dfsadmin [-refreshCallQueue]
        hdfs dfsadmin [-refresh <host:ipc_port> <key> [arg1..argn]]
        hdfs dfsadmin [-reconfig <namenode|datanode> <host:ipc_port> <start |status |properties>]
        hdfs dfsadmin [-printTopology]
        hdfs dfsadmin [-refreshNamenodes datanodehost:port]
        hdfs dfsadmin [-getVolumeReport datanodehost:port]
        hdfs dfsadmin [-deleteBlockPool datanode-host:port blockpoolId [force]]
        hdfs dfsadmin [-setBalancerBandwidth <bandwidth in bytes per second>]
        hdfs dfsadmin [-getBalancerBandwidth <datanode_host:ipc_port>]
        hdfs dfsadmin [-fetchImage <local directory>]
        hdfs dfsadmin [-allowSnapshot <snapshotDir>]
        hdfs dfsadmin [-disallowSnapshot <snapshotDir>]
        hdfs dfsadmin [-shutdownDatanode <datanode_host:ipc_port> [upgrade]]
        hdfs dfsadmin [-evictWriters <datanode_host:ipc_port>]
        hdfs dfsadmin [-getDatanodeInfo <datanode_host:ipc_port>]
        hdfs dfsadmin [-metasave filename]
        hdfs dfsadmin [-triggerBlockReport [-incremental] <datanode_host:ipc_port>]
        hdfs dfsadmin [-listOpenFiles [-blockingDecommission] [-path <path>]]
        hdfs dfsadmin [-help [cmd]]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-report&nbsp;[-live]&nbsp;[-dead]&nbsp;[-decommissioning]&nbsp;[-enteringmaintenance]&nbsp;[-inmaintenance]</td> 
   <td>报告基本文件系统信息和统计信息，dfs用法可以与“du”用法不同，因为它测量所有DN上的复制，校验和，快照等使用的原始空间。可选标志可用于过滤显示的DataNode列表。</td> 
  </tr> 
  <tr> 
   <td>-safemode&nbsp;enter|leave|get|wait|forceExit</td> 
   <td>安全模式维护命令。安全模式是一种Namenode状态，其中<br> 1.不接受对名称空间的更改（只读）<br> 2.不复制或删除块。<br> 在Namenode启动时自动进入安全模式，并在配置的最小块百分比满足最小复制条件时自动离开安全模式。如果Namenode检测到任何异常，那么它将以安全模式停留，直到该问题得到解决。如果该异常是故意操作的结果，则管理员可以使用-safemode forceExit退出安全模式。可能需要forceExit的情况是<br> 1. Namenode元数据不一致。如果Namenode检测到元数据已在带外修改并可能导致数据丢失，则Namenode将进入forceExit状态。此时，用户可以使用正确的元数据文件或forceExit重新启动Namenode（如果数据丢失可接受）。<br> 2.回滚导致元数据被替换，很少可以在Namenode中触发安全模式forceExit状态。在这种情况下，您可以通过发出-safemode forceExit来继续。<br> 安全模式也可以手动输入，但之后也只能手动关闭。</td> 
  </tr> 
  <tr> 
   <td>-saveNamespace&nbsp;[-beforeShutdown]</td> 
   <td>将当前名称空间保存到存储目录并重置编辑日志。需要安全模式。如果给出“beforeShutdown”选项，则当且仅当在时间窗口期间没有完成检查点（可配置数量的检查点周期）时，NameNode才会执行检查点。这通常在关闭NameNode之前使用，以防止潜在的fsimage / editlog损坏。</td> 
  </tr> 
  <tr> 
   <td>-rollEdits</td> 
   <td>在活动NameNode上滚动编辑日志。</td> 
  </tr> 
  <tr> 
   <td>-restoreFailedStorage&nbsp;true | false | check</td> 
   <td>此选项将打开/关闭自动尝试以还原失败的存储副本。如果故障存储再次可用，系统将尝试在检查点期间恢复编辑和/或fsimage。'check'选项将返回当前设置。</td> 
  </tr> 
  <tr> 
   <td>-refreshNodes</td> 
   <td>重新读取主机并排除文件以更新允许连接到Namenode的数据节点集以及应该退役或重新调试的数据节点集。</td> 
  </tr> 
  <tr> 
   <td>-setQuota&nbsp;&lt;quota&gt; &lt;dirname&gt; ... &lt;dirname&gt;</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html#Administrative_Commands" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-clrQuota&nbsp;&lt;dirname&gt; ... &lt;dirname&gt;</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html#Administrative_Commands" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-setSpaceQuota&nbsp;&lt;quota&gt;&nbsp;[-storageType &lt;storagetype&gt;]&nbsp;&lt;dirname&gt; ... &lt;dirname&gt;</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html#Administrative_Commands" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-clrSpaceQuota&nbsp;[&nbsp;-storageType&lt;storagetype&gt;]&nbsp;&lt;dirname&gt; ... &lt;dirname&gt;</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html#Administrative_Commands" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-finalizeUpgrade</td> 
   <td>完成HDFS的升级。Datanodes删除其先前版本的工作目录，然后Namenode执行相同操作。这样就完成了升级过程。</td> 
  </tr> 
  <tr> 
   <td>-rollingUpgrade&nbsp;[&lt;query&gt; | &lt;prepare&gt; | &lt;finalize&gt;]</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#dfsadmin_-rollingUpgrade" rel="nofollow">滚动升级文档</a></td> 
  </tr> 
  <tr> 
   <td>-upgrade&nbsp;query | finalize</td> 
   <td>查询当前升级状态。<br> 完成HDFS的升级（相当于-finalizeUpgrade）。</td> 
  </tr> 
  <tr> 
   <td>-refreshServiceAcl</td> 
   <td>重新加载服务级别授权策略文件。</td> 
  </tr> 
  <tr> 
   <td>-refreshUserToGroupsMappings</td> 
   <td>刷新用户到组的映射。</td> 
  </tr> 
  <tr> 
   <td>-refreshSuperUserGroupsConfiguration</td> 
   <td>刷新超级用户代理组映射</td> 
  </tr> 
  <tr> 
   <td>-refreshCallQueue</td> 
   <td>从config重新加载呼叫队列。</td> 
  </tr> 
  <tr> 
   <td>-refresh&nbsp;&lt;host：ipc_port&gt; &lt;key&gt; [arg1..argn]</td> 
   <td>触发&lt;host：ipc_port&gt;上&lt;key&gt;指定的资源的运行时刷新。之后的所有其他args被发送到主机。</td> 
  </tr> 
  <tr> 
   <td>-reconfig&nbsp;&lt;datanode | namenode&gt; &lt;host：ipc_port&gt; &lt;start | status | properties&gt;</td> 
   <td>开始重新配置或获取正在进行的重新配置的状态，或获取可重新配置属性的列表。第二个参数指定节点类型。</td> 
  </tr> 
  <tr> 
   <td>-printTopology</td> 
   <td>根据Namenode的报告打印机架及其节点的树</td> 
  </tr> 
  <tr> 
   <td>-refreshNamenodes&nbsp;datanodehost：port</td> 
   <td>对于给定的datanode，重新加载配置文件，停止为已删除的块池提供服务并开始提供新的块池。</td> 
  </tr> 
  <tr> 
   <td>-getVolumeReport&nbsp;datanodehost：port</td> 
   <td>对于给定的datanode，获取卷报告。</td> 
  </tr> 
  <tr> 
   <td>-deleteBlockPool&nbsp;datanode-host：port blockpoolId [force]</td> 
   <td>如果强制传递，则删除给定datanode上给定blockpool id的块池目录及其内容，否则仅当目录为空时才删除该目录。如果datanode仍在为块池提供服务，则该命令将失败。请参阅refreshNamenodes以关闭datanode上的块池服务。</td> 
  </tr> 
  <tr> 
   <td>-setBalancerBandwidth&nbsp;&lt;bandwidth in bytes per second&gt;</td> 
   <td>在HDFS块平衡期间更改每个数据节点使用的网络带宽。&lt;bandwidth&gt;是每个datanode将使用的每秒最大字节数。此值将覆盖dfs.datanode.balance.bandwidthPerSec参数。注意：新值在DataNode上不是持久的。</td> 
  </tr> 
  <tr> 
   <td>-getBalancerBandwidth&nbsp;&lt;datanode_host：ipc_port&gt;</td> 
   <td>获取给定datanode的网络带宽（以每秒字节数为单位）。这是在HDFS块平衡期间datanode使用的最大网络带宽。</td> 
  </tr> 
  <tr> 
   <td>-fetchImage&nbsp;&lt;local directory&gt;</td> 
   <td>从NameNode下载最新的fsimage并将其保存在指定的本地目录中。</td> 
  </tr> 
  <tr> 
   <td>-allowSnapshot&nbsp;&lt;snapshotDir&gt;</td> 
   <td>允许创建目录的快照。如果操作成功完成，则该目录将变为快照。有关更多信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsSnapshots.html" rel="nofollow">HDFS快照文档</a>。</td> 
  </tr> 
  <tr> 
   <td>-disallowSnapshot&nbsp;&lt;snapshotDir&gt;</td> 
   <td>不允许创建目录的快照。在禁止快照之前，必须删除目录的所有快照。有关更多信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsSnapshots.html" rel="nofollow">HDFS快照文档</a>。</td> 
  </tr> 
  <tr> 
   <td>-shutdownDatanode&nbsp;&lt;datanode_host：ipc_port&gt; [upgrade]</td> 
   <td>提交给定datanode的关闭请求。有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#dfsadmin_-shutdownDatanode" rel="nofollow">滚动升级文档</a></td> 
  </tr> 
  <tr> 
   <td>-evictWriters&nbsp;&lt;datanode_host：ipc_port&gt;</td> 
   <td>使datanode驱逐所有正在编写块的客户端。如果由于编写速度慢而停止停用，这将非常有用。</td> 
  </tr> 
  <tr> 
   <td>-getDatanodeInfo&nbsp;&lt;datanode_host：ipc_port&gt;</td> 
   <td>获取有关给定datanode的信息。有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#dfsadmin_-getDatanodeInfo" rel="nofollow">滚动升级文档</a></td> 
  </tr> 
  <tr> 
   <td>-metasave&nbsp;filename</td> 
   <td>保存的Namenode的主要数据结构，<em>文件名</em>由hadoop.log.dir属性指定的目录。如果存在，则覆盖<em>filename</em>。<em>filename</em>将包含以下每一行的一行<br> 1.使用Namenode心跳的数据节点<br> 2.等待复制的<br> 块3.当前正在复制的<br> 块4.等待删除的块</td> 
  </tr> 
  <tr> 
   <td>-triggerBlockReport&nbsp;[-incremental]&lt;datanode_host：ipc_port&gt;</td> 
   <td>触发给定datanode的块报告。如果指定'incremental'，则不然，它将是一个完整的块报告。</td> 
  </tr> 
  <tr> 
   <td>-listOpenFiles&nbsp;[&nbsp;-blockingDecommission&nbsp;]&nbsp;[-path &lt;path&gt;]</td> 
   <td>列出NameNode当前管理的所有打开文件以及访问它们的客户端名称和客户端计算机。打开的文件列表将按给定的类型和路径进行过滤。</td> 
  </tr> 
  <tr> 
   <td>-help&nbsp;[cmd]</td> 
   <td>显示给定命令或所有命令的帮助（如果未指定）。</td> 
  </tr> 
 </tbody> 
</table>

运行HDFS dfsadmin客户端。

### **dfsrouter** ###

用法：hdfs dfsrouter

运行DFS路由器。见[路由器][Link 3]的更多信息。

### **dfsrouteradmin** ###

用法：

hdfs dfsrouteradmin
          [-add <source> <nameservice1, nameservice2, ...> <destination> [-readonly] [-order HASH|LOCAL|RANDOM|HASH_ALL] -owner <owner> -group <group> -mode <mode>]
          [-update <source> <nameservice1, nameservice2, ...> <destination> [-readonly] [-order HASH|LOCAL|RANDOM|HASH_ALL] -owner <owner> -group <group> -mode <mode>]
          [-rm <source>]
          [-ls <path>]
          [-setQuota <path> -nsQuota <nsQuota> -ssQuota <quota in bytes or quota size string>]
          [-clrQuota <path>]
          [-safemode enter | leave | get]
          [-nameservice disable | enable <nameservice>]
          [-getDisabledNameservices]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-add&nbsp;&nbsp;<em>source</em>&nbsp;<em>nameservices</em>&nbsp;<em>destination</em></td> 
   <td>添加装入表条目或更新（如果存在）。</td> 
  </tr> 
  <tr> 
   <td>-update&nbsp;&nbsp;<em>source</em>&nbsp;<em>nameservices</em>&nbsp;<em>destination</em></td> 
   <td>更新装入表条目或创建一个条目（如果不存在）。</td> 
  </tr> 
  <tr> 
   <td>-rm <em>source</em></td> 
   <td>删除指定路径的安装点。</td> 
  </tr> 
  <tr> 
   <td>-ls&nbsp;<em>path</em></td> 
   <td>列出指定路径下的挂载点。</td> 
  </tr> 
  <tr> 
   <td>-setQuota&nbsp;<em>path&nbsp;</em>-nsQuota&nbsp;<em>nsQuota&nbsp;</em>-ssQuota&nbsp;<em>ssQuota</em></td> 
   <td>设置指定路径的配额。有关配额详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-clrQuota&nbsp;<em>path</em></td> 
   <td>清除给定挂载点的配额。有关配额详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html" rel="nofollow">HDFS配额指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-safemode&nbsp;enter leave&nbsp;get</td> 
   <td>手动设置路由器进入或离开安全模式。选项<em>get</em>将用于验证路由器是否处于安全模式状态。</td> 
  </tr> 
  <tr> 
   <td>-nameservice&nbsp;disable&nbsp;enable&nbsp;<em>nameservice</em></td> 
   <td>禁用/启用联盟中的名称服务。如果禁用，请求将不会转到该名称服务。</td> 
  </tr> 
  <tr> 
   <td>-getDisabledNameservices</td> 
   <td>获取联合中禁用的名称服务。</td> 
  </tr> 
 </tbody> 
</table>

用于管理基于路由器的联合的命令。有关详细信息，请参阅[挂载表管理][Link 4]。

### **diskbalancer** ###

用法：

hdfs diskbalancer
         [-plan <datanode> -fs <namenodeURI>]
         [-execute <planfile>]
         [-query <datanode>]
         [-cancel <planfile>]
         [-cancel <planID> -node <datanode>]
         [-report -node <file://> | [<DataNodeID|IP|Hostname>,...]]
         [-report -node -top <topnum>]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-plan</td> 
   <td>创建一个失衡者计划</td> 
  </tr> 
  <tr> 
   <td>-execute</td> 
   <td>在datanode上执行给定的计划</td> 
  </tr> 
  <tr> 
   <td>-query</td> 
   <td>从datanode获取当前的diskbalancer状态</td> 
  </tr> 
  <tr> 
   <td>-cancle</td> 
   <td>取消正在运行的计划</td> 
  </tr> 
  <tr> 
   <td>-report</td> 
   <td>报告来自datanode的卷信息</td> 
  </tr> 
 </tbody> 
</table>

运行diskbalancer CLI。有关此命令的更多信息，请参阅[HDFS Diskbalancer][]。

### **ec** ###

用法：

hdfs ec [generic options]
         [-setPolicy -policy <policyName> -path <path>]
         [-getPolicy -path <path>]
         [-unsetPolicy -path <path>]
         [-listPolicies]
         [-addPolicies -policyFile <file>]
         [-listCodecs]
         [-enablePolicy -policy <policyName>]
         [-disablePolicy -policy <policyName>]
         [-help [cmd ...]]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-setPolicy</td> 
   <td>将指定的ErasureCoding策略设置为目录</td> 
  </tr> 
  <tr> 
   <td>-getPolicy</td> 
   <td>获取有关指定路径的ErasureCoding策略信息</td> 
  </tr> 
  <tr> 
   <td>-unsetPolicy</td> 
   <td>取消先前对目录上的“setPolicy”调用设置的ErasureCoding策略</td> 
  </tr> 
  <tr> 
   <td>-listPolicies</td> 
   <td>列出所有支持的ErasureCoding策略</td> 
  </tr> 
  <tr> 
   <td>-addPolicies</td> 
   <td>添加擦除编码策略列表</td> 
  </tr> 
  <tr> 
   <td>-listCodecs</td> 
   <td>获取系统中支持的擦除编码编解码器和编码器列表</td> 
  </tr> 
  <tr> 
   <td>-enablePolicy</td> 
   <td>在系统中启用ErasureCoding策略</td> 
  </tr> 
  <tr> 
   <td>-disablePolicy</td> 
   <td>在系统中禁用ErasureCoding策略</td> 
  </tr> 
 </tbody> 
</table>

运行ErasureCoding CLI。有关此命令的更多信息，请参阅[HDFS ErasureCoding][]。

### **haadmin** ###

用法：

hdfs haadmin -transitionToActive <serviceId> [--forceactive]
        hdfs haadmin -transitionToStandby <serviceId>
        hdfs haadmin -failover [--forcefence] [--forceactive] <serviceId> <serviceId>
        hdfs haadmin -getServiceState <serviceId>
        hdfs haadmin -getAllServiceState
        hdfs haadmin -checkHealth <serviceId>
        hdfs haadmin -help <command>

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-checkHealth</td> 
   <td>检查给定NameNode的运行状况</td> 
  </tr> 
  <tr> 
   <td>-failover</td> 
   <td>在两个NameNode之间启动故障转移</td> 
  </tr> 
  <tr> 
   <td>-getServiceState</td> 
   <td>确定给定的NameNode是Active还是Standby</td> 
  </tr> 
  <tr> 
   <td>-getAllServiceState</td> 
   <td>返回所有NameNode的状态</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>-transitionToActive</td> 
   <td>将给定NameNode的状态转换为Active（警告：不执行防护）</td> 
  </tr> 
  <tr> 
   <td>-transitionToStandby</td> 
   <td>将给定NameNode的状态转换为Standby（警告：没有完成防护）</td> 
  </tr> 
  <tr> 
   <td>-help&nbsp;[cmd]</td> 
   <td>显示给定命令或所有命令的帮助（如果未指定）。</td> 
  </tr> 
 </tbody> 
</table>

有关此命令的更多信息，请参阅[带有NFS的][NFS][HDFS HA][]或[带有QJM的HDFS HA][HDFS HA]。

### **journalnode** ###

用法：hdfs journalnode

此comamnd启动一个日志节点，用于[与QJM一起][HDFS HA]使用[HDFS HA][]。

### **mover** ###

Usage: hdfs mover \[-p <files/dirs> | -f <local file name>\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-f&nbsp;&lt;local file&gt;</td> 
   <td>指定包含要迁移的HDFS文件/目录列表的本地文件。</td> 
  </tr> 
  <tr> 
   <td>-p&nbsp;&lt;files/dirs&gt;</td> 
   <td>指定要迁移的HDFS文件/目录的空格分隔列表。</td> 
  </tr> 
 </tbody> 
</table>

运行数据迁移实用程序。有关详细信息，请参阅[Mover][]。

请注意，当省略-p和-f选项时，默认路径是根目录。

此外，从2.7.0开始引入固定功能，以防止某些复制品被平衡器/移动器移动。默认情况下，此固定功能处于禁用状态，可通过配置属性“dfs.datanode.block-pinning.enabled”启用。启用时，此功能仅影响写入create（）调用中指定的favored节点的块。对于HBase regionserver等应用程序，我们希望维护数据局部性时，此功能非常有用。

### namenode ###

用法：

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-backup</td> 
   <td>启动备份节点。</td> 
  </tr> 
  <tr> 
   <td>-checkpoint</td> 
   <td>启动检查点节点。</td> 
  </tr> 
  <tr> 
   <td>-format&nbsp;[-clusterid cid]</td> 
   <td>格式化指定的NameNode。它启动NameNode，对其进行格式化然后将其关闭。如果name dir已存在且是否为集群禁用了重新格式化，则将抛出NameNodeFormatException。</td> 
  </tr> 
  <tr> 
   <td>-upgrade&nbsp;[-clusterid cid]&nbsp;[&nbsp;-renameReserved&nbsp;&lt;kv pairs&gt;]</td> 
   <td>在分发新的Hadoop版本后，应该使用升级选项启动Namenode。</td> 
  </tr> 
  <tr> 
   <td>-upgradeOnly&nbsp;[-clusterid cid]&nbsp;[&nbsp;-renameReserved&nbsp;&lt;kv pairs&gt;]</td> 
   <td>升级指定的NameNode然后关闭它。</td> 
  </tr> 
  <tr> 
   <td>-rollback</td> 
   <td>将NameNode回滚到以前的版本。应在停止群集并分发旧Hadoop版本后使用此方法。</td> 
  </tr> 
  <tr> 
   <td>-rollingUpgrade&nbsp;&lt;rollback | started&gt;</td> 
   <td>有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html#NameNode_Startup_Options" rel="nofollow">滚动升级文档</a></td> 
  </tr> 
  <tr> 
   <td>-importCheckpoint</td> 
   <td>从检查点目录加载图像并将其保存到当前目录中。从属性dfs.namenode.checkpoint.dir读取检查点目录</td> 
  </tr> 
  <tr> 
   <td>-initializeSharedEdits</td> 
   <td>格式化新的共享编辑目录并复制足够的编辑日志段，以便备用NameNode可以启动。</td> 
  </tr> 
  <tr> 
   <td>-bootstrapStandby&nbsp;[-force]&nbsp;[-nonInteractive]&nbsp;[-skipSharedEditsCheck]</td> 
   <td>允许通过从活动NameNode复制最新的命名空间快照来引导备用NameNode的存储目录。首次配置HA群集时使用此选项。-force或-nonInteractive选项与namenode -format命令中描述的含义相同。-skipSharedEditsCheck选项跳过编辑检查，确保我们在共享目录中已经有足够的编辑从活动的最后一个检查点启动。</td> 
  </tr> 
  <tr> 
   <td>-recover&nbsp;[-force]</td> 
   <td>在损坏的文件系统上恢复丢失的元数据。有关详细信息，请参阅<a href="https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#Recovery_Mode" rel="nofollow">HDFS用户指南</a>。</td> 
  </tr> 
  <tr> 
   <td>-metadataVersion</td> 
   <td>验证配置的目录是否存在，然后打印软件和映像的元数据版本。</td> 
  </tr> 
 </tbody> 
</table>

运行namenode。有关升级和回滚的更多信息，请参阅[升级回滚][Link 5]。

### **nfs3** ###

用法：hdfs nfs3

此comamnd启动NFS3网关以与[HDFS NFS3服务一起使用][HDFS NFS3]。

### **端口映射** ###

用法：hdfs portmap

此comamnd启动RPC [端口映射][HDFS NFS3]以与[HDFS NFS3服务一起使用][HDFS NFS3]。

### **secondarynamenode** ###

用法：hdfs secondarynamenode \[-checkpoint \[force\]\] | \[-format\] | \[-geteditsize\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-checkpoint&nbsp;[force]</td> 
   <td>如果EditLog size&gt; = fs.checkpoint.size，则检查SecondaryNameNode。如果使用force，则检查点与EditLog大小无关。</td> 
  </tr> 
  <tr> 
   <td>-format</td> 
   <td>启动期间格式化本地存储。</td> 
  </tr> 
  <tr> 
   <td>-geteditsize</td> 
   <td>打印NameNode上未取消选中的事务的数量。</td> 
  </tr> 
 </tbody> 
</table>

运行HDFS辅助名称节点。有关详细信息，请参阅[Secondary Namenode][]。

### **storagepolicies** ###

用法：

hdfs storagepolicies
          [-listPolicies]
          [-setStoragePolicy -path <path> -policy <policy>]
          [-getStoragePolicy -path <path>]
          [-unsetStoragePolicy -path <path>]
          [-satisfyStoragePolicy -path <path>]
          [-isSatisfierRunning]
          [-help <command-name>]

列出所有   all/Gets/sets/unsets   存储策略。有关更多信息，请参阅[HDFS存储策略文档][HDFS 3]。

### **zkfc** ###

用法：hdfs zkfc \[-formatZK \[-force\] \[-nonInteractive\]\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-formatZK</td> 
   <td>格式化Zookeeper实例。-force：如果znode存在，则格式化znode。-nonInteractive：如果znode存在，则格式化znode中止，除非指定了-force选项。</td> 
  </tr> 
  <tr> 
   <td> <p>-h</p> </td> 
   <td>显示帮助</td> 
  </tr> 
 </tbody> 
</table>

此comamnd启动Zookeeper故障转移控制器进程，以便与[带有QJM的HDFS HA一起使用][HDFS HA]。

## 调试命令 ##

帮助管理员调试HDFS问题的有用命令。这些命令仅适用于高级用户。

### verifyMeta ###

用法：hdfs debug verifyMeta -meta <metadata-file> \[-block <block-file>\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-block&nbsp;<em>block-file</em></td> 
   <td>可选参数，用于指定数据节点的本地文件系统上的块文件的绝对路径。</td> 
  </tr> 
  <tr> 
   <td>-meta&nbsp;<em>metadata-file</em></td> 
   <td>数据节点的本地文件系统上的元数据文件的绝对路径。</td> 
  </tr> 
 </tbody> 
</table>

验证HDFS元数据和块文件。如果指定了块文件，我们将验证元数据文件中的校验和是否与块文件匹配。

### **computeMeta** ###

用法：hdfs debug computeMeta -block <block-file> -out <output-metadata-file>

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-block&nbsp;<em>block-file</em></td> 
   <td>数据节点的本地文件系统上的块文件的绝对路径。</td> 
  </tr> 
  <tr> 
   <td>-out&nbsp;<em>output-metadata-file</em></td> 
   <td>输出元数据文件的绝对路径，用于存储块文件的校验和计算结果。</td> 
  </tr> 
 </tbody> 
</table>

从块文件计算HDFS元数据。如果指定了块文件，我们将从块文件计算校验和，并将其保存到指定的输出元数据文件中。

**注意**：使用风险自负！如果块文件损坏并且您覆盖了它的元文件，它将在HDFS中显示为“良好”，但您无法读取数据。仅用作最后一个度量，当您100％确定块文件是好的时。

### **recoverLease** ###

用法：hdfs debug recoverLease -path <path> \[-retries <num-retries>\]

<table> 
 <thead> 
  <tr> 
   <th>命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>[&nbsp;-path&nbsp;<em>path</em>&nbsp;]</td> 
   <td>要恢复租约的HDFS路径。</td> 
  </tr> 
  <tr> 
   <td>[&nbsp;-retries&nbsp;<em>num-retries</em>&nbsp;]</td> 
   <td>客户端重试调用recoverLease的次数。默认重试次数为1。</td> 
  </tr> 
 </tbody> 
</table>

恢复指定路径上的租约。该路径必须驻留在HDFS文件系统上。默认重试次数为1。

原文链接: [https://hadoop.apache.org/docs/r3.2.0/][https_hadoop.apache.org_docs_r3.2.0]

[User Commands]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#User_Commands
[classpath]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#classpath
[dfs]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#dfs
[envvars]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#envvars
[fetchdt]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#fetchdt
[fsck]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#fsck
[getconf]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#getconf
[groups]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#groups
[httpfs]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#httpfs
[lsSnapshottableDir]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#lsSnapshottableDir
[jmxget]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#jmxget
[oev]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#oev
[oiv]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#oiv
[oiv_legacy]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#oiv_legacy
[snapshotDiff]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#snapshotDiff
[version]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#version
[Administration Commands]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#Administration_Commands
[balancer]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#balancer
[cacheadmin]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#cacheadmin
[crypto]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#crypto
[datanode]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#datanode
[dfsadmin]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#dfsadmin
[dfsrouter]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#dfsrouter
[dfsrouteradmin]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#dfsrouteradmin
[diskbalancer]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#diskbalancer
[ec]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#ec
[haadmin]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#haadmin
[journalnode]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#journalnode
[mover]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#mover
[namenode]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#namenode
[nfs3]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#nfs3
[portmap]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#portmap
[secondarynamenode]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#secondarynamenode
[storagepolicies]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#storagepolicies
[zkfc]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#zkfc
[Debug Commands]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#Debug_Commands
[verifyMeta]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#verifyMeta
[computeMeta]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#computeMeta
[recoverLease]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSCommands.html#recoverLease
[File System Shell Guide]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html
[fetchdt 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#fetchdt
[fsck 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#fsck
[Link 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsEditsViewer.html
[Link 2]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsImageViewer.html
[oiv_legacy 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsImageViewer.html#oiv_legacy_Command
[HDFS]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsSnapshots.html#Get_Snapshots_Difference_Report
[Balancer]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#Balancer
[HDFS 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/CentralizedCacheManagement.html#cacheadmin_command-line_interface
[HDFS 2]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/TransparentEncryption.html#crypto_command-line_interface
[Link 3]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs-rbf/HDFSRouterFederation.html#Router
[Link 4]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs-rbf/HDFSRouterFederation.html#Mount_table_management
[HDFS Diskbalancer]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSDiskbalancer.html
[HDFS ErasureCoding]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSErasureCoding.html#Administrative_commands
[NFS]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSHighAvailabilityWithNFS.html#Administrative_commands
[HDFS HA]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HDFSHighAvailabilityWithQJM.html#Administrative_commands
[Mover]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/ArchivalStorage.html#Mover_-_A_New_Data_Migration_Tool
[Link 5]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#Upgrade_and_Rollback
[HDFS NFS3]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsNfsGateway.html#Start_and_stop_NFS_gateway_service
[Secondary Namenode]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html#Secondary_NameNode
[HDFS 3]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/ArchivalStorage.html
[https_hadoop.apache.org_docs_r3.2.0]: https://hadoop.apache.org/docs/r3.2.0/