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.