flomesh-io / ztm

ZTM (Zero Trust Mesh) is privacy first, open source, decentralized network software, based on HTTP/2 tunnel. Boundless connectivity. Mesh the world!
Apache License 2.0
266 stars 21 forks source link

wiki guide bug: ZTMesh client: Only available for the MacBook architecture, not available for the x86 architecture. #5

Closed xiaods closed 1 month ago

xiaods commented 1 month ago
截屏2024-05-11 上午12 14 07
  1. The tutorial on the wiki cannot proceed as there is a lack of verification for some key steps, making it difficult to work out. It is suggested to optimize it into 2 nodes, with the server serving as an example, which can fully act as two roles, hub and megatron.
  2. the prepare section on wiki contains useless git clone step. suggest remove the useless info.
keveinliu commented 1 month ago

Thanks for your points!

  1. Since this wiki is about how to access your home nodes, so I run three nodes. We'll demonstrate its concept and network topology in README, to make it clear to users.
  2. Indeed we haven't prepare so well in v0.0.1. I'll update the wiki after v0.0.2 released, will be soon in two days.

Thank you very much! Cheers!

keveinliu commented 1 month ago

Update:

  1. Wiki has been updated. Also README in ztm repo has been updated.
  2. ZTMesh v0.0.2 has MacOS(arm64/x64) and Windows(x64). In next release, we'll provide more artifacts of Linux and mobile.
xiaods commented 1 month ago

Update:

  1. Wiki has been updated. Also README in ztm repo has been updated.
  2. ZTMesh v0.0.2 has MacOS(arm64/x64) and Windows(x64). In next release, we'll provide more artifacts of Linux and mobile.

I will double check later. thanks

xiaods commented 1 month ago

hi, came across another issue on client side and there is confuse for me.

Image_20240513222251

I am not sure wether i need do all cli step and graph ui step together? my environment is two server:

keveinliu commented 1 month ago

hi, came across another issue on client side and there is confuse for me.

Image_20240513222251

---> Seems pipy didn't start correctly, so you can't configure mesh.

I am not sure wether i need do all cli step and graph ui step together? my environment is two server:

---> In "Join the mesh" section of wiki, I provide two different examples by using cli and gui. Cli is for servers which don't have desktop, and gui is for desktop OS(like MacOS or Windows). In fact, you can run a ztm agent by cli or gui. It both works.

  • aws server, setting role is ztm hub and backend server.

-----> Run CA server, Hub, "Join the mesh by Cli". All steps in command line.

  • my local mac, as client server, don't know what step should be do step by step.

----> Both cli and gui work. I recommend GUI. And it's better to use GUI as mesh admin.

Hope I've answered your questions. Feel from to drop further questions here. Cheers!

xiaods commented 1 month ago

hi, came across another issue on client side and there is confuse for me. Image_20240513222251

---> Seems pipy didn't start correctly, so you can't configure mesh.

I am not sure wether i need do all cli step and graph ui step together? my environment is two server:

---> In "Join the mesh" section of wiki, I provide two different examples by using cli and gui. Cli is for servers which don't have desktop, and gui is for desktop OS(like MacOS or Windows). In fact, you can run a ztm agent by cli or gui. It both works.

  • aws server, setting role is ztm hub and backend server.

-----> Run CA server, Hub, "Join the mesh by Cli". All steps in command line.

  • my local mac, as client server, don't know what step should be do step by step.

----> Both cli and gui work. I recommend GUI. And it's better to use GUI as mesh admin.

Hope I've answered your questions. Feel from to drop further questions here. Cheers!

thanks, let me double check again

xiaods commented 1 month ago

@keveinliu I already double check my environment with ZTM and pipy.

截屏2024-05-14 下午9 58 15

because the pipy is not working on MacOS Intel version. the pipy link is come from here: pipy-ztm-v0.0.2-macos-x64.zip

the pipy issue also caused the ZTM graph app is not working on my environment. please double check. thanks a lot.

xiaods commented 1 month ago

After repeatedly reading the tutorial, I believe that there are many redundant steps in the current tutorial. Some steps do not clearly state the commands, which leads to the need for alignment of content and causes confusion for novice users. I think that the scenario plan should be one-click through to the end, without interrupting novice users. A tutorial that allows users to follow step by step and achieve success is what is needed. The current tutorial cannot achieve this. Based on the current situation, I suggest that you revise it using large model services such as ChatGPT. There are also many English descriptions that are not clear to understand. Please use ChatGPT4o to help you correct them. It will only take a few seconds. Thank you.

xiaods commented 1 month ago

Image_20240515103225 I am also confuse why came across this issue. please help me

xiaods commented 1 month ago

another case: in windows 10 env:

  1. download graph app: ZTMesh_v0.0.2_win_x64.msi and install.
  2. follow wiki guide: https://github.com/flomesh-io/ztm/wiki/HOWTO:-How-to-access-my-home-Linux-from-office-macOS-by-ztm%3F#with-graphical-ui , the start button is not working for me.

Image_20240515104120

xiaods commented 1 month ago

with my dig info. it works like a charm.

Conclusion: ztm need pipy engine. so through the wiki guide, only the below cmd is valid:

$ arch=`uname -m`
$ wget https://pipy-oss-1255617643.cos-website.ap-beijing.myqcloud.com/repo/pipy/${arch}/binary/pipy-1.1.0-33-generic_linux-${arch}.tar.gz
$ tar xvf pipy-1.1.0-33-generic_linux-${arch}.tar.gz && sudo cp -f usr/local/bin/pipy /usr/local/bin && rm -fr usr

and the ztm project's release page attach all invalid packag. https://github.com/flomesh-io/ztm/releases/tag/v0.0.2 i have also check the status:

  1. pipy-ztm-v0.0.2-macos-x64.zip is not working
  2. pipy-ztm-v0.0.2-ubuntu-x64.gz is not working
  3. pipy-ztm-v0.0.2-windows.zip is not working
  4. ZTMesh_v0.0.2_macos_x64.dmg is not working
  5. ZTMesh_v0.0.2_win_x64.msi is not working

I finally succeeded by browsing the design principles of ZTM on the wiki and using the ZTM source code repository to make the call.

Image_20240515105952

xiaods commented 1 month ago

/close by resolved.