{"record":{"id":"24cf73080bee4af7","repo":"apache/hadoop","slug":"a-node-name-is-required-to-create-a-plan","errorCode":null,"errorMessage":"A node name is required to create a plan.","messagePattern":"A node name is required to create a plan\\.","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":99,"sourceCode":"\n  /**\n   * Runs the plan command. This command can be run with various options like\n   * <p>\n   * -plan -node IP -plan -node hostName -plan -node DatanodeUUID\n   *\n   * @param cmd - CommandLine\n   * @throws Exception\n   */\n  @Override\n  public void execute(CommandLine cmd) throws Exception {\n    TextStringBuilder result = new TextStringBuilder();\n    String outputLine = \"\";\n    LOG.debug(\"Processing Plan Command.\");\n    Preconditions.checkState(cmd.hasOption(DiskBalancerCLI.PLAN));\n    verifyCommandOptions(DiskBalancerCLI.PLAN, cmd);\n\n    if (cmd.getOptionValue(DiskBalancerCLI.PLAN) == null) {\n      throw new IllegalArgumentException(\"A node name is required to create a\" +\n          \" plan.\");\n    }\n\n    if (cmd.hasOption(DiskBalancerCLI.BANDWIDTH)) {\n      this.bandwidth = Integer.parseInt(cmd.getOptionValue(DiskBalancerCLI\n          .BANDWIDTH));\n    }\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    }","sourceCodeStart":81,"sourceCodeEnd":117,"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#L81-L117","documentation":"Error \"A node name is required to create a plan.\" thrown in apache/hadoop.","triggerScenarios":"DiskBalancer plan command invoked without any node name to build a plan for.","commonSituations":"See trigger scenarios.","solutions":["Specify the target DataNode with the -node option when creating a diskbalancer plan."],"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"}