{"action":"created","comment":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/86375431","pull_request_review_id":7037413,"id":86375431,"diff_hunk":"@@ -0,0 +1,61 @@\n+---\n+post_title: Upgrading\n+menu_order: 11\n+---\n+\n+## Summary\n+\n+This document provides instructions for upgrading a DC/OS cluster from version 1.7 to 1.8 using AWS cloudformation templates. It is recommended that you familiarize yourself with the [Advanced DC/OS Installation on AWS] before proceeding.\n+\n+**Important:**\n+\n+- The upgrade process described involves deleting all the instances, it will NOT save any persistent data. It is recommended creating a second cluster and migrate the services to save persistent data.\n+- The [VIP features](/docs/1.8/usage/service-discovery/load-balancing-vips/virtual-ip-addresses/), added in DC/OS 1.8, require that ports 32768 - 65535 are open between all agent and master nodes for both TCP and UDP.\n+- The DC/OS UI and APIs may be inconsistent or unavailable while masters are being upgraded. Avoid using them until all masters have been upgraded and have rejoined the cluster. You can monitor the health of a master during an upgrade by watching Exhibitor on port 8181.\n+- Task history in the Mesos UI will not persist through the upgrade.\n+\n+\n+## Instructions\n+\n+1. Login to the current leader master of the cluster.\n+   1. Using DC/OS CLI: \n+      ```\n+      $dcos node ssh --master-proxy --leader\n+      ```\n+   1. After you are logged in, run the following command. This command creates a new 1.8 directory (/var/lib/dcos/exhibitor/zookeeper) as a symlink to the old (/var/lib/zookeeper): \n+      ```\n+      $for node in $(dig +short master.mesos); do ssh -o StrictHostKeyChecking=no $node \"sudo mkdir -p /var/lib/dcos/exhibitor && sudo ln -s /var/lib/zookeeper /var/lib/dcos/exhibitor/zookeeper\"; done\n+      ```\n+\n+   1. Go to (http://master-node/exhibitor).\n+      * Go to config tab , it should have three fields which have (/var/lib/zookeeper). \n+        ![Exhibitor UI](../img/dcos-exhibitor-fields-before.png)\n+        ![Exhibitor UI](../img/dcos-exhibitor-fields-before-2.png)\n+      * Edit the config and change all three fields that contain (/var/lib/zookeeper/) to (/var/lib/dcos/exhibitor/zookeeper/).\n+        ![Exhibitor UI](../img/dcos-exhibitor-fields-after.png)\n+        ![Exhibitor UI](../img/dcos-exhibitor-fields-after-2.png)\n+      * Commit and perform a rolling restart.\n+      * This will take a couple of minutes and during that time the Exhibitor UI will flash, wait for the commit to be performed fully.\n+   1. Make sure the cluster is healthy at this point.\n+      * Verify you can access the dashboard.\n+      * Verify all components are healthy.\n+   \n+1. Update Cloudformation stacks.\n+   1. Generate the new templates following instructions at [Advanced DC/OS Installation Guide][advanced-aws-custom]. \n+   1. See the AWS documentation on updating CloudFormation stacks: [http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html). \n+   1. Updating the zen or infra stack will update the others automatically , if not start with masters then agents.\n+   \n+1. Deleting instances\n+   1. Deleting master nodes.\n+      * Start by deleting the non leading master. \n+      * Verify updated master nodes has joined and is healthy.\n+      * Once all non leading masters have been replaced, delete the leading master and verify its healthy.\n+    \n+   1. Deleting agent nodes.\n+      * Delete any agent node, order does not matter.","path":"1.8/administration/installing/cloud/aws/upgrading.md","position":55,"original_position":55,"commit_id":"ca7604f68ade706f3297e34977fa857596bde98b","original_commit_id":"ca7604f68ade706f3297e34977fa857596bde98b","user":{"login":"lingmann","id":33731,"avatar_url":"https://avatars.githubusercontent.com/u/33731?v=3","gravatar_id":"","url":"https://api.github.com/users/lingmann","html_url":"https://github.com/lingmann","followers_url":"https://api.github.com/users/lingmann/followers","following_url":"https://api.github.com/users/lingmann/following{/other_user}","gists_url":"https://api.github.com/users/lingmann/gists{/gist_id}","starred_url":"https://api.github.com/users/lingmann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lingmann/subscriptions","organizations_url":"https://api.github.com/users/lingmann/orgs","repos_url":"https://api.github.com/users/lingmann/repos","events_url":"https://api.github.com/users/lingmann/events{/privacy}","received_events_url":"https://api.github.com/users/lingmann/received_events","type":"User","site_admin":false},"body":"* s/Delete any agent node, order does not matter./Terminate the agent using AWS web UI or CLI tools./","created_at":"2016-11-03T15:49:21Z","updated_at":"2016-11-03T15:49:21Z","html_url":"https://github.com/dcos/dcos-docs/pull/702#discussion_r86375431","pull_request_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/702","_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments/86375431"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/702#discussion_r86375431"},"pull_request":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/702"}}},"pull_request":{"url":"https://api.github.com/repos/dcos/dcos-docs/pulls/702","id":90461969,"html_url":"https://github.com/dcos/dcos-docs/pull/702","diff_url":"https://github.com/dcos/dcos-docs/pull/702.diff","patch_url":"https://github.com/dcos/dcos-docs/pull/702.patch","issue_url":"https://api.github.com/repos/dcos/dcos-docs/issues/702","number":702,"state":"open","locked":false,"title":"WIP: Upgrade using cloudformation templates","user":{"login":"amitaekbote","id":4984257,"avatar_url":"https://avatars.githubusercontent.com/u/4984257?v=3","gravatar_id":"","url":"https://api.github.com/users/amitaekbote","html_url":"https://github.com/amitaekbote","followers_url":"https://api.github.com/users/amitaekbote/followers","following_url":"https://api.github.com/users/amitaekbote/following{/other_user}","gists_url":"https://api.github.com/users/amitaekbote/gists{/gist_id}","starred_url":"https://api.github.com/users/amitaekbote/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amitaekbote/subscriptions","organizations_url":"https://api.github.com/users/amitaekbote/orgs","repos_url":"https://api.github.com/users/amitaekbote/repos","events_url":"https://api.github.com/users/amitaekbote/events{/privacy}","received_events_url":"https://api.github.com/users/amitaekbote/received_events","type":"User","site_admin":false},"body":"## What are your changes?\r\nhttps://mesosphere.atlassian.net/browse/DCOS-9793\r\n\r\n## What type of changes does your doc introduce?\r\n- [ ] Bug fix\r\n- [X] New feature \r\n## What is the urgency level of this change?\r\n- [ ] Blocker\r\n- [x] High\r\n- [ ] Medium\r\n## I have completed these items:\r\n- [ ] I have tested all commands and code snippets.\r\n- [ ] I have built locally and tested for broken links and formatting.\r\n- [x] I have made this change for all affected versions (e.g. 1.7, 1.8, and 1.9).\r\n- [x] My doc follows the style guide: https://github.com/dcos/dcos-docs#contributing.\r\n\r\nPing @emanic @sascala @joel-hamill for reviewing pull request changes.\r\n## If you included a comment with your commit, it appears here:\r\n","created_at":"2016-10-22T00:09:27Z","updated_at":"2016-11-03T16:00:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"aab061288c806604578432004c434ad828d8c5a4","assignee":{"login":"amitaekbote","id":4984257,"avatar_url":"https://avatars.githubusercontent.com/u/4984257?v=3","gravatar_id":"","url":"https://api.github.com/users/amitaekbote","html_url":"https://github.com/amitaekbote","followers_url":"https://api.github.com/users/amitaekbote/followers","following_url":"https://api.github.com/users/amitaekbote/following{/other_user}","gists_url":"https://api.github.com/users/amitaekbote/gists{/gist_id}","starred_url":"https://api.github.com/users/amitaekbote/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amitaekbote/subscriptions","organizations_url":"https://api.github.com/users/amitaekbote/orgs","repos_url":"https://api.github.com/users/amitaekbote/repos","events_url":"https://api.github.com/users/amitaekbote/events{/privacy}","received_events_url":"https://api.github.com/users/amitaekbote/received_events","type":"User","site_admin":false},"assignees":[{"login":"amitaekbote","id":4984257,"avatar_url":"https://avatars.githubusercontent.com/u/4984257?v=3","gravatar_id":"","url":"https://api.github.com/users/amitaekbote","html_url":"https://github.com/amitaekbote","followers_url":"https://api.github.com/users/amitaekbote/followers","following_url":"https://api.github.com/users/amitaekbote/following{/other_user}","gists_url":"https://api.github.com/users/amitaekbote/gists{/gist_id}","starred_url":"https://api.github.com/users/amitaekbote/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amitaekbote/subscriptions","organizations_url":"https://api.github.com/users/amitaekbote/orgs","repos_url":"https://api.github.com/users/amitaekbote/repos","events_url":"https://api.github.com/users/amitaekbote/events{/privacy}","received_events_url":"https://api.github.com/users/amitaekbote/received_events","type":"User","site_admin":false}],"milestone":null,"commits_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/702/commits","review_comments_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/702/comments","review_comment_url":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/issues/702/comments","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/ca7604f68ade706f3297e34977fa857596bde98b","head":{"label":"amitaekbote:upgrade-aws-cloudformation","ref":"upgrade-aws-cloudformation","sha":"ca7604f68ade706f3297e34977fa857596bde98b","user":{"login":"amitaekbote","id":4984257,"avatar_url":"https://avatars.githubusercontent.com/u/4984257?v=3","gravatar_id":"","url":"https://api.github.com/users/amitaekbote","html_url":"https://github.com/amitaekbote","followers_url":"https://api.github.com/users/amitaekbote/followers","following_url":"https://api.github.com/users/amitaekbote/following{/other_user}","gists_url":"https://api.github.com/users/amitaekbote/gists{/gist_id}","starred_url":"https://api.github.com/users/amitaekbote/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amitaekbote/subscriptions","organizations_url":"https://api.github.com/users/amitaekbote/orgs","repos_url":"https://api.github.com/users/amitaekbote/repos","events_url":"https://api.github.com/users/amitaekbote/events{/privacy}","received_events_url":"https://api.github.com/users/amitaekbote/received_events","type":"User","site_admin":false},"repo":{"id":71487875,"name":"dcos-docs","full_name":"amitaekbote/dcos-docs","owner":{"login":"amitaekbote","id":4984257,"avatar_url":"https://avatars.githubusercontent.com/u/4984257?v=3","gravatar_id":"","url":"https://api.github.com/users/amitaekbote","html_url":"https://github.com/amitaekbote","followers_url":"https://api.github.com/users/amitaekbote/followers","following_url":"https://api.github.com/users/amitaekbote/following{/other_user}","gists_url":"https://api.github.com/users/amitaekbote/gists{/gist_id}","starred_url":"https://api.github.com/users/amitaekbote/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amitaekbote/subscriptions","organizations_url":"https://api.github.com/users/amitaekbote/orgs","repos_url":"https://api.github.com/users/amitaekbote/repos","events_url":"https://api.github.com/users/amitaekbote/events{/privacy}","received_events_url":"https://api.github.com/users/amitaekbote/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/amitaekbote/dcos-docs","description":"Documentation for Datacenter Operating System (DC/OS)","fork":true,"url":"https://api.github.com/repos/amitaekbote/dcos-docs","forks_url":"https://api.github.com/repos/amitaekbote/dcos-docs/forks","keys_url":"https://api.github.com/repos/amitaekbote/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/amitaekbote/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/amitaekbote/dcos-docs/teams","hooks_url":"https://api.github.com/repos/amitaekbote/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/amitaekbote/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/amitaekbote/dcos-docs/events","assignees_url":"https://api.github.com/repos/amitaekbote/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/amitaekbote/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/amitaekbote/dcos-docs/tags","blobs_url":"https://api.github.com/repos/amitaekbote/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/amitaekbote/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/amitaekbote/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/amitaekbote/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/amitaekbote/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/amitaekbote/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/amitaekbote/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/amitaekbote/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/amitaekbote/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/amitaekbote/dcos-docs/subscription","commits_url":"https://api.github.com/repos/amitaekbote/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/amitaekbote/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/amitaekbote/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/amitaekbote/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/amitaekbote/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/amitaekbote/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/amitaekbote/dcos-docs/merges","archive_url":"https://api.github.com/repos/amitaekbote/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/amitaekbote/dcos-docs/downloads","issues_url":"https://api.github.com/repos/amitaekbote/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/amitaekbote/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/amitaekbote/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/amitaekbote/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/amitaekbote/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/amitaekbote/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/amitaekbote/dcos-docs/deployments","created_at":"2016-10-20T17:35:40Z","updated_at":"2016-10-20T17:35:43Z","pushed_at":"2016-11-02T19:13:08Z","git_url":"git://github.com/amitaekbote/dcos-docs.git","ssh_url":"git@github.com:amitaekbote/dcos-docs.git","clone_url":"https://github.com/amitaekbote/dcos-docs.git","svn_url":"https://github.com/amitaekbote/dcos-docs","homepage":"http://dcos.io","size":37446,"stargazers_count":0,"watchers_count":0,"language":"Shell","has_issues":false,"has_downloads":true,"has_wiki":false,"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":"dcos:master","ref":"master","sha":"4b06f738f43ae86f2d555b6bb4bc10ec3cdd3f62","user":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"repo":{"id":53887483,"name":"dcos-docs","full_name":"dcos/dcos-docs","owner":{"login":"dcos","id":17648048,"avatar_url":"https://avatars.githubusercontent.com/u/17648048?v=3","gravatar_id":"","url":"https://api.github.com/users/dcos","html_url":"https://github.com/dcos","followers_url":"https://api.github.com/users/dcos/followers","following_url":"https://api.github.com/users/dcos/following{/other_user}","gists_url":"https://api.github.com/users/dcos/gists{/gist_id}","starred_url":"https://api.github.com/users/dcos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dcos/subscriptions","organizations_url":"https://api.github.com/users/dcos/orgs","repos_url":"https://api.github.com/users/dcos/repos","events_url":"https://api.github.com/users/dcos/events{/privacy}","received_events_url":"https://api.github.com/users/dcos/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dcos/dcos-docs","description":"Documentation for DC/OS","fork":false,"url":"https://api.github.com/repos/dcos/dcos-docs","forks_url":"https://api.github.com/repos/dcos/dcos-docs/forks","keys_url":"https://api.github.com/repos/dcos/dcos-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dcos/dcos-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dcos/dcos-docs/teams","hooks_url":"https://api.github.com/repos/dcos/dcos-docs/hooks","issue_events_url":"https://api.github.com/repos/dcos/dcos-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dcos/dcos-docs/events","assignees_url":"https://api.github.com/repos/dcos/dcos-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dcos/dcos-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dcos/dcos-docs/tags","blobs_url":"https://api.github.com/repos/dcos/dcos-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dcos/dcos-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dcos/dcos-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dcos/dcos-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dcos/dcos-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dcos/dcos-docs/languages","stargazers_url":"https://api.github.com/repos/dcos/dcos-docs/stargazers","contributors_url":"https://api.github.com/repos/dcos/dcos-docs/contributors","subscribers_url":"https://api.github.com/repos/dcos/dcos-docs/subscribers","subscription_url":"https://api.github.com/repos/dcos/dcos-docs/subscription","commits_url":"https://api.github.com/repos/dcos/dcos-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dcos/dcos-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dcos/dcos-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dcos/dcos-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dcos/dcos-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dcos/dcos-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dcos/dcos-docs/merges","archive_url":"https://api.github.com/repos/dcos/dcos-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dcos/dcos-docs/downloads","issues_url":"https://api.github.com/repos/dcos/dcos-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dcos/dcos-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dcos/dcos-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dcos/dcos-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dcos/dcos-docs/labels{/name}","releases_url":"https://api.github.com/repos/dcos/dcos-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dcos/dcos-docs/deployments","created_at":"2016-03-14T19:58:33Z","updated_at":"2016-10-27T23:21:25Z","pushed_at":"2016-11-03T07:37:03Z","git_url":"git://github.com/dcos/dcos-docs.git","ssh_url":"git@github.com:dcos/dcos-docs.git","clone_url":"https://github.com/dcos/dcos-docs.git","svn_url":"https://github.com/dcos/dcos-docs","homepage":"http://dcos.io","size":38085,"stargazers_count":62,"watchers_count":62,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":61,"mirror_url":null,"open_issues_count":20,"forks":61,"open_issues":20,"watchers":62,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/702"},"html":{"href":"https://github.com/dcos/dcos-docs/pull/702"},"issue":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/702"},"comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/issues/702/comments"},"review_comments":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/702/comments"},"review_comment":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dcos/dcos-docs/pulls/702/commits"},"statuses":{"href":"https://api.github.com/repos/dcos/dcos-docs/statuses/ca7604f68ade706f3297e34977fa857596bde98b"}}}}
{"actor":{"display_login":"lingmann"}}