geode-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kmil...@apache.org
Subject incubator-geode git commit: GEODE-2125 Add doc note to not use kill cmd on servers
Date Tue, 22 Nov 2016 18:07:35 GMT
Repository: incubator-geode
Updated Branches:
  refs/heads/develop 6e5013102 -> d2141c435


GEODE-2125 Add doc note to not use kill cmd on servers


Project: http://git-wip-us.apache.org/repos/asf/incubator-geode/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-geode/commit/d2141c43
Tree: http://git-wip-us.apache.org/repos/asf/incubator-geode/tree/d2141c43
Diff: http://git-wip-us.apache.org/repos/asf/incubator-geode/diff/d2141c43

Branch: refs/heads/develop
Commit: d2141c4356740544703b86e2961c295c378e8d7b
Parents: 6e50131
Author: Karen Miller <kmiller@pivotal.io>
Authored: Mon Nov 21 15:49:56 2016 -0800
Committer: Karen Miller <kmiller@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/incubator-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:


Mime
View raw message