{"record":{"id":"fc0154e12603ec32","repo":"apache/hadoop","slug":"invalid-value-configured-for-dfs-datanode-disk-che-fc0154","errorCode":null,"errorMessage":"Invalid value configured for dfs.datanode.disk.check.timeout - {} (should be > 0)","messagePattern":"Invalid value configured for dfs\\.datanode\\.disk\\.check\\.timeout - (.+?) \\(should be > 0\\)","errorType":"exception","errorClass":"HadoopIllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/checker/StorageLocationChecker.java","lineNumber":98,"sourceCode":"   * Expected filesystem permissions on the storage directory.\n   */\n  private final FsPermission expectedPermission;\n\n  /**\n   * Maximum number of volume failures that can be tolerated without\n   * declaring a fatal error.\n   */\n  private final int maxVolumeFailuresTolerated;\n\n  public StorageLocationChecker(Configuration conf, Timer timer)\n      throws DiskErrorException {\n    maxAllowedTimeForCheckMs = conf.getTimeDuration(\n        DFS_DATANODE_DISK_CHECK_TIMEOUT_KEY,\n        DFS_DATANODE_DISK_CHECK_TIMEOUT_DEFAULT,\n        TimeUnit.MILLISECONDS);\n\n    if (maxAllowedTimeForCheckMs <= 0) {\n      throw new HadoopIllegalArgumentException(\"Invalid value configured for \"\n          + DFS_DATANODE_DISK_CHECK_TIMEOUT_KEY + \" - \"\n          + maxAllowedTimeForCheckMs + \" (should be > 0)\");\n    }\n\n    expectedPermission = new FsPermission(\n        conf.get(DFS_DATANODE_DATA_DIR_PERMISSION_KEY,\n            DFS_DATANODE_DATA_DIR_PERMISSION_DEFAULT));\n\n    maxVolumeFailuresTolerated = conf.getInt(\n        DFS_DATANODE_FAILED_VOLUMES_TOLERATED_KEY,\n        DFS_DATANODE_FAILED_VOLUMES_TOLERATED_DEFAULT);\n\n    if (maxVolumeFailuresTolerated < DataNode.MAX_VOLUME_FAILURE_TOLERATED_LIMIT) {\n      throw new HadoopIllegalArgumentException(\"Invalid value configured for \"\n          + DFS_DATANODE_FAILED_VOLUMES_TOLERATED_KEY + \" - \"\n          + maxVolumeFailuresTolerated + \" \"\n          + DataNode.MAX_VOLUME_FAILURES_TOLERATED_MSG);\n    }","sourceCodeStart":80,"sourceCodeEnd":116,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/checker/StorageLocationChecker.java#L80-L116","documentation":"Error \"Invalid value configured for dfs.datanode.disk.check.timeout - {} (should be > 0)\" thrown in apache/hadoop.","triggerScenarios":"Startup validation finds dfs.datanode.disk.check.timeout configured to zero or a negative value.","commonSituations":"dfs.datanode.disk.check.timeout was configured to a non-positive value. Set it to a positive duration so disk checks can complete.","solutions":["Set dfs.datanode.disk.check.timeout to a positive duration (greater than 0) in hdfs-site.xml and restart the DataNode.","Remove the property to use the default timeout if unsure."],"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-23T01:17:44.959Z"}