[GH-ISSUE #229] mooncake_master: command not found #97

Closed
opened 2026-10-29 21:09:16 +00:00 by bsakaguchi · 7 comments
Owner

Originally created by @cyber-pioneer on GitHub (Apr 11, 2025).
Original GitHub issue: https://github.com/kvcache-ai/Mooncake/issues/229

I follow this doc to install mooncake-transfer-engine.https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/vllm-integration-v1.md
successfully install, but fail to use mooncake_master.

export VERSION=0.3.0b1
pip install mooncake-transfer-engine==0.3.0b1
pip list|grep mooncake
# mooncake-transfer-engine          0.3.0b1
mooncake_master
# bash: mooncake_master: command not found

Originally created by @cyber-pioneer on GitHub (Apr 11, 2025). Original GitHub issue: https://github.com/kvcache-ai/Mooncake/issues/229 I follow this doc to install mooncake-transfer-engine.https://github.com/kvcache-ai/Mooncake/blob/main/doc/en/vllm-integration-v1.md successfully install, but fail to use mooncake_master. ``` export VERSION=0.3.0b1 pip install mooncake-transfer-engine==0.3.0b1 pip list|grep mooncake # mooncake-transfer-engine 0.3.0b1 mooncake_master # bash: mooncake_master: command not found ```
bsakaguchi 2026-10-29 21:09:16 +00:00
Author
Owner

@ShangmingCai commented on GitHub (Apr 11, 2025):

Can you try again? We have released a new 0.3.0b3 package.

<!-- gh-comment-id:2796597590 --> @ShangmingCai commented on GitHub (Apr 11, 2025): Can you try again? We have released a new 0.3.0b3 package.
Author
Owner

@cyber-pioneer commented on GitHub (Apr 14, 2025):

Can you try again? We have released a new 0.3.0b3 package.

Thanks for your response. 0.3.0b3 is ok.
There is still minor path problem. Solved by adding path manually:

(inference) root@test:/mine# mooncake_master --version
/root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake/mooncake_master: error while loading shared libraries: libetcd_wrapper.so: cannot open shared object file: No such file or directory

(inference) root@test:/mine# find /root/miniconda3/envs/inference/ -name "libetcd_wrapper.so"
/root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake/libetcd_wrapper.so

(inference) root@test:/mine# export LD_LIBRARY_PATH=/root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake:$LD_LIBRARY_PATH
(inference) root@test:/mine# mooncake_master --version
mooncake_master
<!-- gh-comment-id:2800366875 --> @cyber-pioneer commented on GitHub (Apr 14, 2025): > Can you try again? We have released a new 0.3.0b3 package. Thanks for your response. 0.3.0b3 is ok. There is still minor path problem. Solved by adding path manually: ```shell (inference) root@test:/mine# mooncake_master --version /root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake/mooncake_master: error while loading shared libraries: libetcd_wrapper.so: cannot open shared object file: No such file or directory (inference) root@test:/mine# find /root/miniconda3/envs/inference/ -name "libetcd_wrapper.so" /root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake/libetcd_wrapper.so (inference) root@test:/mine# export LD_LIBRARY_PATH=/root/miniconda3/envs/inference/lib/python3.12/site-packages/mooncake:$LD_LIBRARY_PATH (inference) root@test:/mine# mooncake_master --version mooncake_master ```
Author
Owner

@ShangmingCai commented on GitHub (Apr 14, 2025):

@xiaguan I think this could be caused by the conda env lib not in the LD_LIBRARY_PATH , correct?

<!-- gh-comment-id:2800396279 --> @ShangmingCai commented on GitHub (Apr 14, 2025): @xiaguan I think this could be caused by the conda env lib not in the `LD_LIBRARY_PATH `, correct?
Author
Owner

@xiaguan commented on GitHub (Apr 14, 2025):

Could you share your installation method so I can try to reproduce the issue?
auditwheel has already adjusted the relevant dynamic library search paths for us; it seems this issue shouldn't be occurring.

<!-- gh-comment-id:2800423891 --> @xiaguan commented on GitHub (Apr 14, 2025): Could you share your installation method so I can try to reproduce the issue? `auditwheel` has already adjusted the relevant dynamic library search paths for us; it seems this issue shouldn't be occurring.
Author
Owner

@cyber-pioneer commented on GitHub (Apr 14, 2025):

Could you share your installation method so I can try to reproduce the issue? auditwheel has already adjusted the relevant dynamic library search paths for us; it seems this issue shouldn't be occurring.

export VERSION=0.3.0b3
pip install mooncake-transfer-engine==0.3.0b3
<!-- gh-comment-id:2800570861 --> @cyber-pioneer commented on GitHub (Apr 14, 2025): > Could you share your installation method so I can try to reproduce the issue? `auditwheel` has already adjusted the relevant dynamic library search paths for us; it seems this issue shouldn't be occurring. ``` export VERSION=0.3.0b3 pip install mooncake-transfer-engine==0.3.0b3 ```
Author
Owner

@github-actions[bot] commented on GitHub (Jul 18, 2026):

This issue has had no activity for 90 days and will be closed in 7 days if there is no further activity. Please comment or react if it should stay open.

<!-- gh-comment-id:5009821252 --> @github-actions[bot] commented on GitHub (Jul 18, 2026): This issue has had no activity for 90 days and will be closed in 7 days if there is no further activity. Please comment or react if it should stay open.
Author
Owner

@github-actions[bot] commented on GitHub (Jul 25, 2026):

Closing due to 3 months of inactivity. If this is still relevant, please comment and we can reopen.

<!-- gh-comment-id:5076842627 --> @github-actions[bot] commented on GitHub (Jul 25, 2026): Closing due to 3 months of inactivity. If this is still relevant, please comment and we can reopen.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kvcache-ai/Mooncake#97
No description provided.