{"record":{"id":"83f6616ea0be98fb","repo":"apache/hadoop","slug":"failed-to-promote-checkpoint-tmpfile-dst-d","errorCode":null,"errorMessage":"Failed to promote checkpoint${tmpfile(dst)} -> ${dst}","messagePattern":"Failed to promote checkpoint(.+?) -> (.+?)","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-core/src/main/java/org/apache/hadoop/mapreduce/checkpoint/FSCheckpointService.java","lineNumber":151,"sourceCode":"    @Override\n    public boolean isOpen() {\n      return isOpen;\n    }\n\n  }\n\n  @Override\n  public CheckpointID commit(CheckpointWriteChannel ch)\n      throws IOException, InterruptedException {\n    if (ch.isOpen()) {\n      ch.close();\n    }\n    FSCheckpointWriteChannel hch = (FSCheckpointWriteChannel)ch;\n    Path dst = hch.getDestination();\n    if (!fs.rename(tmpfile(dst), dst)) {\n      // attempt to clean up\n      abort(ch);\n      throw new IOException(\"Failed to promote checkpoint\" +\n      \t\t tmpfile(dst) + \" -> \" + dst);\n    }\n    return new FSCheckpointID(hch.getDestination());\n  }\n\n  @Override\n  public void abort(CheckpointWriteChannel ch) throws IOException {\n    if (ch.isOpen()) {\n      ch.close();\n    }\n    FSCheckpointWriteChannel hch = (FSCheckpointWriteChannel)ch;\n    Path tmp = tmpfile(hch.getDestination());\n    try {\n      if (!fs.delete(tmp, false)) {\n        throw new IOException(\"Failed to delete checkpoint during abort\");\n      }\n    } catch (FileNotFoundException e) {\n      // IGNORE","sourceCodeStart":133,"sourceCodeEnd":169,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-core/src/main/java/org/apache/hadoop/mapreduce/checkpoint/FSCheckpointService.java#L133-L169","documentation":"Error \"Failed to promote checkpoint${tmpfile(dst)} -> ${dst}\" thrown in apache/hadoop.","triggerScenarios":"Thrown at hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-core/src/main/java/org/apache/hadoop/mapreduce/checkpoint/FSCheckpointService.java:151 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check filesystem permissions and available space for the checkpoint directory; the atomic rename from the temp file failed, so retry after resolving the FS error."],"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"}