{"record":{"id":"588de10f0b1dd178","repo":"apache/hadoop","slug":"file-under-construction-found-without-clientmac","errorCode":null,"errorMessage":"<file-under-construction> found without <clientMachine>","messagePattern":"<file-under-construction> found without <clientMachine>","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/tools/offlineImageViewer/OfflineImageReconstructor.java","lineNumber":702,"sourceCode":"      }\n    }\n    Node fileUnderConstruction =\n        node.removeChild(INODE_SECTION_FILE_UNDER_CONSTRUCTION);\n    if (fileUnderConstruction != null) {\n      INodeSection.FileUnderConstructionFeature.Builder fb =\n          INodeSection.FileUnderConstructionFeature.newBuilder();\n      String clientName =\n          fileUnderConstruction.removeChildStr(INODE_SECTION_CLIENT_NAME);\n      if (clientName == null) {\n        throw new IOException(\"<file-under-construction> found without \" +\n            \"<clientName>\");\n      }\n      fb.setClientName(clientName);\n      String clientMachine =\n          fileUnderConstruction\n                  .removeChildStr(INODE_SECTION_CLIENT_MACHINE);\n      if (clientMachine == null) {\n        throw new IOException(\"<file-under-construction> found without \" +\n            \"<clientMachine>\");\n      }\n      fb.setClientMachine(clientMachine);\n      bld.setFileUC(fb);\n    }\n    Node acls = node.removeChild(INODE_SECTION_ACLS);\n    if (acls != null) {\n      bld.setAcl(aclXmlToProto(acls));\n    }\n    Node xattrs = node.removeChild(INODE_SECTION_XATTRS);\n    if (xattrs != null) {\n      bld.setXAttrs(xattrsXmlToProto(xattrs));\n    }\n    ival = node.removeChildInt(INODE_SECTION_STORAGE_POLICY_ID);\n    if (ival != null) {\n      bld.setStoragePolicyID(ival);\n    }\n    String blockType = node.removeChildStr(INODE_SECTION_BLOCK_TYPE);","sourceCodeStart":684,"sourceCodeEnd":720,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/tools/offlineImageViewer/OfflineImageReconstructor.java#L684-L720","documentation":"Error \"<file-under-construction> found without <clientMachine>\" thrown in apache/hadoop.","triggerScenarios":"Thrown by oiv -r when a <file-under-construction> stanza lacks the required <clientMachine> element in the fsimage XML.","commonSituations":"See trigger scenarios.","solutions":["Add the missing <clientMachine> element to the <file-under-construction> stanza in the fsimage XML.","Regenerate the fsimage XML with 'hdfs oiv' from a valid fsimage instead of editing it by hand."],"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-22T20:17:22.307Z"}