[geode] branch develop updated: GEODE-9479: Document receivers & regions start order (#6902)

[al...@apache.org]

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

albertobr 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 cf33465  GEODE-9479: Document receivers & regions start order (#6902)
cf33465 is described below

commit cf33465495f65fb0ee47b8a32457078554b27cc5
Author: Alberto Bustamante Reyes <al...@est.tech>
AuthorDate: Tue Sep 28 10:19:12 2021 +0200

    GEODE-9479: Document receivers & regions start order (#6902)
---
 .../tools_modules/gfsh/command-pages/create.html.md.erb      | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/geode-docs/tools_modules/gfsh/command-pages/create.html.md.erb b/geode-docs/tools_modules/gfsh/command-pages/create.html.md.erb
index 825ecbd..cf76675 100644
--- a/geode-docs/tools_modules/gfsh/command-pages/create.html.md.erb
+++ b/geode-docs/tools_modules/gfsh/command-pages/create.html.md.erb
@@ -57,6 +57,17 @@ Create async-event-queues, disk-stores, gateway receivers, gateway senders, inde
 
     Create a region with given path and configuration.
 
+
+**Note:** The order in which components are created matters. For example, the recommendation for WAN setup is:
+
+- Create/start WAN senders first
+- Create Regions
+- Create/start WAN receivers last
+
+This assures that when WAN receivers are started, their associated regions are in place. Otherwise,
+the `create region` command may fail if events are received before the region exists.
+For more on this topic, see [Configuring a Multi-site (WAN) System](../../../topologies_and_comm/multi_site_configuration/setting_up_a_multisite_system.html).
+
 ## <a id="topic_ryz_pb1_dk" class="no-quick-link"></a>create async-event-queue
 
 Creates an asynchronous event queue for batching events before they are delivered by a gateway sender.
@@ -368,7 +379,6 @@ unless the `--groups` or `--members` option is specified.
 If the gateway receiver creation succeeds on at least one member,
 this `gfsh` command exits with an exit code indicating success.
 
-
 Outputs a tabular format status of each member's gateway receiver,
 independent of the success or failure of the creation.