{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker.github.io/pulls/comments/89495489","pull_request_review_id":10040411,"id":89495489,"diff_hunk":"@@ -231,29 +247,47 @@ you demote or remove a manager\n ## Recover from disaster\n \n Swarm is resilient to failures and the swarm can recover from any number\n-of temporary node failures (machine reboots or crash with restart).\n+of temporary node failures (machine reboots or crash with restart) or other\n+transient errors. However, a swarm cannot automatically recover if it loses a\n+quorum.\n \n-In a swarm of `N` managers, there must be a quorum of manager nodes greater than\n-50% of the total number of managers (or `(N/2)+1`) in order for the swarm to\n-process requests and remain available. This means the swarm can tolerate up to\n-`(N-1)/2` permanent failures beyond which requests involving swarm management\n-cannot be processed. These types of failures include data corruption or hardware\n-failures.\n+In a swarm of `N` managers, a quorum (a majority) of manager nodes must always\n+be available. For example, in a swarm with 5 managers, a minimum of 3 must be\n+operational and in communication with each other. In other words, the swarm can\n+tolerate up to `(N-1)/2` permanent failures beyond which requests involving\n+swarm management cannot be processed. These types of failures include data\n+corruption or hardware failures.\n+\n+### Recovering from losing the quorum\n+\n+If you lose the quorum of managers, you cannot administer the swarm. If you have\n+lost the quorum and you attempt to perform any management operation on the swarm,\n+an error occurs:","path":"engine/swarm/admin_guide.md","position":77,"original_position":77,"commit_id":"a162a1d0eac40e069cd1a311daca35c638086e0d","original_commit_id":"a162a1d0eac40e069cd1a311daca35c638086e0d","user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"body":"@stevvooe you think we should repeat that tasks remain to run (https://github.com/docker/docker.github.io/pull/297/files#r88358814)? Train of thought; If the lost quorum is temporary, but all tasks are still running, there may not be a direct need to try to recover.","created_at":"2016-11-24T13:15:10Z","updated_at":"2016-11-24T13:15:10Z","html_url":"https://github.com/docker/docker.github.io/pull/297#discussion_r89495489","pull_request_url":"https://api.github.com/repos/docker/docker.github.io/pulls/297","_links":{"self":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/comments/89495489"},"html":{"href":"https://github.com/docker/docker.github.io/pull/297#discussion_r89495489"},"pull_request":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/297"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker.github.io/pulls/297","id":90297036,"html_url":"https://github.com/docker/docker.github.io/pull/297","diff_url":"https://github.com/docker/docker.github.io/pull/297.diff","patch_url":"https://github.com/docker/docker.github.io/pull/297.patch","issue_url":"https://api.github.com/repos/docker/docker.github.io/issues/297","number":297,"state":"open","locked":false,"title":"Add to swarm admin docs","user":{"login":"mstanleyjones","id":7674613,"avatar_url":"https://avatars.githubusercontent.com/u/7674613?v=3","gravatar_id":"","url":"https://api.github.com/users/mstanleyjones","html_url":"https://github.com/mstanleyjones","followers_url":"https://api.github.com/users/mstanleyjones/followers","following_url":"https://api.github.com/users/mstanleyjones/following{/other_user}","gists_url":"https://api.github.com/users/mstanleyjones/gists{/gist_id}","starred_url":"https://api.github.com/users/mstanleyjones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mstanleyjones/subscriptions","organizations_url":"https://api.github.com/users/mstanleyjones/orgs","repos_url":"https://api.github.com/users/mstanleyjones/repos","events_url":"https://api.github.com/users/mstanleyjones/events{/privacy}","received_events_url":"https://api.github.com/users/mstanleyjones/received_events","type":"User","site_admin":false},"body":"### Describe the proposed changes\n- Add details about maintaining quorum\n- Add details about pending tasks\n### Project version\n\nn/a\n### Related issue\n\nn/a\n### Related issue or PR in another project\n\nhttps://github.com/docker/docker/issues/25069#issuecomment-255218986\nhttps://github.com/docker/docker/issues/26017#issuecomment-246405418\n### Please take a look\n\n@stevvooe @aaronlehmann \n\n<!-- To improve this template, edit .github/PULL_REQUEST_TEMPLATE.md. -->\n\nSigned-off-by: Misty Stanley-Jones misty@docker.com\n","created_at":"2016-10-20T23:03:33Z","updated_at":"2016-11-24T13:15:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b39e6d7d7c1b1a4798633c5c2e6ecd488dd8bf43","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker.github.io/pulls/297/commits","review_comments_url":"https://api.github.com/repos/docker/docker.github.io/pulls/297/comments","review_comment_url":"https://api.github.com/repos/docker/docker.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker.github.io/issues/297/comments","statuses_url":"https://api.github.com/repos/docker/docker.github.io/statuses/a162a1d0eac40e069cd1a311daca35c638086e0d","head":{"label":"mstanleyjones:swarm_service_create_no_suitable_node","ref":"swarm_service_create_no_suitable_node","sha":"a162a1d0eac40e069cd1a311daca35c638086e0d","user":{"login":"mstanleyjones","id":7674613,"avatar_url":"https://avatars.githubusercontent.com/u/7674613?v=3","gravatar_id":"","url":"https://api.github.com/users/mstanleyjones","html_url":"https://github.com/mstanleyjones","followers_url":"https://api.github.com/users/mstanleyjones/followers","following_url":"https://api.github.com/users/mstanleyjones/following{/other_user}","gists_url":"https://api.github.com/users/mstanleyjones/gists{/gist_id}","starred_url":"https://api.github.com/users/mstanleyjones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mstanleyjones/subscriptions","organizations_url":"https://api.github.com/users/mstanleyjones/orgs","repos_url":"https://api.github.com/users/mstanleyjones/repos","events_url":"https://api.github.com/users/mstanleyjones/events{/privacy}","received_events_url":"https://api.github.com/users/mstanleyjones/received_events","type":"User","site_admin":false},"repo":{"id":69602763,"name":"docker.github.io","full_name":"mstanleyjones/docker.github.io","owner":{"login":"mstanleyjones","id":7674613,"avatar_url":"https://avatars.githubusercontent.com/u/7674613?v=3","gravatar_id":"","url":"https://api.github.com/users/mstanleyjones","html_url":"https://github.com/mstanleyjones","followers_url":"https://api.github.com/users/mstanleyjones/followers","following_url":"https://api.github.com/users/mstanleyjones/following{/other_user}","gists_url":"https://api.github.com/users/mstanleyjones/gists{/gist_id}","starred_url":"https://api.github.com/users/mstanleyjones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mstanleyjones/subscriptions","organizations_url":"https://api.github.com/users/mstanleyjones/orgs","repos_url":"https://api.github.com/users/mstanleyjones/repos","events_url":"https://api.github.com/users/mstanleyjones/events{/privacy}","received_events_url":"https://api.github.com/users/mstanleyjones/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mstanleyjones/docker.github.io","description":"Test repository for Jekyll-based, one-repo docs structure. NOT the source of truth for docs.","fork":true,"url":"https://api.github.com/repos/mstanleyjones/docker.github.io","forks_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/forks","keys_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/teams","hooks_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/hooks","issue_events_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/events","assignees_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/tags","blobs_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/languages","stargazers_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/stargazers","contributors_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/contributors","subscribers_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/subscribers","subscription_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/subscription","commits_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/merges","archive_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/downloads","issues_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/labels{/name}","releases_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/mstanleyjones/docker.github.io/deployments","created_at":"2016-09-29T19:54:49Z","updated_at":"2016-09-29T19:54:54Z","pushed_at":"2016-11-24T00:45:54Z","git_url":"git://github.com/mstanleyjones/docker.github.io.git","ssh_url":"git@github.com:mstanleyjones/docker.github.io.git","clone_url":"https://github.com/mstanleyjones/docker.github.io.git","svn_url":"https://github.com/mstanleyjones/docker.github.io","homepage":"https://docker.github.io","size":356985,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"e105f0714ad366fc2b6e8502a4263d074a8b1166","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":65772720,"name":"docker.github.io","full_name":"docker/docker.github.io","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/docker.github.io","description":"Source repo for Docker's Documentation","fork":false,"url":"https://api.github.com/repos/docker/docker.github.io","forks_url":"https://api.github.com/repos/docker/docker.github.io/forks","keys_url":"https://api.github.com/repos/docker/docker.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker.github.io/teams","hooks_url":"https://api.github.com/repos/docker/docker.github.io/hooks","issue_events_url":"https://api.github.com/repos/docker/docker.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker.github.io/events","assignees_url":"https://api.github.com/repos/docker/docker.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker.github.io/tags","blobs_url":"https://api.github.com/repos/docker/docker.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker.github.io/languages","stargazers_url":"https://api.github.com/repos/docker/docker.github.io/stargazers","contributors_url":"https://api.github.com/repos/docker/docker.github.io/contributors","subscribers_url":"https://api.github.com/repos/docker/docker.github.io/subscribers","subscription_url":"https://api.github.com/repos/docker/docker.github.io/subscription","commits_url":"https://api.github.com/repos/docker/docker.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/docker.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker.github.io/merges","archive_url":"https://api.github.com/repos/docker/docker.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker.github.io/downloads","issues_url":"https://api.github.com/repos/docker/docker.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker.github.io/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/docker/docker.github.io/deployments","created_at":"2016-08-15T23:50:51Z","updated_at":"2016-11-24T08:42:42Z","pushed_at":"2016-11-24T10:43:14Z","git_url":"git://github.com/docker/docker.github.io.git","ssh_url":"git@github.com:docker/docker.github.io.git","clone_url":"https://github.com/docker/docker.github.io.git","svn_url":"https://github.com/docker/docker.github.io","homepage":"https://docs.docker.com","size":357862,"stargazers_count":88,"watchers_count":88,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":332,"mirror_url":null,"open_issues_count":130,"forks":332,"open_issues":130,"watchers":88,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/297"},"html":{"href":"https://github.com/docker/docker.github.io/pull/297"},"issue":{"href":"https://api.github.com/repos/docker/docker.github.io/issues/297"},"comments":{"href":"https://api.github.com/repos/docker/docker.github.io/issues/297/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/297/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/297/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker.github.io/statuses/a162a1d0eac40e069cd1a311daca35c638086e0d"}}}}
{"actor":{"display_login":"thaJeztah"}}