{"record":{"id":"6e71abbe533d041f","repo":"apache/hadoop","slug":"unable-to-find-the-specified-node-node","errorCode":null,"errorMessage":"Unable to find the specified node. {node}","messagePattern":"Unable to find the specified node\\. (.+?)","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/diskbalancer/command/PlanCommand.java","lineNumber":124,"sourceCode":"    }\n\n    if (cmd.hasOption(DiskBalancerCLI.MAXERROR)) {\n      this.maxError = Integer.parseInt(cmd.getOptionValue(DiskBalancerCLI\n          .MAXERROR));\n    }\n\n    readClusterInfo(cmd);\n    String output = null;\n    if (cmd.hasOption(DiskBalancerCLI.OUTFILE)) {\n      output = cmd.getOptionValue(DiskBalancerCLI.OUTFILE);\n    }\n    setOutputPath(output);\n\n    // -plan nodename is the command line argument.\n    DiskBalancerDataNode node =\n        getNode(cmd.getOptionValue(DiskBalancerCLI.PLAN));\n    if (node == null) {\n      throw new IllegalArgumentException(\"Unable to find the specified node. \" +\n          cmd.getOptionValue(DiskBalancerCLI.PLAN));\n    }\n\n    try (FSDataOutputStream beforeStream = create(String.format(\n        DiskBalancerCLI.BEFORE_TEMPLATE,\n        cmd.getOptionValue(DiskBalancerCLI.PLAN)))) {\n      beforeStream.write(getCluster().toJson()\n          .getBytes(StandardCharsets.UTF_8));\n    }\n\n    this.thresholdPercentage = getThresholdPercentage(cmd);\n\n    LOG.debug(\"threshold Percentage is {}\", this.thresholdPercentage);\n    setNodesToProcess(node);\n    populatePathNames(node);\n\n    NodePlan plan = null;\n    List<NodePlan> plans = getCluster().computePlan(this.thresholdPercentage);","sourceCodeStart":106,"sourceCodeEnd":142,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/diskbalancer/command/PlanCommand.java#L106-L142","documentation":"Error \"Unable to find the specified node. {node}\" thrown in apache/hadoop.","triggerScenarios":"DiskBalancer plan command when the specified node is not known to the DiskBalancer cluster snapshot.","commonSituations":"See trigger scenarios.","solutions":["Verify the node name/IP matches a live DataNode as reported by 'hdfs dfsadmin -report'.","Correct typos in the node identifier or use the DataNode's UUID/hostname as registered."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}