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 <alberto.bustamante.re...@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.
