{"action":"created","comment":{"url":"https://api.github.com/repos/Metaswitch/calico/pulls/comments/30877769","id":30877769,"diff_hunk":"@@ -0,0 +1,133 @@\n+Upgrade Procedure (OpenStack)\n+=============================\n+\n+This document details the procedure for upgrading a Calico-based OpenStack\n+system. It contains the full steps for upgrading all components and the order\n+in which that upgrade should be performed. Most releases do not concurrently\n+upgrade all of these components: if a release does not upgrade a given\n+component, you may skip those steps.\n+\n+.. warning:: While the upgrade procedure is very safe, you will be unable to\n+             issue API requests to your OpenStack system during the procedure.\n+             Please plan your upgrade window accordingly, and see the\n+             :ref:`service_impact` section for more details.\n+\n+\n+.. _service_impact:\n+\n+Service Impact\n+--------------\n+\n+During the upgrade, **all VMs will continue to function normally**: there\n+should be no impact on the data plane. However, control plane traffic may fail\n+at different points throughout the upgrade.\n+\n+Generally, users should be prevented from creating or updating virtual machines\n+during this procedure, as these actions will fail. VM deletion *may* succeed,\n+but will likely be delayed until the end of the upgrade.\n+\n+For this reason, we highly recommend planning a maintenance window for the\n+upgrade. During this window, you should disable all user API access to your\n+OpenStack deployment.\n+\n+Upgrade Procedure\n+-----------------\n+\n+Upgrade is performed in the following stages.\n+\n+1: Upgrade etcd\n+~~~~~~~~~~~~~~~\n+\n+This step should be run on every machine in your deployment that runs any\n+Calico code, and also on the machine running the etcd cluster.\n+\n+Ubuntu 14.04\n+^^^^^^^^^^^^\n+\n+On the machine running etcd, simply use apt-get to obtain the more recent","path":"docs/source/opens-upgrade.rst","position":47,"original_position":47,"commit_id":"5d33412069fb882698d7f5b6d55021aa367f34ff","original_commit_id":"5d33412069fb882698d7f5b6d55021aa367f34ff","user":{"login":"ed-harrison","id":6351761,"avatar_url":"https://avatars.githubusercontent.com/u/6351761?v=3","gravatar_id":"","url":"https://api.github.com/users/ed-harrison","html_url":"https://github.com/ed-harrison","followers_url":"https://api.github.com/users/ed-harrison/followers","following_url":"https://api.github.com/users/ed-harrison/following{/other_user}","gists_url":"https://api.github.com/users/ed-harrison/gists{/gist_id}","starred_url":"https://api.github.com/users/ed-harrison/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ed-harrison/subscriptions","organizations_url":"https://api.github.com/users/ed-harrison/orgs","repos_url":"https://api.github.com/users/ed-harrison/repos","events_url":"https://api.github.com/users/ed-harrison/events{/privacy}","received_events_url":"https://api.github.com/users/ed-harrison/received_events","type":"User","site_admin":false},"body":"Personally, I'd remove \"simply\" here.","created_at":"2015-05-22T08:35:09Z","updated_at":"2015-05-22T08:35:09Z","html_url":"https://github.com/Metaswitch/calico/pull/576#discussion_r30877769","pull_request_url":"https://api.github.com/repos/Metaswitch/calico/pulls/576","_links":{"self":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/comments/30877769"},"html":{"href":"https://github.com/Metaswitch/calico/pull/576#discussion_r30877769"},"pull_request":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/576"}}},"pull_request":{"url":"https://api.github.com/repos/Metaswitch/calico/pulls/576","id":35944383,"html_url":"https://github.com/Metaswitch/calico/pull/576","diff_url":"https://github.com/Metaswitch/calico/pull/576.diff","patch_url":"https://github.com/Metaswitch/calico/pull/576.patch","issue_url":"https://api.github.com/repos/Metaswitch/calico/issues/576","number":576,"state":"open","locked":false,"title":"Initial upgrade procedure documentation","user":{"login":"Lukasa","id":1382556,"avatar_url":"https://avatars.githubusercontent.com/u/1382556?v=3","gravatar_id":"","url":"https://api.github.com/users/Lukasa","html_url":"https://github.com/Lukasa","followers_url":"https://api.github.com/users/Lukasa/followers","following_url":"https://api.github.com/users/Lukasa/following{/other_user}","gists_url":"https://api.github.com/users/Lukasa/gists{/gist_id}","starred_url":"https://api.github.com/users/Lukasa/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Lukasa/subscriptions","organizations_url":"https://api.github.com/users/Lukasa/orgs","repos_url":"https://api.github.com/users/Lukasa/repos","events_url":"https://api.github.com/users/Lukasa/events{/privacy}","received_events_url":"https://api.github.com/users/Lukasa/received_events","type":"User","site_admin":false},"body":"This is my first draft of documentation for our upgrade procedure.","created_at":"2015-05-21T15:14:12Z","updated_at":"2015-05-22T08:35:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f01a40d1829e527d8711a9883b95f62e0f849e77","assignee":{"login":"ed-harrison","id":6351761,"avatar_url":"https://avatars.githubusercontent.com/u/6351761?v=3","gravatar_id":"","url":"https://api.github.com/users/ed-harrison","html_url":"https://github.com/ed-harrison","followers_url":"https://api.github.com/users/ed-harrison/followers","following_url":"https://api.github.com/users/ed-harrison/following{/other_user}","gists_url":"https://api.github.com/users/ed-harrison/gists{/gist_id}","starred_url":"https://api.github.com/users/ed-harrison/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ed-harrison/subscriptions","organizations_url":"https://api.github.com/users/ed-harrison/orgs","repos_url":"https://api.github.com/users/ed-harrison/repos","events_url":"https://api.github.com/users/ed-harrison/events{/privacy}","received_events_url":"https://api.github.com/users/ed-harrison/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/Metaswitch/calico/milestones/7","html_url":"https://github.com/Metaswitch/calico/milestones/0.21","labels_url":"https://api.github.com/repos/Metaswitch/calico/milestones/7/labels","id":1106345,"number":7,"title":"0.21","description":"","creator":{"login":"Lukasa","id":1382556,"avatar_url":"https://avatars.githubusercontent.com/u/1382556?v=3","gravatar_id":"","url":"https://api.github.com/users/Lukasa","html_url":"https://github.com/Lukasa","followers_url":"https://api.github.com/users/Lukasa/followers","following_url":"https://api.github.com/users/Lukasa/following{/other_user}","gists_url":"https://api.github.com/users/Lukasa/gists{/gist_id}","starred_url":"https://api.github.com/users/Lukasa/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Lukasa/subscriptions","organizations_url":"https://api.github.com/users/Lukasa/orgs","repos_url":"https://api.github.com/users/Lukasa/repos","events_url":"https://api.github.com/users/Lukasa/events{/privacy}","received_events_url":"https://api.github.com/users/Lukasa/received_events","type":"User","site_admin":false},"open_issues":16,"closed_issues":21,"state":"open","created_at":"2015-05-12T09:00:25Z","updated_at":"2015-05-21T22:11:10Z","due_on":"2015-05-24T23:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/Metaswitch/calico/pulls/576/commits","review_comments_url":"https://api.github.com/repos/Metaswitch/calico/pulls/576/comments","review_comment_url":"https://api.github.com/repos/Metaswitch/calico/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Metaswitch/calico/issues/576/comments","statuses_url":"https://api.github.com/repos/Metaswitch/calico/statuses/5d33412069fb882698d7f5b6d55021aa367f34ff","head":{"label":"Metaswitch:upgrade-doc","ref":"upgrade-doc","sha":"5d33412069fb882698d7f5b6d55021aa367f34ff","user":{"login":"Metaswitch","id":453759,"avatar_url":"https://avatars.githubusercontent.com/u/453759?v=3","gravatar_id":"","url":"https://api.github.com/users/Metaswitch","html_url":"https://github.com/Metaswitch","followers_url":"https://api.github.com/users/Metaswitch/followers","following_url":"https://api.github.com/users/Metaswitch/following{/other_user}","gists_url":"https://api.github.com/users/Metaswitch/gists{/gist_id}","starred_url":"https://api.github.com/users/Metaswitch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Metaswitch/subscriptions","organizations_url":"https://api.github.com/users/Metaswitch/orgs","repos_url":"https://api.github.com/users/Metaswitch/repos","events_url":"https://api.github.com/users/Metaswitch/events{/privacy}","received_events_url":"https://api.github.com/users/Metaswitch/received_events","type":"Organization","site_admin":false},"repo":{"id":21242831,"name":"calico","full_name":"Metaswitch/calico","owner":{"login":"Metaswitch","id":453759,"avatar_url":"https://avatars.githubusercontent.com/u/453759?v=3","gravatar_id":"","url":"https://api.github.com/users/Metaswitch","html_url":"https://github.com/Metaswitch","followers_url":"https://api.github.com/users/Metaswitch/followers","following_url":"https://api.github.com/users/Metaswitch/following{/other_user}","gists_url":"https://api.github.com/users/Metaswitch/gists{/gist_id}","starred_url":"https://api.github.com/users/Metaswitch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Metaswitch/subscriptions","organizations_url":"https://api.github.com/users/Metaswitch/orgs","repos_url":"https://api.github.com/users/Metaswitch/repos","events_url":"https://api.github.com/users/Metaswitch/events{/privacy}","received_events_url":"https://api.github.com/users/Metaswitch/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Metaswitch/calico","description":"Project Calico core repository.","fork":false,"url":"https://api.github.com/repos/Metaswitch/calico","forks_url":"https://api.github.com/repos/Metaswitch/calico/forks","keys_url":"https://api.github.com/repos/Metaswitch/calico/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Metaswitch/calico/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Metaswitch/calico/teams","hooks_url":"https://api.github.com/repos/Metaswitch/calico/hooks","issue_events_url":"https://api.github.com/repos/Metaswitch/calico/issues/events{/number}","events_url":"https://api.github.com/repos/Metaswitch/calico/events","assignees_url":"https://api.github.com/repos/Metaswitch/calico/assignees{/user}","branches_url":"https://api.github.com/repos/Metaswitch/calico/branches{/branch}","tags_url":"https://api.github.com/repos/Metaswitch/calico/tags","blobs_url":"https://api.github.com/repos/Metaswitch/calico/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Metaswitch/calico/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Metaswitch/calico/git/refs{/sha}","trees_url":"https://api.github.com/repos/Metaswitch/calico/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Metaswitch/calico/statuses/{sha}","languages_url":"https://api.github.com/repos/Metaswitch/calico/languages","stargazers_url":"https://api.github.com/repos/Metaswitch/calico/stargazers","contributors_url":"https://api.github.com/repos/Metaswitch/calico/contributors","subscribers_url":"https://api.github.com/repos/Metaswitch/calico/subscribers","subscription_url":"https://api.github.com/repos/Metaswitch/calico/subscription","commits_url":"https://api.github.com/repos/Metaswitch/calico/commits{/sha}","git_commits_url":"https://api.github.com/repos/Metaswitch/calico/git/commits{/sha}","comments_url":"https://api.github.com/repos/Metaswitch/calico/comments{/number}","issue_comment_url":"https://api.github.com/repos/Metaswitch/calico/issues/comments{/number}","contents_url":"https://api.github.com/repos/Metaswitch/calico/contents/{+path}","compare_url":"https://api.github.com/repos/Metaswitch/calico/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Metaswitch/calico/merges","archive_url":"https://api.github.com/repos/Metaswitch/calico/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Metaswitch/calico/downloads","issues_url":"https://api.github.com/repos/Metaswitch/calico/issues{/number}","pulls_url":"https://api.github.com/repos/Metaswitch/calico/pulls{/number}","milestones_url":"https://api.github.com/repos/Metaswitch/calico/milestones{/number}","notifications_url":"https://api.github.com/repos/Metaswitch/calico/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Metaswitch/calico/labels{/name}","releases_url":"https://api.github.com/repos/Metaswitch/calico/releases{/id}","created_at":"2014-06-26T14:08:43Z","updated_at":"2015-05-22T02:13:21Z","pushed_at":"2015-05-21T23:58:51Z","git_url":"git://github.com/Metaswitch/calico.git","ssh_url":"git@github.com:Metaswitch/calico.git","clone_url":"https://github.com/Metaswitch/calico.git","svn_url":"https://github.com/Metaswitch/calico","homepage":"http://projectcalico.org/","size":13788,"stargazers_count":76,"watchers_count":76,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":16,"mirror_url":null,"open_issues_count":63,"forks":16,"open_issues":63,"watchers":76,"default_branch":"master"}},"base":{"label":"Metaswitch:master","ref":"master","sha":"6d8cfe9684ee2b9d9e12c1d5635d41ebd8582253","user":{"login":"Metaswitch","id":453759,"avatar_url":"https://avatars.githubusercontent.com/u/453759?v=3","gravatar_id":"","url":"https://api.github.com/users/Metaswitch","html_url":"https://github.com/Metaswitch","followers_url":"https://api.github.com/users/Metaswitch/followers","following_url":"https://api.github.com/users/Metaswitch/following{/other_user}","gists_url":"https://api.github.com/users/Metaswitch/gists{/gist_id}","starred_url":"https://api.github.com/users/Metaswitch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Metaswitch/subscriptions","organizations_url":"https://api.github.com/users/Metaswitch/orgs","repos_url":"https://api.github.com/users/Metaswitch/repos","events_url":"https://api.github.com/users/Metaswitch/events{/privacy}","received_events_url":"https://api.github.com/users/Metaswitch/received_events","type":"Organization","site_admin":false},"repo":{"id":21242831,"name":"calico","full_name":"Metaswitch/calico","owner":{"login":"Metaswitch","id":453759,"avatar_url":"https://avatars.githubusercontent.com/u/453759?v=3","gravatar_id":"","url":"https://api.github.com/users/Metaswitch","html_url":"https://github.com/Metaswitch","followers_url":"https://api.github.com/users/Metaswitch/followers","following_url":"https://api.github.com/users/Metaswitch/following{/other_user}","gists_url":"https://api.github.com/users/Metaswitch/gists{/gist_id}","starred_url":"https://api.github.com/users/Metaswitch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Metaswitch/subscriptions","organizations_url":"https://api.github.com/users/Metaswitch/orgs","repos_url":"https://api.github.com/users/Metaswitch/repos","events_url":"https://api.github.com/users/Metaswitch/events{/privacy}","received_events_url":"https://api.github.com/users/Metaswitch/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Metaswitch/calico","description":"Project Calico core repository.","fork":false,"url":"https://api.github.com/repos/Metaswitch/calico","forks_url":"https://api.github.com/repos/Metaswitch/calico/forks","keys_url":"https://api.github.com/repos/Metaswitch/calico/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Metaswitch/calico/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Metaswitch/calico/teams","hooks_url":"https://api.github.com/repos/Metaswitch/calico/hooks","issue_events_url":"https://api.github.com/repos/Metaswitch/calico/issues/events{/number}","events_url":"https://api.github.com/repos/Metaswitch/calico/events","assignees_url":"https://api.github.com/repos/Metaswitch/calico/assignees{/user}","branches_url":"https://api.github.com/repos/Metaswitch/calico/branches{/branch}","tags_url":"https://api.github.com/repos/Metaswitch/calico/tags","blobs_url":"https://api.github.com/repos/Metaswitch/calico/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Metaswitch/calico/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Metaswitch/calico/git/refs{/sha}","trees_url":"https://api.github.com/repos/Metaswitch/calico/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Metaswitch/calico/statuses/{sha}","languages_url":"https://api.github.com/repos/Metaswitch/calico/languages","stargazers_url":"https://api.github.com/repos/Metaswitch/calico/stargazers","contributors_url":"https://api.github.com/repos/Metaswitch/calico/contributors","subscribers_url":"https://api.github.com/repos/Metaswitch/calico/subscribers","subscription_url":"https://api.github.com/repos/Metaswitch/calico/subscription","commits_url":"https://api.github.com/repos/Metaswitch/calico/commits{/sha}","git_commits_url":"https://api.github.com/repos/Metaswitch/calico/git/commits{/sha}","comments_url":"https://api.github.com/repos/Metaswitch/calico/comments{/number}","issue_comment_url":"https://api.github.com/repos/Metaswitch/calico/issues/comments{/number}","contents_url":"https://api.github.com/repos/Metaswitch/calico/contents/{+path}","compare_url":"https://api.github.com/repos/Metaswitch/calico/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Metaswitch/calico/merges","archive_url":"https://api.github.com/repos/Metaswitch/calico/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Metaswitch/calico/downloads","issues_url":"https://api.github.com/repos/Metaswitch/calico/issues{/number}","pulls_url":"https://api.github.com/repos/Metaswitch/calico/pulls{/number}","milestones_url":"https://api.github.com/repos/Metaswitch/calico/milestones{/number}","notifications_url":"https://api.github.com/repos/Metaswitch/calico/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Metaswitch/calico/labels{/name}","releases_url":"https://api.github.com/repos/Metaswitch/calico/releases{/id}","created_at":"2014-06-26T14:08:43Z","updated_at":"2015-05-22T02:13:21Z","pushed_at":"2015-05-21T23:58:51Z","git_url":"git://github.com/Metaswitch/calico.git","ssh_url":"git@github.com:Metaswitch/calico.git","clone_url":"https://github.com/Metaswitch/calico.git","svn_url":"https://github.com/Metaswitch/calico","homepage":"http://projectcalico.org/","size":13788,"stargazers_count":76,"watchers_count":76,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":16,"mirror_url":null,"open_issues_count":63,"forks":16,"open_issues":63,"watchers":76,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/576"},"html":{"href":"https://github.com/Metaswitch/calico/pull/576"},"issue":{"href":"https://api.github.com/repos/Metaswitch/calico/issues/576"},"comments":{"href":"https://api.github.com/repos/Metaswitch/calico/issues/576/comments"},"review_comments":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/576/comments"},"review_comment":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Metaswitch/calico/pulls/576/commits"},"statuses":{"href":"https://api.github.com/repos/Metaswitch/calico/statuses/5d33412069fb882698d7f5b6d55021aa367f34ff"}}}}