From d088e57d85561cef2f3e454ddb6820e636a060a1 Mon Sep 17 00:00:00 2001 From: madelinemurray Date: Thu, 30 Nov 2023 12:48:17 +1000 Subject: [PATCH 1/3] Adding more info around static nodes Signed-off-by: madelinemurray --- docs/public-networks/how-to/connect/static-nodes.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/public-networks/how-to/connect/static-nodes.md b/docs/public-networks/how-to/connect/static-nodes.md index aa0eb09641f..0754a9581eb 100644 --- a/docs/public-networks/how-to/connect/static-nodes.md +++ b/docs/public-networks/how-to/connect/static-nodes.md @@ -11,11 +11,15 @@ tags: Static nodes are a configured set of trusted nodes. Static nodes are exempt from [maximum peer](manage-peers.md#limit-peers) and [remote connection](manage-peers.md#limit-remote-connections) limits. -Besu attempts to maintain connections with static nodes by periodically initiating a connection to any unconnected static node. +Besu periodically initiates a connection to any unconnected static node. To mitigate low peer count issues in small networks, we recommend using static nodes, or static nodes and bootnodes. :::tip -Bootnodes and static nodes are parallel methods for finding peers. Depending on your use case, you can use only bootnodes, only static nodes, or both bootnodes and static nodes. For example, you run multiple nodes on Mainnet (discovery using bootnodes), but want to ensure your nodes are always connected (using static nodes). +Bootnodes and static nodes are both methods for finding peers. Depending on your use case, you can use only bootnodes, only static nodes, or both bootnodes and static nodes. + +For example: +* You run multiple nodes on Mainnet, using bootnodes for discovery, but want to ensure your nodes are always connected, use static nodes. +* You run a small network and want the nodes to reconnect if disconnected, use static nodes. To find peers, configure one or more [bootnodes](../../../private-networks/how-to/configure/bootnodes.md). To configure a specific set of peer connections, use static nodes. From c9f86a4099172126ec13d9b44fa2de60c3be3a7e Mon Sep 17 00:00:00 2001 From: Alexandra Tran Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Thu, 30 Nov 2023 12:34:12 -0800 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Sally MacFarlane Signed-off-by: Alexandra Tran Carrillo <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/how-to/connect/static-nodes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/public-networks/how-to/connect/static-nodes.md b/docs/public-networks/how-to/connect/static-nodes.md index 0754a9581eb..bead46c96c0 100644 --- a/docs/public-networks/how-to/connect/static-nodes.md +++ b/docs/public-networks/how-to/connect/static-nodes.md @@ -18,8 +18,8 @@ Besu periodically initiates a connection to any unconnected static node. To miti Bootnodes and static nodes are both methods for finding peers. Depending on your use case, you can use only bootnodes, only static nodes, or both bootnodes and static nodes. For example: -* You run multiple nodes on Mainnet, using bootnodes for discovery, but want to ensure your nodes are always connected, use static nodes. -* You run a small network and want the nodes to reconnect if disconnected, use static nodes. +* You run multiple nodes on Mainnet, using bootnodes for discovery, but want to ensure your nodes are always connected to each other, use static nodes. +* You run a small network and want your nodes to reconnect if disconnected, use static nodes. To find peers, configure one or more [bootnodes](../../../private-networks/how-to/configure/bootnodes.md). To configure a specific set of peer connections, use static nodes. From 6d2247dfadb23dc39f201c1227a076b56c70c3f6 Mon Sep 17 00:00:00 2001 From: Alexandra Tran Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Thu, 30 Nov 2023 12:43:39 -0800 Subject: [PATCH 3/3] Update docs/public-networks/how-to/connect/static-nodes.md Signed-off-by: Alexandra Tran Carrillo <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/how-to/connect/static-nodes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/public-networks/how-to/connect/static-nodes.md b/docs/public-networks/how-to/connect/static-nodes.md index bead46c96c0..0c131a7f2f4 100644 --- a/docs/public-networks/how-to/connect/static-nodes.md +++ b/docs/public-networks/how-to/connect/static-nodes.md @@ -18,8 +18,8 @@ Besu periodically initiates a connection to any unconnected static node. To miti Bootnodes and static nodes are both methods for finding peers. Depending on your use case, you can use only bootnodes, only static nodes, or both bootnodes and static nodes. For example: -* You run multiple nodes on Mainnet, using bootnodes for discovery, but want to ensure your nodes are always connected to each other, use static nodes. -* You run a small network and want your nodes to reconnect if disconnected, use static nodes. +* You run multiple nodes on Mainnet, using bootnodes for discovery, but want to ensure your nodes are always connected to each other, using static nodes. +* You run a small network and want your nodes to reconnect if disconnected, using static nodes. To find peers, configure one or more [bootnodes](../../../private-networks/how-to/configure/bootnodes.md). To configure a specific set of peer connections, use static nodes.