{"action":"created","comment":{"url":"https://api.github.com/repos/openebs/openebs-docs/pulls/comments/222202838","pull_request_review_id":161031159,"id":222202838,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIyMjIwMjgzOA==","diff_hunk":"@@ -6,202 +6,133 @@ sidebar_label: Upgrade\n \n ------\n \n-OpenEBS supports upgrade to 0.6 version only from 0.5.3 and 0.5.4.\n+# Upgrade from OpenEBS 0.6.0 TO 0.7.0\n \n-For older verions, upgrade to either 0.5.3 or 0.5.4 before upgrading to 0.6. For steps to upgrade to 0.5.3 or 0.5.4, [click](https://v05-docs.openebs.io/) here.\n+## Overview\n \n+This document describes the steps for upgrading OpenEBS from 0.6.0 to 0.7.0. The upgrade of OpenEBS is a two step process. \n+- *Step 1* - Upgrade the OpenEBS Operator \n+- *Step 2* - Upgrade the OpenEBS Volumes that were created with older OpenEBS Operator (0.6.0) \n \n-1. Upgrade the OpenEBS operator.\n+**Note:**\n+For older verions, OpenEBS supports upgrade to 0.6 version only from 0.5.3 and 0.5.4. For steps to upgrade to 0.6.0, [click](https://v06-docs.openebs.io/docs/next/upgrade.html) here.\n \n-2. Upgrade the OpenEBS volumes that were created with older OpenEBS operator.\n+### Terminology\n \n-Upgrading OpenEBS Operator depends on how OpenEBS was installed (using kubectl or helm). Based on the type of installation select one of the following.\n+- *OpenEBS Operator : Refers to maya-apiserver & openebs-provisioner along w/ respective services, service a/c, roles, rolebindings*\n+- *OpenEBS Volume: The Jiva controller & replica pods*\n+- *All steps described in this document need to be performed on the Kubernetes master or from a machine that has access to Kubernetes master*\n \n-**Step-1 Upgrade OpenEBS Operator**\n+## Step 1: Upgrade the OpenEBS Operator\n \n-**Upgrade Using Kubectl** (OpenEBS was installed by kubectl using the openebs-operator.yaml file)\n+OpenEBS 0.7.0 has made the following significant changes to the OpenEBS Operator (aka OpenEBS control plane components):\n+- A new provisioning and policy enforcement engine. This introduces a breaking changes as it expects the volume policies to be present as annotations in storage class as opposed to `parameters` or `environment variables`.\n+- OpenEBS will install default jiva storage pool (named `default`) and storage class (named `openebs-jiva-default`). If these names conflict with your existing storage pool or storage classes, rename and re-apply your storage classes.\n+- Integrated with OpenEBS NDM project. A new Daemonset will be launched to discover the block devices attached to the nodes.\n \n-**Note:** The following sample steps will work only if you have installed OpenEBS without modifying the default values.\n+### Download the upgrade scripts\n \n-Delete the older openebs-operator and storage classes. Use the following command to delete the old openebs-operator file.\n+Either `git clone` or download the following files to your work directory. \n+https://github.com/openebs/openebs/tree/master/k8s/upgrades/0.6.0-0.7.0\n+- `patch-strategy-recreate.json`\n+- `replica.patch.tpl.yml`\n+- `controller.patch.tpl.yml`\n+- `oebs_update.sh`\n+- `pre_upgrade.sh`\n \n-```\n-kubectl delete -f openebs-operator.yaml\n-```\n-\n-The output must be displayed as follows.\n-```\n-serviceaccount \"openebs-maya-operator\" deleted\n-clusterrole \"openebs-maya-operator\" deleted\n-clusterrolebinding \"openebs-maya-operator\" deleted\n-deployment \"maya-apiserver\" deleted\n-service \"maya-apiserver-service\" deleted\n-deployment \"openebs-provisioner\" deleted\n-customresourcedefinition \"storagepoolclaims.openebs.io\" deleted\n-customresourcedefinition \"storagepools.openebs.io\" deleted\n-storageclass \"openebs-standard\" deleted\n-```\n+### Pre-requisites\n \n-Delete the storage classes using the following command.\n+Before upgrading the OpenEBS Operator, check if you are using a storage pool named `default` which will conflict with default jiva pool installed with OpenEBS 0.7.0:\n \n ```\n-kubectl delete -f openebs-storageclasses.yaml\n+./pre_upgrade.sh <openebs-namespace>\n ```\n \n-The output must be similar to the following.\n-```\n-storageclass \"openebs-standalone\" deleted\n-storageclass \"openebs-percona\" deleted\n-storageclass \"openebs-jupyter\" deleted\n-storageclass \"openebs-mongodb\" deleted\n-storageclass \"openebs-cassandra\" deleted\n-storageclass \"openebs-redis\" deleted\n-storageclass \"openebs-kafka\" deleted\n-storageclass \"openebs-zk\" deleted\n-storageclass \"openebs-es-data-sc\" deleted\n-```\n+### Upgrade volume policies in existing storage classes\n \n-Wait for the objects to be deleted. You can verify the same using the following command.\n+Use the following command to upgrade the storage classes volume policies. Move from parameters to annotations. This script will only update the following volume policies:\n \n-```\n-kubectl get deploy\n-```\n+- `openebs.io/replica-count`\n+- `openebs.io/storage-pool`\n+- `openebs.io/volume-monitor`\n \n-You can now install the 0.6 operator using following command.\n+The remaining policies will fallback to their default values. \n \n ```\n-kubectl apply -f https://raw.githubusercontent.com/openebs/openebs/v0.6/k8s/openebs-operator.yaml\n+./upgrade_sc.sh\n ```\n \n-The output must be similar to the following.\n+Alternatively, you can skip this step and re-apply your StorageClasses as per the 0.7.0 volume policy specification. ","path":"docs/upgrade.md","position":106,"original_position":106,"commit_id":"94f292aa51ec53242867fad91edba95f13de948d","original_commit_id":"94f292aa51ec53242867fad91edba95f13de948d","user":{"login":"mahebbar","id":30617626,"node_id":"MDQ6VXNlcjMwNjE3NjI2","avatar_url":"https://avatars0.githubusercontent.com/u/30617626?v=4","gravatar_id":"","url":"https://api.github.com/users/mahebbar","html_url":"https://github.com/mahebbar","followers_url":"https://api.github.com/users/mahebbar/followers","following_url":"https://api.github.com/users/mahebbar/following{/other_user}","gists_url":"https://api.github.com/users/mahebbar/gists{/gist_id}","starred_url":"https://api.github.com/users/mahebbar/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mahebbar/subscriptions","organizations_url":"https://api.github.com/users/mahebbar/orgs","repos_url":"https://api.github.com/users/mahebbar/repos","events_url":"https://api.github.com/users/mahebbar/events{/privacy}","received_events_url":"https://api.github.com/users/mahebbar/received_events","type":"User","site_admin":false},"body":"StorageClasses  = storage classes","created_at":"2018-10-03T07:04:37Z","updated_at":"2018-10-03T07:04:37Z","html_url":"https://github.com/openebs/openebs-docs/pull/315#discussion_r222202838","pull_request_url":"https://api.github.com/repos/openebs/openebs-docs/pulls/315","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/comments/222202838"},"html":{"href":"https://github.com/openebs/openebs-docs/pull/315#discussion_r222202838"},"pull_request":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/315"}}},"pull_request":{"url":"https://api.github.com/repos/openebs/openebs-docs/pulls/315","id":219337381,"node_id":"MDExOlB1bGxSZXF1ZXN0MjE5MzM3Mzgx","html_url":"https://github.com/openebs/openebs-docs/pull/315","diff_url":"https://github.com/openebs/openebs-docs/pull/315.diff","patch_url":"https://github.com/openebs/openebs-docs/pull/315.patch","issue_url":"https://api.github.com/repos/openebs/openebs-docs/issues/315","number":315,"state":"open","locked":false,"title":"Upgrade steps from 0.6 to 0.7","user":{"login":"prabhatkumarthakur","id":20839334,"node_id":"MDQ6VXNlcjIwODM5MzM0","avatar_url":"https://avatars2.githubusercontent.com/u/20839334?v=4","gravatar_id":"","url":"https://api.github.com/users/prabhatkumarthakur","html_url":"https://github.com/prabhatkumarthakur","followers_url":"https://api.github.com/users/prabhatkumarthakur/followers","following_url":"https://api.github.com/users/prabhatkumarthakur/following{/other_user}","gists_url":"https://api.github.com/users/prabhatkumarthakur/gists{/gist_id}","starred_url":"https://api.github.com/users/prabhatkumarthakur/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/prabhatkumarthakur/subscriptions","organizations_url":"https://api.github.com/users/prabhatkumarthakur/orgs","repos_url":"https://api.github.com/users/prabhatkumarthakur/repos","events_url":"https://api.github.com/users/prabhatkumarthakur/events{/privacy}","received_events_url":"https://api.github.com/users/prabhatkumarthakur/received_events","type":"User","site_admin":false},"body":"Steps for the upgrade from the 0.6 version to 0.7 version.\r\nSigned-off-by: Prabhat Kumar Thakur prabhat.thakur@mayadata.io","created_at":"2018-10-01T11:07:13Z","updated_at":"2018-10-03T07:04:37Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c0448051a9a4458745078f5688038e1f873800b4","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/openebs/openebs-docs/pulls/315/commits","review_comments_url":"https://api.github.com/repos/openebs/openebs-docs/pulls/315/comments","review_comment_url":"https://api.github.com/repos/openebs/openebs-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openebs/openebs-docs/issues/315/comments","statuses_url":"https://api.github.com/repos/openebs/openebs-docs/statuses/94f292aa51ec53242867fad91edba95f13de948d","head":{"label":"openebs:prabhatkumarthakur-patch-2","ref":"prabhatkumarthakur-patch-2","sha":"94f292aa51ec53242867fad91edba95f13de948d","user":{"login":"openebs","id":20769039,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwNzY5MDM5","avatar_url":"https://avatars0.githubusercontent.com/u/20769039?v=4","gravatar_id":"","url":"https://api.github.com/users/openebs","html_url":"https://github.com/openebs","followers_url":"https://api.github.com/users/openebs/followers","following_url":"https://api.github.com/users/openebs/following{/other_user}","gists_url":"https://api.github.com/users/openebs/gists{/gist_id}","starred_url":"https://api.github.com/users/openebs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openebs/subscriptions","organizations_url":"https://api.github.com/users/openebs/orgs","repos_url":"https://api.github.com/users/openebs/repos","events_url":"https://api.github.com/users/openebs/events{/privacy}","received_events_url":"https://api.github.com/users/openebs/received_events","type":"Organization","site_admin":false},"repo":{"id":121746365,"node_id":"MDEwOlJlcG9zaXRvcnkxMjE3NDYzNjU=","name":"openebs-docs","full_name":"openebs/openebs-docs","private":false,"owner":{"login":"openebs","id":20769039,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwNzY5MDM5","avatar_url":"https://avatars0.githubusercontent.com/u/20769039?v=4","gravatar_id":"","url":"https://api.github.com/users/openebs","html_url":"https://github.com/openebs","followers_url":"https://api.github.com/users/openebs/followers","following_url":"https://api.github.com/users/openebs/following{/other_user}","gists_url":"https://api.github.com/users/openebs/gists{/gist_id}","starred_url":"https://api.github.com/users/openebs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openebs/subscriptions","organizations_url":"https://api.github.com/users/openebs/orgs","repos_url":"https://api.github.com/users/openebs/repos","events_url":"https://api.github.com/users/openebs/events{/privacy}","received_events_url":"https://api.github.com/users/openebs/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/openebs/openebs-docs","description":"Documentation for OpenEBS project. OpenEBS provides storage for stateful applications on Kubernetes in CAS (Container Attached Storage) architecture.","fork":false,"url":"https://api.github.com/repos/openebs/openebs-docs","forks_url":"https://api.github.com/repos/openebs/openebs-docs/forks","keys_url":"https://api.github.com/repos/openebs/openebs-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openebs/openebs-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openebs/openebs-docs/teams","hooks_url":"https://api.github.com/repos/openebs/openebs-docs/hooks","issue_events_url":"https://api.github.com/repos/openebs/openebs-docs/issues/events{/number}","events_url":"https://api.github.com/repos/openebs/openebs-docs/events","assignees_url":"https://api.github.com/repos/openebs/openebs-docs/assignees{/user}","branches_url":"https://api.github.com/repos/openebs/openebs-docs/branches{/branch}","tags_url":"https://api.github.com/repos/openebs/openebs-docs/tags","blobs_url":"https://api.github.com/repos/openebs/openebs-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openebs/openebs-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openebs/openebs-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/openebs/openebs-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openebs/openebs-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/openebs/openebs-docs/languages","stargazers_url":"https://api.github.com/repos/openebs/openebs-docs/stargazers","contributors_url":"https://api.github.com/repos/openebs/openebs-docs/contributors","subscribers_url":"https://api.github.com/repos/openebs/openebs-docs/subscribers","subscription_url":"https://api.github.com/repos/openebs/openebs-docs/subscription","commits_url":"https://api.github.com/repos/openebs/openebs-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/openebs/openebs-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/openebs/openebs-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/openebs/openebs-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/openebs/openebs-docs/contents/{+path}","compare_url":"https://api.github.com/repos/openebs/openebs-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openebs/openebs-docs/merges","archive_url":"https://api.github.com/repos/openebs/openebs-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openebs/openebs-docs/downloads","issues_url":"https://api.github.com/repos/openebs/openebs-docs/issues{/number}","pulls_url":"https://api.github.com/repos/openebs/openebs-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/openebs/openebs-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/openebs/openebs-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openebs/openebs-docs/labels{/name}","releases_url":"https://api.github.com/repos/openebs/openebs-docs/releases{/id}","deployments_url":"https://api.github.com/repos/openebs/openebs-docs/deployments","created_at":"2018-02-16T12:04:56Z","updated_at":"2018-09-27T07:13:52Z","pushed_at":"2018-10-03T06:02:29Z","git_url":"git://github.com/openebs/openebs-docs.git","ssh_url":"git@github.com:openebs/openebs-docs.git","clone_url":"https://github.com/openebs/openebs-docs.git","svn_url":"https://github.com/openebs/openebs-docs","homepage":"https://docs.openebs.io","size":18441,"stargazers_count":13,"watchers_count":13,"language":"JavaScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":31,"mirror_url":null,"archived":false,"open_issues_count":9,"license":null,"forks":31,"open_issues":9,"watchers":13,"default_branch":"master"}},"base":{"label":"openebs:staging","ref":"staging","sha":"2d8c15782147eb29fbc633c32d3dfdd5923698a4","user":{"login":"openebs","id":20769039,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwNzY5MDM5","avatar_url":"https://avatars0.githubusercontent.com/u/20769039?v=4","gravatar_id":"","url":"https://api.github.com/users/openebs","html_url":"https://github.com/openebs","followers_url":"https://api.github.com/users/openebs/followers","following_url":"https://api.github.com/users/openebs/following{/other_user}","gists_url":"https://api.github.com/users/openebs/gists{/gist_id}","starred_url":"https://api.github.com/users/openebs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openebs/subscriptions","organizations_url":"https://api.github.com/users/openebs/orgs","repos_url":"https://api.github.com/users/openebs/repos","events_url":"https://api.github.com/users/openebs/events{/privacy}","received_events_url":"https://api.github.com/users/openebs/received_events","type":"Organization","site_admin":false},"repo":{"id":121746365,"node_id":"MDEwOlJlcG9zaXRvcnkxMjE3NDYzNjU=","name":"openebs-docs","full_name":"openebs/openebs-docs","private":false,"owner":{"login":"openebs","id":20769039,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIwNzY5MDM5","avatar_url":"https://avatars0.githubusercontent.com/u/20769039?v=4","gravatar_id":"","url":"https://api.github.com/users/openebs","html_url":"https://github.com/openebs","followers_url":"https://api.github.com/users/openebs/followers","following_url":"https://api.github.com/users/openebs/following{/other_user}","gists_url":"https://api.github.com/users/openebs/gists{/gist_id}","starred_url":"https://api.github.com/users/openebs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openebs/subscriptions","organizations_url":"https://api.github.com/users/openebs/orgs","repos_url":"https://api.github.com/users/openebs/repos","events_url":"https://api.github.com/users/openebs/events{/privacy}","received_events_url":"https://api.github.com/users/openebs/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/openebs/openebs-docs","description":"Documentation for OpenEBS project. OpenEBS provides storage for stateful applications on Kubernetes in CAS (Container Attached Storage) architecture.","fork":false,"url":"https://api.github.com/repos/openebs/openebs-docs","forks_url":"https://api.github.com/repos/openebs/openebs-docs/forks","keys_url":"https://api.github.com/repos/openebs/openebs-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openebs/openebs-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openebs/openebs-docs/teams","hooks_url":"https://api.github.com/repos/openebs/openebs-docs/hooks","issue_events_url":"https://api.github.com/repos/openebs/openebs-docs/issues/events{/number}","events_url":"https://api.github.com/repos/openebs/openebs-docs/events","assignees_url":"https://api.github.com/repos/openebs/openebs-docs/assignees{/user}","branches_url":"https://api.github.com/repos/openebs/openebs-docs/branches{/branch}","tags_url":"https://api.github.com/repos/openebs/openebs-docs/tags","blobs_url":"https://api.github.com/repos/openebs/openebs-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openebs/openebs-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openebs/openebs-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/openebs/openebs-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openebs/openebs-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/openebs/openebs-docs/languages","stargazers_url":"https://api.github.com/repos/openebs/openebs-docs/stargazers","contributors_url":"https://api.github.com/repos/openebs/openebs-docs/contributors","subscribers_url":"https://api.github.com/repos/openebs/openebs-docs/subscribers","subscription_url":"https://api.github.com/repos/openebs/openebs-docs/subscription","commits_url":"https://api.github.com/repos/openebs/openebs-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/openebs/openebs-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/openebs/openebs-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/openebs/openebs-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/openebs/openebs-docs/contents/{+path}","compare_url":"https://api.github.com/repos/openebs/openebs-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openebs/openebs-docs/merges","archive_url":"https://api.github.com/repos/openebs/openebs-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openebs/openebs-docs/downloads","issues_url":"https://api.github.com/repos/openebs/openebs-docs/issues{/number}","pulls_url":"https://api.github.com/repos/openebs/openebs-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/openebs/openebs-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/openebs/openebs-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openebs/openebs-docs/labels{/name}","releases_url":"https://api.github.com/repos/openebs/openebs-docs/releases{/id}","deployments_url":"https://api.github.com/repos/openebs/openebs-docs/deployments","created_at":"2018-02-16T12:04:56Z","updated_at":"2018-09-27T07:13:52Z","pushed_at":"2018-10-03T06:02:29Z","git_url":"git://github.com/openebs/openebs-docs.git","ssh_url":"git@github.com:openebs/openebs-docs.git","clone_url":"https://github.com/openebs/openebs-docs.git","svn_url":"https://github.com/openebs/openebs-docs","homepage":"https://docs.openebs.io","size":18441,"stargazers_count":13,"watchers_count":13,"language":"JavaScript","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":31,"mirror_url":null,"archived":false,"open_issues_count":9,"license":null,"forks":31,"open_issues":9,"watchers":13,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/315"},"html":{"href":"https://github.com/openebs/openebs-docs/pull/315"},"issue":{"href":"https://api.github.com/repos/openebs/openebs-docs/issues/315"},"comments":{"href":"https://api.github.com/repos/openebs/openebs-docs/issues/315/comments"},"review_comments":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/315/comments"},"review_comment":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openebs/openebs-docs/pulls/315/commits"},"statuses":{"href":"https://api.github.com/repos/openebs/openebs-docs/statuses/94f292aa51ec53242867fad91edba95f13de948d"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"mahebbar"}}