{"record":{"id":"a1c71385f638b9f2","repo":"apache/hadoop","slug":"file-name-is-reserved-please-change-the-n","errorCode":null,"errorMessage":"File name \\\"{}\\\" is reserved. Please  change the name of the existing file or directory to another name before upgrading to this release.","messagePattern":"File name \\\\\"(.+?)\\\\\" is reserved\\. Please  change the name of the existing file or directory to another name before upgrading to this release\\.","errorType":"exception","errorClass":"HadoopIllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImageFormatPBINode.java","lineNumber":486,"sourceCode":"\n    /**\n     * Load the under-construction files section, and update the lease map\n     */\n    void loadFilesUnderConstructionSection(InputStream in) throws IOException {\n      // Leases are added when the inode section is loaded. This section is\n      // still read in for compatibility reasons.\n      while (true) {\n        FileUnderConstructionEntry entry = FileUnderConstructionEntry\n            .parseDelimitedFrom(in);\n        if (entry == null) {\n          break;\n        }\n      }\n    }\n\n    private boolean addToParent(INodeDirectory parentDir, INode child) {\n      if (parentDir == dir.rootDir && FSDirectory.isReservedName(child)) {\n        throw new HadoopIllegalArgumentException(\"File name \\\"\"\n            + child.getLocalName() + \"\\\" is reserved. Please \"\n            + \" change the name of the existing file or directory to another \"\n            + \"name before upgrading to this release.\");\n      }\n      // NOTE: This does not update space counts for parents\n      if (!parentDir.addChildAtLoading(child)) {\n        return false;\n      }\n      return true;\n    }\n\n    private INode loadINode(INodeSection.INode n) {\n      switch (n.getType()) {\n      case FILE:\n        return loadINodeFile(n);\n      case DIRECTORY:\n        return loadINodeDirectory(n, parent.getLoaderContext());\n      case SYMLINK:","sourceCodeStart":468,"sourceCodeEnd":504,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSImageFormatPBINode.java#L468-L504","documentation":"Error \"File name \\\"{}\\\" is reserved. Please  change the name of the existing file or directory to another name before upgrading to this release.\" thrown in apache/hadoop.","triggerScenarios":"Upgrading an fsimage that contains a file or directory whose name is reserved in this release (e.g. '.snapshot').","commonSituations":"See trigger scenarios.","solutions":["Rename the file or directory with the reserved name before upgrading to this release."],"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"}