1. 程式人生 > >Hadoop命令手冊

Hadoop命令手冊

classname 分隔 ktr section 任務 hdf 不可 1.0 給定

原文地址:http://hadoop.apache.org/docs/r1.0.4/cn/commands_manual.html

  • 概述
    • 常規選項
  • 用戶命令
    • archive
    • distcp
    • fs
    • fsck
    • jar
    • job
    • pipes
    • version
    • CLASSNAME
  • 管理命令
    • balancer
    • daemonlog
    • datanode
    • dfsadmin
    • jobtracker
    • namenode
    • secondarynamenode
    • tasktracker

概述

所有的hadoop命令均由bin/hadoop腳本引發。不指定參數運行hadoop腳本會打印所有命令的描述。

用法:hadoop [--config confdir] [COMMAND] [GENERIC_OPTIONS] [COMMAND_OPTIONS]

Hadoop有一個選項解析框架用於解析一般的選項和運行類。

命令選項描述
--config confdir 覆蓋缺省配置目錄。缺省是${HADOOP_HOME}/conf。
GENERIC_OPTIONS 多個命令都支持的通用選項。
COMMAND
命令選項S
各種各樣的命令和它們的選項會在下面提到。這些命令被分為 用戶命令 管理命令兩組。

常規選項

下面的選項被 dfsadmin, fs, fsck和 job支持。 應用程序要實現 Tool來支持 常規選項。

GENERIC_OPTION 描述
-conf <configuration file> 指定應用程序的配置文件。
-D <property=value>
為指定property指定值value。
-fs <local|namenode:port> 指定namenode。
-jt <local|jobtracker:port> 指定job tracker。只適用於job。
-files <逗號分隔的文件列表> 指定要拷貝到map reduce集群的文件的逗號分隔的列表。 只適用於job。
-libjars <逗號分隔的jar列表> 指定要包含到classpath中的jar文件的逗號分隔的列表。 只適用於job。
-archives <逗號分隔的archive列表> 指定要被解壓到計算節點上的檔案文件的逗號分割的列表。 只適用於job。

用戶命令

hadoop集群用戶的常用命令。

archive

創建一個hadoop檔案文件。參考 Hadoop Archives.

用法:hadoop archive -archiveName NAME <src>* <dest>

命令選項 描述
-archiveName NAME 要創建的檔案的名字。
src 文件系統的路徑名,和通常含正則表達的一樣。
dest 保存檔案文件的目標目錄。

distcp

遞歸地拷貝文件或目錄。參考DistCp指南以獲取等多信息。

用法:hadoop distcp <srcurl> <desturl>

命令選項 描述
srcurl 源Url
desturl 目標Url

fs

用法:hadoop fs [GENERIC_OPTIONS] [COMMAND_OPTIONS]

運行一個常規的文件系統客戶端。

各種命令選項可以參考HDFS Shell指南。

fsck

運行HDFS文件系統檢查工具。參考Fsck了解更多。

用法:hadoop fsck [GENERIC_OPTIONS] <path> [-move | -delete | -openforwrite] [-files [-blocks [-locations | -racks]]]

命令選項 描述
<path> 檢查的起始目錄。
-move 移動受損文件到/lost+found
-delete 刪除受損文件。
-openforwrite 打印出寫打開的文件。
-files 打印出正被檢查的文件。
-blocks 打印出塊信息報告。
-locations 打印出每個塊的位置信息。
-racks 打印出data-node的網絡拓撲結構。

jar

運行jar文件。用戶可以把他們的Map Reduce代碼捆綁到jar文件中,使用這個命令執行。

用法:hadoop jar <jar> [mainClass] args...

streaming作業是通過這個命令執行的。參考Streaming examples中的例子。

Word count例子也是通過jar命令運行的。參考Wordcount example。

job

用於和Map Reduce作業交互和命令。

