{"record":{"id":"e8a25d7c268f7bd8","repo":"apache/hadoop","slug":"checkpoint-directory-does-not-exist-or-is-not-acce","errorCode":null,"errorMessage":"checkpoint directory does not exist or is not accessible.","messagePattern":"checkpoint directory does not exist or is not accessible\\.","errorType":"exception","errorClass":"InconsistentFSStateException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/BackupImage.java","lineNumber":128,"sourceCode":"  /**\n   * Analyze backup storage directories for consistency.<br>\n   * Recover from incomplete checkpoints if required.<br>\n   * Read VERSION and fstime files if exist.<br>\n   * Do not load image or edits.\n   *\n   * @throws IOException if the node should shutdown.\n   */\n  void recoverCreateRead() throws IOException {\n    for (Iterator<StorageDirectory> it = storage.dirIterator(); it.hasNext();) {\n      StorageDirectory sd = it.next();\n      StorageState curState;\n      try {\n        curState = sd.analyzeStorage(HdfsServerConstants.StartupOption.REGULAR, storage);\n        // sd is locked but not opened\n        switch(curState) {\n        case NON_EXISTENT:\n          // fail if any of the configured storage dirs are inaccessible\n          throw new InconsistentFSStateException(sd.getRoot(),\n                \"checkpoint directory does not exist or is not accessible.\");\n        case NOT_FORMATTED:\n          // for backup node all directories may be unformatted initially\n          LOG.info(\"Storage directory \" + sd.getRoot() + \" is not formatted.\");\n          LOG.info(\"Formatting ...\");\n          sd.clearDirectory(); // create empty current\n          break;\n        case NORMAL:\n          break;\n        default:  // recovery is possible\n          sd.doRecover(curState);\n        }\n        if(curState != StorageState.NOT_FORMATTED) {\n          // read and verify consistency with other directories\n          storage.readProperties(sd);\n        }\n      } catch(IOException ioe) {\n        sd.unlock();","sourceCodeStart":110,"sourceCodeEnd":146,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/BackupImage.java#L110-L146","documentation":"Error \"checkpoint directory does not exist or is not accessible.\" thrown in apache/hadoop.","triggerScenarios":"Checkpoint/backup image load when the configured checkpoint directory (dfs.namenode.checkpoint.dir) is missing or unreadable.","commonSituations":"See trigger scenarios.","solutions":["Create the checkpoint directory (dfs.namenode.checkpoint.dir) with proper ownership and permissions for the NameNode/BackupNode user.","Verify the configured checkpoint directory path is mounted and accessible."],"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"}