apache/hadoop · error · IllegalArgumentException

Too many arguments, Max=1 argument allowed only

Error message

Too many arguments, Max=1 argument allowed only

What it means

Error "Too many arguments, Max=1 argument allowed only" thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs-rbf/src/main/java/org/apache/hadoop/hdfs/tools/federation/RouterAdmin.java:235

    } else if (cmd.equals(DUMP_COMMAND)) {
      return "\t[" + DUMP_COMMAND + "]";
    }
    return getUsage(null);
  }

  /**
   * Usage: validates the maximum number of arguments for a command.
   * @param arg List of command line parameters.
   */
  private void validateMax(String[] arg) {
    if (arg[0].equals("-ls")) {
      if (arg.length > 3) {
        throw new IllegalArgumentException(
            "Too many arguments, Max=2 argument allowed");
      }
    } else if (arg[0].equals("-getDestination")) {
      if (arg.length > 2) {
        throw new IllegalArgumentException(
            "Too many arguments, Max=1 argument allowed only");
      }
    } else if (arg[0].equals("-safemode")) {
      if (arg.length > 2) {
        throw new IllegalArgumentException(
            "Too many arguments, Max=1 argument allowed only");
      }
    } else if (arg[0].equals("-nameservice")) {
      if (arg.length > 3) {
        throw new IllegalArgumentException(
            "Too many arguments, Max=2 arguments allowed");
      }
    } else if (arg[0].equals("-getDisabledNameservices")) {
      if (arg.length > 1) {
        throw new IllegalArgumentException("No arguments allowed");
      }
    } else if (arg[0].equals("-refreshSuperUserGroupsConfiguration")) {
      if (arg.length > 1) {

View on GitHub (pinned to 2add963021)

Solutions

  1. Pass at most 1 argument to this subcommand.
  2. Quote arguments containing spaces.

When it happens

Trigger: RouterAdmin argument parsing: more than 1 positional argument supplied.

Common situations: Extra tokens on the dfsrouteradmin command line for a single-argument operation.


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