- "You cannot call `weave rmpeer` on more than one host" - yes you can, but you must not call it on more than one host *for the same peer* - `weave forget` has nothing to do with this - "results in duplicate IPs" - no, it causes duplicate address range assignments - "the address is reassigned" - it's the address *range* that is reassigned - "claim" is a new and confusing term -> drop - "address space" -> "address range" (that's what it's called elsewhere)
62 lines
2.6 KiB
Markdown
62 lines
2.6 KiB
Markdown
---
|
|
title: Starting, Stopping and Removing Peers
|
|
menu_order: 40
|
|
search_type: Documentation
|
|
---
|
|
|
|
|
|
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](/site/tasks/ipam/ipam.md), 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`.
|
|
|
|
### <a name="caution-rmpeer"></a>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**
|
|
|
|
* [Address Allocation with IP Address Management (IPAM)](/site/tasks/ipam/ipam.md)
|
|
* [Automatic Allocation Across Multiple Subnets](/site/tasks/ipam/allocation-multi-ipam.md)
|
|
* [Isolating Applications on a Weave Network](/site/tasks/manage/application-isolation.md)
|