[geode] branch develop updated: GEODE-7993: Document startup behavior of GW senders (#4965)

[km...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

kmiller pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/geode.git


The following commit(s) were added to refs/heads/develop by this push:
     new 88b3603  GEODE-7993: Document startup behavior of GW senders (#4965)
88b3603 is described below

commit 88b3603babfb884e3dc7e3198f79cbbda720a822
Author: Karen Miller <ka...@users.noreply.github.com>
AuthorDate: Wed Apr 15 16:47:04 2020 -0700

    GEODE-7993: Document startup behavior of GW senders (#4965)
---
 .../topology_concepts/multisite_overview.html.md.erb      | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/geode-docs/topologies_and_comm/topology_concepts/multisite_overview.html.md.erb b/geode-docs/topologies_and_comm/topology_concepts/multisite_overview.html.md.erb
index 661c424..ccf3750 100644
--- a/geode-docs/topologies_and_comm/topology_concepts/multisite_overview.html.md.erb
+++ b/geode-docs/topologies_and_comm/topology_concepts/multisite_overview.html.md.erb
@@ -81,6 +81,21 @@ By default gateway sender queues use 5 threads to dispatch queued events. With a
 
 See [Configuring Multi-Site (WAN) Event Queues](../../developing/events/configure_multisite_event_messaging.html#configure_multisite_event_messaging).
 
+## <a id="GW_sender_connect" class="no-quick-link"></a>Timing of Connections
+
+When a gateway sender is created, it tries once to connect to
+the gateway receiver.
+If the gateway sender cannot connect,
+the gateway sender does not retry until there is a batch of events to be sent.
+At that time, the gateway sender tries again to connect to the gateway receiver.
+
+During a normal initial startup,
+one cluster site will start before the other cluster site.
+The cluster site that starts first will not be connected
+to the remote cluster site,
+even after that other cluster site starts.
+Only when data is to be sent will the connection be made.
+
 ## <a id="topic_9AA37B43642D4DE19072CA3367C849BA__section_70A4D850A5404429AD5CB483D2053F1A" class="no-quick-link"></a>High Availability for Gateway Senders
 
 When a serial gateway sender configuration is deployed to multiple Geode members, only one "primary" sender is active at a given time. All other serial gateway sender instances are inactive "secondaries" that are available as backups if the primary sender shuts down. Geode designates the first gateway sender to start up as the primary sender, and all other senders become secondaries. As gateway senders start and shut down, Geode ensures that the oldest running gateway sender operates as  [...]