{"record":{"id":"c64e04acd5b21af1","repo":"vllm-project/vllm","slug":"failed-to-register-local-memory-e","errorCode":null,"errorMessage":"Failed to register local memory: {e}","messagePattern":"Failed to register local memory: (.+?)","errorType":"exception","errorClass":"MoRIIOError","httpStatus":null,"severity":"error","filePath":"vllm/distributed/kv_transfer/kv_connector/v1/moriio/moriio_engine.py","lineNumber":604,"sourceCode":"\n    def register_remote_engine(self, remote_packed_engine_metadata):\n        assert self.moriio_engine is not None, \"MoRIIO engine must be set first\"\n        consumer_engine_metadata = EngineDesc.unpack(remote_packed_engine_metadata)\n        self.moriio_engine.register_remote_engine(consumer_engine_metadata)\n        return consumer_engine_metadata.key\n\n    def register_local_tensor(self, tensor: torch.Tensor):\n        assert self.moriio_engine is not None, \"MoRIIO engine must be set first\"\n        try:\n            self.local_memory_metadata = self.moriio_engine.register_torch_tensor(\n                tensor\n            )\n            assert self.local_memory_metadata is not None, (\n                \"register_torch_tensor returned None\"\n            )\n            local_memory_metadata_packed = self.local_memory_metadata.pack()\n        except Exception as e:\n            raise MoRIIOError(f\"Failed to register local memory: {e}\") from e\n        self.local_memory_registered = True\n        return local_memory_metadata_packed\n\n    def get_unpack_memory_metadata(self, packed_memory_metadata):\n        return MemoryDesc.unpack(packed_memory_metadata)\n\n    def build_session(self, local_memory_metadata, remote_memory_metadata):\n        assert self.moriio_engine is not None, \"MoRIIO engine must be set first\"\n        return self.moriio_engine.create_session(\n            local_memory_metadata, remote_memory_metadata\n        )\n\n    def read_remote_data(\n        self, transfer_size_byte, local_offset=0, remote_offset=0, session=None\n    ):\n        assert self.local_memory_registered, \"You have not register local memory data!\"\n        assert self.moriio_engine is not None, \"MoRIIO engine must be set first\"\n        transfer_status = session.batch_read(","sourceCodeStart":586,"sourceCodeEnd":622,"githubUrl":"https://github.com/vllm-project/vllm/blob/c794754062d49a8fdb63ab3c5215b488b865030c/vllm/distributed/kv_transfer/kv_connector/v1/moriio/moriio_engine.py#L586-L622","documentation":"Error \"Failed to register local memory: {e}\" thrown in vllm-project/vllm.","triggerScenarios":"Raised at vllm/distributed/kv_transfer/kv_connector/v1/moriio/moriio_engine.py:604 when validation fails: Failed to register local memory. Typically triggered by an incompatible or incomplete vLLM configuration, an unsupported platform/backend combination, or a runtime resource/dependency that is missing.","commonSituations":"Commonly encountered at vllm/distributed/kv_transfer/kv_connector/v1/moriio/moriio_engine.py:604 during vLLM startup/config validation or runtime setup when: (1) conflicting CLI flags or config fields are combined, (2) the current platform (CUDA/ROCm/CPU/XPU) or installed optional packages do not support the requested feature, or (3) a required value is absent or out of range. Resolve by correcting the configuration as described in the message, or by selecting a supported alternative.","solutions":["Check the wrapped error for why local memory registration failed (permissions, RDMA configuration, or invalid buffer)."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c794754062d49a8fdb63ab3c5215b488b865030c","analyzedAt":"2026-08-14T21:17:39.825Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}