You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@geode.apache.org by kl...@apache.org on 2016/12/12 22:36:29 UTC
[26/46] geode git commit: GEODE-2125 Add doc note to not use kill cmd
on servers
GEODE-2125 Add doc note to not use kill cmd on servers
Project: http://git-wip-us.apache.org/repos/asf/geode/repo
Commit: http://git-wip-us.apache.org/repos/asf/geode/commit/d2141c43
Tree: http://git-wip-us.apache.org/repos/asf/geode/tree/d2141c43
Diff: http://git-wip-us.apache.org/repos/asf/geode/diff/d2141c43
Branch: refs/heads/feature/GEODE-1930
Commit: d2141c4356740544703b86e2961c295c378e8d7b
Parents: 6e50131
Author: Karen Miller <km...@pivotal.io>
Authored: Mon Nov 21 15:49:56 2016 -0800
Committer: Karen Miller <km...@pivotal.io>
Committed: Tue Nov 22 10:05:57 2016 -0800
----------------------------------------------------------------------
.../running/starting_up_shutting_down.html.md.erb | 11 +++++++++++
1 file changed, 11 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/geode/blob/d2141c43/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
----------------------------------------------------------------------
diff --git a/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb b/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
index 01b191d..86f6acb 100644
--- a/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
+++ b/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
@@ -127,6 +127,17 @@ Shut down the distributed system members according to the type of member. For ex
gfsh>stop locator --dir=<locator_working_dir>
```
+- Do not use the command line `kill -9` to shut down a server under
+ordinary circumstances.
+Especially on systems with a small number of members,
+using a `kill` instead of a `gfsh stop` can cause the partition detection
+mechanism to place the system in an end state that will wait forever to
+reconnect to the killed server,
+and there will be no way to restart that killed server.
+If a `kill` command appears the only way to rid the system of a server,
+then `kill` *all* the processes of the distributed system
+or use `kill -INT`, which will allow an orderly shutdown of the process.
+
## <a id="starting_up_shutting_down__section_7CF680CF8A924C57A7052AE2F975DA81" class="no-quick-link"></a>Option for System Member Shutdown Behavior
The `DISCONNECT_WAIT` command line argument sets the maximum time for each individual step in the shutdown process. If any step takes longer than the specified amount, it is forced to end. Each operation is given this grace period, so the total length of time the cache member takes to shut down depends on the number of operations and the `DISCONNECT_WAIT` setting. During the shutdown process, Geode produces messages such as: