apache/hadoop · error · IllegalArgumentException

Unrecognized planner name : {plannerName}

Error message

Unrecognized planner name : {plannerName}

What it means

Error "Unrecognized planner name : {plannerName}" thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/diskbalancer/planner/PlannerFactory.java:53

   * @param plannerName - name of the planner.
   * @param node - Datanode.
   * @param threshold - percentage
   * @return Planner
   */
  public static Planner getPlanner(String plannerName,
      DiskBalancerDataNode node, double threshold) {
    if (plannerName.equals(GREEDY_PLANNER)) {
      if (LOG.isDebugEnabled()) {
        String message = String
            .format("Creating a %s for Node : %s IP : %s ID : %s",
                GREEDY_PLANNER, node.getDataNodeName(), node.getDataNodeIP(),
                node.getDataNodeUUID());
        LOG.debug(message);
      }
      return new GreedyPlanner(threshold, node);
    }

    throw new IllegalArgumentException("Unrecognized planner name : " +
        plannerName);
  }

  private PlannerFactory() {
    // Never constructed
  }
}

View on GitHub (pinned to 2add963021)

Solutions

1. Use a recognized planner name (e.g. GreedyPlanner) in the diskbalancer configuration or plan request.
2. Check for typos in dfs.diskbalancer.planner or the planner argument.

When it happens

Trigger: DiskBalancer planning when the configured planner name is not one of the supported planners (e.g. GreedyPlanner).

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/4ceaec05efb80f3f. Report an issue: GitHub.