You may wish to weave stop and re-launch to change some config or to upgrade to a new version. Provided that the underlying protocol hasn’t changed, Weave Net picks up where it left off and learns from peers in the network which address ranges it was previously using.

If, however, you run weave reset this removes the peer from the network so if Weave Net is run again on that node it will start from scratch.

For failed peers, the weave rmpeer command can be invoked to permanently remove the ranges allocated to said peers. This allows other peers to allocate IPs in the ranges previously owned by the removed peers, and as such should be used with extreme caution: if the removed peers had transferred some range of IP addresses to other peers but this is not known to the whole network, or if some of them later rejoin the Weave network, the same IP address may be allocated twice.

Assume you had started the three peers in the overview example, and then host3 caught fire, you can go to one of the other hosts and run:

host1$ weave rmpeer host3
524288 IPs taken over from host3

Weave Net takes all the IP address ranges owned by host3 and transfers them to be owned by host1. The name “host3” is resolved via the ‘nickname’ feature of Weave Net, which defaults to the local host name. Alternatively, you can supply a peer name as shown in weave status.

Caution

Do not invoke weave rmpeer for the same peer on more than one host.

The removed peer’s address range cannot be left dangling and is therefore reassigned to the peer on which weave rmpeer was run. Consequently, if you run weave rmpeer for the same peer on more than one host, the removed peer’s address range will be owned by multiple peers.

Once the peers detect this inconsistency, they log the error and drop the connection that supplied the inconsistent data. The rest of the peers will carry on with their view of the world, but the network will not function correctly. Depending on the timing of the rmpeer and the communication between peers, several peer cliques may form - groups of peers that are talking to each other, but repeatedly drop attempted connections with peers in other cliques.

See Also