Hadoop 1.1.2升级至2.9.0遇阻：如何追踪升级进度？

当你执行start-dfs.sh -upgrade后遇到进度停滞的情况，可以通过以下几种方式来追踪升级状态、定位问题：

• 实时监控NameNode日志
  这是最能直接获取升级细节的方式。NameNode的日志默认存放在$HADOOP_HOME/logs目录下，文件名格式为hadoop-*-namenode-$(hostname).log。你可以用命令实时跟踪日志输出：

  tail -f $HADOOP_HOME/logs/hadoop-*-namenode-$(hostname).log
  

  日志里会明确记录升级的每一步，比如元数据格式转换、块报告收集、状态校验等，找包含Upgrade progress、Processing fsimage这类关键词的条目，就能清楚当前卡在哪个阶段。

• 用HDFS命令查询官方状态
  Hadoop 2.x提供了专门的升级状态查询命令，直接在终端执行：

  hdfs dfsadmin -upgradeProgress status
  

  这个命令会返回简洁的状态摘要，包括当前升级阶段、完成百分比、是否有失败项。如果需要更详细的组件级进度，用：

  hdfs dfsadmin -upgradeProgress details
  

  它会列出NameNode、DataNode各自的进度情况，帮你快速定位是哪个环节卡住了。

• 查看NameNode Web UI
  打开浏览器访问NameNode的Web界面（默认端口是50070），在集群概览或者专门的「Upgrade Status」板块里，会有直观的进度条、当前阶段描述，甚至剩余预估时间。这种方式适合不想看命令行的用户，一目了然。

• 检查元数据目录的变化
  NameNode的元数据默认存储在$HADOOP_HOME/dfs/name/current目录下，升级过程中会生成upgrade子目录存放临时文件。你可以定期查看这个目录的文件更新情况：如果文件在持续生成或修改，说明升级还在推进；如果长时间没有变化，大概率是进程卡住了。另外，current目录下的VERSION文件也能帮你确认当前集群的版本状态。

• 验证DataNode的在线状态
  升级过程中需要所有DataNode完成块报告同步才能继续，要是有DataNode离线或者通信异常，会导致升级停滞。执行以下命令检查DataNode状态：

  hdfs dfsadmin -report
  

  看输出里的「Live DataNodes」数量是否符合预期，有没有DataNode处于Decommissioned或者Dead状态，这类情况需要排查DataNode的日志或网络连通性。

如果排查后发现升级确实卡住了，优先看NameNode日志里的报错信息——毕竟1.1.2到2.9.0的版本跨度很大，可能存在旧配置不兼容、元数据格式异常等问题，针对性调整后再尝试重新触发升级。

内容的提问来源于stack exchange，提问作者Jon Andrews