用法:hadoop job [GENERIC_OPTIONS] [-submit <job-file>] | [-status <job-id>] | [-counter <job-id> <group-name> <counter-name>] | [-kill <job-id>] | [-events <job-id> <from-event-#> <#-of-events>] | [-history [all] <jobOutputDir>] | [-list [all]] | [-kill-task <task-id>] | [-fail-task <task-id>]

命令選項 描述
-submit <job-file> 提交作業
-status <job-id> 打印map和reduce完成百分比和所有計數器。
-counter <job-id> <group-name> <counter-name> 打印計數器的值。
-kill <job-id> 殺死指定作業。
-events <job-id> <from-event-#> <#-of-events> 打印給定範圍內jobtracker接收到的事件細節。
-history [all] <jobOutputDir> -history <jobOutputDir> 打印作業的細節、失敗及被殺死原因的細節。更多的關於一個作業的細節比如成功的任務,做過的任務嘗試等信息可以通過指定[all]選項查看。
-list [all] -list all顯示所有作業。-list只顯示將要完成的作業。
-kill-task <task-id> 殺死任務。被殺死的任務不會不利於失敗嘗試。
-fail-task <task-id> 使任務失敗。被失敗的任務會對失敗嘗試不利。

pipes

運行pipes作業。

用法:hadoop pipes [-conf <path>] [-jobconf <key=value>, <key=value>, ...] [-input <path>] [-output <path>] [-jar <jar file>] [-inputformat <class>] [-map <class>] [-partitioner <class>] [-reduce <class>] [-writer <class>] [-program <executable>] [-reduces <num>]

命令選項 描述
-conf <path> 作業的配置
-jobconf <key=value>, <key=value>, ... 增加/覆蓋作業的配置項
-input <path> 輸入目錄
-output <path> 輸出目錄
-jar <jar file> Jar文件名
-inputformat <class> InputFormat類
-map <class> Java Map類
-partitioner <class> Java Partitioner
-reduce <class> Java Reduce類
-writer <class> Java RecordWriter
-program <executable> 可執行程序的URI
-reduces <num> reduce個數

version

打印版本信息。

用法:hadoop version

CLASSNAME

hadoop腳本可用於調調用任何類。

用法:hadoop CLASSNAME

運行名字為CLASSNAME的類。

管理命令

hadoop集群管理員常用的命令。

balancer

運行集群平衡工具。管理員可以簡單的按Ctrl-C來停止平衡過程。參考Rebalancer了解更多。

用法:hadoop balancer [-threshold <threshold>]

命令選項 描述
-threshold <threshold> 磁盤容量的百分比。這會覆蓋缺省的閥值。

daemonlog

獲取或設置每個守護進程的日誌級別。

用法:hadoop daemonlog -getlevel <host:port> <name>
用法:hadoop daemonlog -setlevel <host:port> <name> <level>

命令選項 描述
-getlevel <host:port> <name> 打印運行在<host:port>的守護進程的日誌級別。這個命令內部會連接http://<host:port>/logLevel?log=<name>
-setlevel <host:port> <name> <level> 設置運行在<host:port>的守護進程的日誌級別。這個命令內部會連接http://<host:port>/logLevel?log=<name>

datanode

運行一個HDFS的datanode。

用法:hadoop datanode [-rollback]

命令選項 描述
-rollback 將datanode回滾到前一個版本。這需要在停止datanode,分發老的hadoop版本之後使用。

dfsadmin

運行一個HDFS的dfsadmin客戶端。

用法:hadoop dfsadmin [GENERIC_OPTIONS] [-report] [-safemode enter | leave | get | wait] [-refreshNodes] [-finalizeUpgrade] [-upgradeProgress status | details | force] [-metasave filename] [-setQuota <quota> <dirname>...<dirname>] [-clrQuota <dirname>...<dirname>] [-help [cmd]]

命令選項 描述
-report 報告文件系統的基本信息和統計信息。
-safemode enter | leave | get | wait 安全模式維護命令。安全模式是Namenode的一個狀態,這種狀態下,Namenode
1. 不接受對名字空間的更改(只讀)
2. 不復制或刪除塊
Namenode會在啟動時自動進入安全模式,當配置的塊最小百分比數滿足最小的副本數條件時,會自動離開安全模式。安全模式可以手動進入,但是這樣的話也必須手動關閉安全模式。
-refreshNodes 重新讀取hosts和exclude文件,更新允許連到Namenode的或那些需要退出或入編的Datanode的集合。
-finalizeUpgrade 終結HDFS的升級操作。Datanode刪除前一個版本的工作目錄,之後Namenode也這樣做。這個操作完結整個升級過程。
-upgradeProgress status | details | force 請求當前系統的升級狀態,狀態的細節,或者強制升級操作進行。
-metasave filename 保存Namenode的主要數據結構到hadoop.log.dir屬性指定的目錄下的<filename>文件。對於下面的每一項,<filename>中都會一行內容與之對應
1. Namenode收到的Datanode的心跳信號
2. 等待被復制的塊
3. 正在被復制的塊
4. 等待被刪除的塊
-setQuota <quota> <dirname>...<dirname> 為每個目錄 <dirname>設定配額<quota>。目錄配額是一個長整型整數,強制限定了目錄樹下的名字個數。
命令會在這個目錄上工作良好,以下情況會報錯:
1. N不是一個正整數,或者
2. 用戶不是管理員,或者
3. 這個目錄不存在或是文件,或者
4. 目錄會馬上超出新設定的配額。
-clrQuota <dirname>...<dirname> 為每一個目錄<dirname>清除配額設定。
命令會在這個目錄上工作良好,以下情況會報錯:
1. 這個目錄不存在或是文件,或者
2. 用戶不是管理員。
如果目錄原來沒有配額不會報錯。
-help [cmd] 顯示給定命令的幫助信息,如果沒有給定命令,則顯示所有命令的幫助信息。

jobtracker

運行MapReduce job Tracker節點。

用法:hadoop jobtracker

namenode

運行namenode。有關升級,回滾,升級終結的更多信息請參考升級和回滾。

用法:hadoop namenode [-format] | [-upgrade] | [-rollback] | [-finalize] | [-importCheckpoint]

命令選項 描述
-format 格式化namenode。它啟動namenode,格式化namenode,之後關閉namenode。
-upgrade 分發新版本的hadoop後,namenode應以upgrade選項啟動。
-rollback 將namenode回滾到前一版本。這個選項要在停止集群,分發老的hadoop版本後使用。
-finalize finalize會刪除文件系統的前一狀態。最近的升級會被持久化,rollback選項將再不可用,升級終結操作之後,它會停掉namenode。
-importCheckpoint 從檢查點目錄裝載鏡像並保存到當前檢查點目錄,檢查點目錄由fs.checkpoint.dir指定。

secondarynamenode

運行HDFS的secondary namenode。參考Secondary Namenode了解更多。

用法:hadoop secondarynamenode [-checkpoint [force]] | [-geteditsize]

命令選項 描述
-checkpoint [force] 如果EditLog的大小 >= fs.checkpoint.size,啟動Secondary namenode的檢查點過程。 如果使用了-force,將不考慮EditLog的大小。
-geteditsize 打印EditLog大小。

tasktracker

運行MapReduce的task Tracker節點。

用法:hadoop tasktracker

Hadoop命令手冊