{"record":{"id":"540b6c32d1361c26","repo":"sgl-project/sglang","slug":"the-installed-mooncake-version-does-not-support-te-540b6c","errorCode":null,"errorMessage":"The installed Mooncake version does not support tenant_id in MooncakeDistributedStore.setup(). Please upgrade Mooncake to use non-default Mooncake tenants with SGLang.","messagePattern":"The installed Mooncake version does not support tenant_id in MooncakeDistributedStore\\.setup\\(\\)\\. Please upgrade Mooncake to use non-default Mooncake tenants with SGLang\\.","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py","lineNumber":533,"sourceCode":"                            client_hostname,\n                            self.config.metadata_server,\n                            per_rank_global_segment_size,\n                            DEFAULT_LOCAL_BUFFER_SIZE,  # Zero copy interface does not need local buffer\n                            self.config.protocol,\n                            device_name,\n                            self.config.master_server_address,\n                            transfer_engine,\n                            **setup_kwargs,\n                        )\n                        break\n                    except TypeError as e:\n                        unsupported_kwargs = [\n                            key for key in list(setup_kwargs) if key in str(e)\n                        ]\n                        if not unsupported_kwargs:\n                            raise\n                        if \"tenant_id\" in unsupported_kwargs:\n                            raise RuntimeError(\n                                \"The installed Mooncake version does not support \"\n                                \"tenant_id in MooncakeDistributedStore.setup(). \"\n                                \"Please upgrade Mooncake to use non-default \"\n                                \"Mooncake tenants with SGLang.\"\n                            ) from e\n                        logger.warning(\n                            \"The installed Mooncake version does not support the \"\n                            f\"{', '.join(unsupported_kwargs)} parameter(s) in setup(). \"\n                            f\"Retrying without {', '.join(unsupported_kwargs)}. \"\n                            \"Please upgrade Mooncake to enable SSD offload support.\"\n                        )\n                        for key in unsupported_kwargs:\n                            setup_kwargs.pop(key, None)\n            if ret_code:\n                raise RuntimeError(\n                    f\"Failed to setup Mooncake store, error code: {ret_code}\"\n                )\n            logger.info(\"Mooncake store setup successfully.\")","sourceCodeStart":515,"sourceCodeEnd":551,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py#L515-L551","documentation":"MooncakeDistributedStore.setup() raised TypeError naming tenant_id: the installed Mooncake's setup() signature does not accept tenant_id, and a non-default tenant was requested. SGLang computes unsupported_kwargs from the TypeError message and raises this dedicated upgrade error.","triggerScenarios":"MooncakeStore __init__ with tenant_id != default while installed mooncakestore predates tenant support.","commonSituations":"Setting MOONCAKE_TENANT_ID / tenant_id in config with an old mooncake wheel; mixed-version cluster where one node has old mooncake.","solutions":["pip install mooncake-transfer-engine --upgrade on all nodes","Or unset tenant_id to use the default tenant"],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":"import inspect\nfrom mooncake.store import MooncakeDistributedStore\nok = 'tenant_id' in inspect.signature(MooncakeDistributedStore.setup).parameters\nif tenant_id not in (None, 'default') and not ok:\n    tenant_id = 'default'  # or abort and ask for upgrade","typeGuard":"def mooncake_supports_tenant() -> bool:\n    import inspect\n    from mooncake.store import MooncakeDistributedStore\n    return 'tenant_id' in inspect.signature(MooncakeDistributedStore.setup).parameters","tryCatchPattern":"try:\n    ms = MooncakeStore(...)\nexcept RuntimeError as e:\n    if 'tenant_id' in str(e):\n        kwargs['tenant_id'] = 'default'\n        ms = MooncakeStore(...)\n    else:\n        raise","preventionTips":["Feature-detect setup() kwargs at startup","Standardize mooncake version across the cluster"],"tags":["mooncake","version-mismatch","tenant","dependency"],"backgroundTag":"library-version-mismatch","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}