Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Misunderstading instructions #16

Closed
bmullan opened this issue Jan 9, 2020 · 4 comments
Closed

Misunderstading instructions #16

bmullan opened this issue Jan 9, 2020 · 4 comments
Labels
documentation Documentation is unclear good first issue Good for newcomers question Further information is requested

Comments

@bmullan
Copy link

bmullan commented Jan 9, 2020

The README says:

  1. On the first node:

# ./wesher

Running the command above on a terminal will currently output a generated cluster key as follows:

new cluster key generated: XXXXX

Note: the created key will only be shown if running on a terminal, to avoid keys leaking via logs.

3. Lastly, on any further node:

# wesher --cluster-key XXXXX --join x.x.x.x

Where XXXXX is the base64 encoded 256 bit key printed by the step above, and x.x.x.x is the hostname or IP of any of the nodes already joined to the mesh cluster.

I have wireguard installed on all 3 nodes.

  • wget installed wesher
  • chmod a+x ./wesher
  • sudo ./wesher
  • saved key

But Step #3 above stumps me... If I just generated the "cluster-key" how can the next step say:

# wesher --cluster-key XXXXX --join x.x.x.x

Where XXXXX is the base64 encoded 256 bit key printed by the step above, and x.x.x.x is the hostname or IP of any of the nodes already joined to the mesh cluster.

How do you get a first node into the cluster? so additional nodes can be added like that?

Is step #2 supposed to to that? When I run:

# ./wesher

I get the...

new cluster key generated: XXXXX

but the command never completes or goes back to a prompt?

@costela costela added question Further information is requested documentation Documentation is unclear good first issue Good for newcomers labels Jan 9, 2020
@costela
Copy link
Owner

costela commented Jan 9, 2020

the command never completes or goes back to a prompt?

yes, because wesher is a daemon and currently doesn't have any separate CLI tool. When you start it, you effectively just started your cluster with a single node (the current one).

The quick start is just supposed to show how wesher generally works. A "proper" installation probably also entails integrating it with whatever distribution you are using by, e.g., using the provided systemd integration.

@bmullan
Copy link
Author

bmullan commented Jan 10, 2020

@costela
thanks.. that "the provided systemd integration" I hadn't looked at yet because I was just testing

However, as I said in my 1st post.. when I execute:

# ./wesher

Running the command above on a terminal will currently output a generated cluster key as follows:

new cluster key generated: XXXXX

On my machine(s) I get the new cluster key generated as above but it never comes back to the Terminal prompt. Cursor just keeps blinking after XXXXX

@costela costela modified the milestone: v0.3.0 Jan 10, 2020
@costela
Copy link
Owner

costela commented Jan 10, 2020

Yes, and as I said: wesher is a daemon. It's meant to run indefinitely. Compare it with, for instance, openvpn: if you start in on the console, it runs for as long as the VPN connection is up, and if you kill it the connection breaks. Under realistic usage, it's meant to be started/managed by a different process, like your desktop session manager or systemd.

@bmullan bmullan closed this as completed Jan 10, 2020
@bmullan
Copy link
Author

bmullan commented Jan 10, 2020 via email

costela added a commit that referenced this issue Jan 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Documentation is unclear good first issue Good for newcomers question Further information is requested
Projects
None yet
Development

No branches or pull requests

2 participants