{"action":"created","comment":{"url":"https://api.github.com/repos/sonatype/nexus-book/pulls/comments/77820583","id":77820583,"diff_hunk":"@@ -1,121 +1,142 @@\n [[upgrading]]\n-==  Upgrading {nxrm} to 3.1 or Later\n+==  Upgrading\n {inall}\n \n [[upgrade-introduction]]\n === Introduction\n \n-{nxrm} 3 represents a shift in design that now supports a wider set of features requested by customers, as well\n-as a platform for a modern, expanded set of functionality still to come. Given these changes, many to the core\n+Upgrading {nxrm} present a necessary step to gain access to new features, bug fixes, performance improvements and\n+other advantages. Regular updates to latest release are recommended as a general best practice.\n+\n+Specifically {nxrm} 3 represents a shift in design that supports a wider set of features requested by customers,\n+as well as a platform for a modern, expanded set of functionality. Given these changes, many to the core\n architecture, the upgrade process requires more attention than in previous versions.\n \n-In this chapter, we've isolated the most common path for the upgrade process from {nxrm} version 2.14 (or later) \n-to 3.1 (or later) only. To help facilitate this process, capabilities have been added in both version 2.14 (or \n-later) and 3.1 (or later). Where appropriate we have also highlighted other upgrade paths for previous versions \n-as well. However, it's important to keep in mind that there may be specific items unique to your installation and \n-upgrade needs. For specific help outside this more standard path consult Sonatype's \n-link:https://support.sonatype.com/hc/en-us/sections/204911768-Installation-Upgrade-and-Compatibility[Support Knowledge Base articles], or contact support directly (available for {pro} customers).\n+This chapter covers upgrades of {nxrm} in general. The process of upgrading depends on the specific usage of the\n+repository manager, its configuration and interation with other tools and is potentially complex.  Further\n+resources can be found in the https://support.sonatype.com/hc/en-us/sections/204911768[Support Knowledge Base].\n+\n+IMPORTANT: {pro} customers can take advantage of the assistance of the support team.\n \n-[[why-upgrade]]\n-=== Why Upgrade?\n+[[motivation]]\n+=== Motivation\n \n-As of version 3.1 (or later) there is now wider feature and functionality equivalency to {nxrm} 2.\n-Highlights of new functionality available in version 3.1 (or later) include:\n+As of {nxrm} version 3.1  there is wider feature and functionality equivalency to {nxrm} 2.\n+Highlights of new functionality available in version 3 include:","path":"chapter-upgrading.asciidoc","position":38,"original_position":38,"commit_id":"4766505b363047565122f7ff811bbbd8a9d17890","original_commit_id":"4766505b363047565122f7ff811bbbd8a9d17890","user":{"login":"jwayman","id":2112401,"avatar_url":"https://avatars.githubusercontent.com/u/2112401?v=3","gravatar_id":"","url":"https://api.github.com/users/jwayman","html_url":"https://github.com/jwayman","followers_url":"https://api.github.com/users/jwayman/followers","following_url":"https://api.github.com/users/jwayman/following{/other_user}","gists_url":"https://api.github.com/users/jwayman/gists{/gist_id}","starred_url":"https://api.github.com/users/jwayman/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jwayman/subscriptions","organizations_url":"https://api.github.com/users/jwayman/orgs","repos_url":"https://api.github.com/users/jwayman/repos","events_url":"https://api.github.com/users/jwayman/events{/privacy}","received_events_url":"https://api.github.com/users/jwayman/received_events","type":"User","site_admin":false},"body":"Last usage of \"version\" should be Nexus Repository 3. Seems reasonable to qualify the availability of those features with a note about licensing.","created_at":"2016-09-07T13:25:33Z","updated_at":"2016-09-07T13:25:33Z","html_url":"https://github.com/sonatype/nexus-book/pull/226#discussion_r77820583","pull_request_url":"https://api.github.com/repos/sonatype/nexus-book/pulls/226","_links":{"self":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/comments/77820583"},"html":{"href":"https://github.com/sonatype/nexus-book/pull/226#discussion_r77820583"},"pull_request":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/226"}}},"pull_request":{"url":"https://api.github.com/repos/sonatype/nexus-book/pulls/226","id":84231710,"html_url":"https://github.com/sonatype/nexus-book/pull/226","diff_url":"https://github.com/sonatype/nexus-book/pull/226.diff","patch_url":"https://github.com/sonatype/nexus-book/pull/226.patch","issue_url":"https://api.github.com/repos/sonatype/nexus-book/issues/226","number":226,"state":"open","locked":false,"title":"Upgrade guide fixes","user":{"login":"mosabua","id":145658,"avatar_url":"https://avatars.githubusercontent.com/u/145658?v=3","gravatar_id":"","url":"https://api.github.com/users/mosabua","html_url":"https://github.com/mosabua","followers_url":"https://api.github.com/users/mosabua/followers","following_url":"https://api.github.com/users/mosabua/following{/other_user}","gists_url":"https://api.github.com/users/mosabua/gists{/gist_id}","starred_url":"https://api.github.com/users/mosabua/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mosabua/subscriptions","organizations_url":"https://api.github.com/users/mosabua/orgs","repos_url":"https://api.github.com/users/mosabua/repos","events_url":"https://api.github.com/users/mosabua/events{/privacy}","received_events_url":"https://api.github.com/users/mosabua/received_events","type":"User","site_admin":false},"body":"Please give it a read @dulanism and ping me for questions. We can go it change by change if necessary. There are numerous fixes and changes of varying impact in terms of complexity. I suggest to just build it locally and read the chapter (and the linked section in the install chapter). If it makes more sense than the prior version in your understanding... we should merge. ","created_at":"2016-09-07T03:36:00Z","updated_at":"2016-09-07T13:25:33Z","closed_at":null,"merged_at":null,"merge_commit_sha":"3ab901066e0e27c04b817ae730005279232157d4","assignee":{"login":"dulanism","id":5214266,"avatar_url":"https://avatars.githubusercontent.com/u/5214266?v=3","gravatar_id":"","url":"https://api.github.com/users/dulanism","html_url":"https://github.com/dulanism","followers_url":"https://api.github.com/users/dulanism/followers","following_url":"https://api.github.com/users/dulanism/following{/other_user}","gists_url":"https://api.github.com/users/dulanism/gists{/gist_id}","starred_url":"https://api.github.com/users/dulanism/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dulanism/subscriptions","organizations_url":"https://api.github.com/users/dulanism/orgs","repos_url":"https://api.github.com/users/dulanism/repos","events_url":"https://api.github.com/users/dulanism/events{/privacy}","received_events_url":"https://api.github.com/users/dulanism/received_events","type":"User","site_admin":false},"assignees":[{"login":"dulanism","id":5214266,"avatar_url":"https://avatars.githubusercontent.com/u/5214266?v=3","gravatar_id":"","url":"https://api.github.com/users/dulanism","html_url":"https://github.com/dulanism","followers_url":"https://api.github.com/users/dulanism/followers","following_url":"https://api.github.com/users/dulanism/following{/other_user}","gists_url":"https://api.github.com/users/dulanism/gists{/gist_id}","starred_url":"https://api.github.com/users/dulanism/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dulanism/subscriptions","organizations_url":"https://api.github.com/users/dulanism/orgs","repos_url":"https://api.github.com/users/dulanism/repos","events_url":"https://api.github.com/users/dulanism/events{/privacy}","received_events_url":"https://api.github.com/users/dulanism/received_events","type":"User","site_admin":false}],"milestone":null,"commits_url":"https://api.github.com/repos/sonatype/nexus-book/pulls/226/commits","review_comments_url":"https://api.github.com/repos/sonatype/nexus-book/pulls/226/comments","review_comment_url":"https://api.github.com/repos/sonatype/nexus-book/pulls/comments{/number}","comments_url":"https://api.github.com/repos/sonatype/nexus-book/issues/226/comments","statuses_url":"https://api.github.com/repos/sonatype/nexus-book/statuses/4766505b363047565122f7ff811bbbd8a9d17890","head":{"label":"sonatype:upgrade-guide-fixes","ref":"upgrade-guide-fixes","sha":"4766505b363047565122f7ff811bbbd8a9d17890","user":{"login":"sonatype","id":44938,"avatar_url":"https://avatars.githubusercontent.com/u/44938?v=3","gravatar_id":"","url":"https://api.github.com/users/sonatype","html_url":"https://github.com/sonatype","followers_url":"https://api.github.com/users/sonatype/followers","following_url":"https://api.github.com/users/sonatype/following{/other_user}","gists_url":"https://api.github.com/users/sonatype/gists{/gist_id}","starred_url":"https://api.github.com/users/sonatype/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sonatype/subscriptions","organizations_url":"https://api.github.com/users/sonatype/orgs","repos_url":"https://api.github.com/users/sonatype/repos","events_url":"https://api.github.com/users/sonatype/events{/privacy}","received_events_url":"https://api.github.com/users/sonatype/received_events","type":"Organization","site_admin":false},"repo":{"id":188759,"name":"nexus-book","full_name":"sonatype/nexus-book","owner":{"login":"sonatype","id":44938,"avatar_url":"https://avatars.githubusercontent.com/u/44938?v=3","gravatar_id":"","url":"https://api.github.com/users/sonatype","html_url":"https://github.com/sonatype","followers_url":"https://api.github.com/users/sonatype/followers","following_url":"https://api.github.com/users/sonatype/following{/other_user}","gists_url":"https://api.github.com/users/sonatype/gists{/gist_id}","starred_url":"https://api.github.com/users/sonatype/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sonatype/subscriptions","organizations_url":"https://api.github.com/users/sonatype/orgs","repos_url":"https://api.github.com/users/sonatype/repos","events_url":"https://api.github.com/users/sonatype/events{/privacy}","received_events_url":"https://api.github.com/users/sonatype/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/sonatype/nexus-book","description":"Repository Management with Nexus","fork":false,"url":"https://api.github.com/repos/sonatype/nexus-book","forks_url":"https://api.github.com/repos/sonatype/nexus-book/forks","keys_url":"https://api.github.com/repos/sonatype/nexus-book/keys{/key_id}","collaborators_url":"https://api.github.com/repos/sonatype/nexus-book/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/sonatype/nexus-book/teams","hooks_url":"https://api.github.com/repos/sonatype/nexus-book/hooks","issue_events_url":"https://api.github.com/repos/sonatype/nexus-book/issues/events{/number}","events_url":"https://api.github.com/repos/sonatype/nexus-book/events","assignees_url":"https://api.github.com/repos/sonatype/nexus-book/assignees{/user}","branches_url":"https://api.github.com/repos/sonatype/nexus-book/branches{/branch}","tags_url":"https://api.github.com/repos/sonatype/nexus-book/tags","blobs_url":"https://api.github.com/repos/sonatype/nexus-book/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/sonatype/nexus-book/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/sonatype/nexus-book/git/refs{/sha}","trees_url":"https://api.github.com/repos/sonatype/nexus-book/git/trees{/sha}","statuses_url":"https://api.github.com/repos/sonatype/nexus-book/statuses/{sha}","languages_url":"https://api.github.com/repos/sonatype/nexus-book/languages","stargazers_url":"https://api.github.com/repos/sonatype/nexus-book/stargazers","contributors_url":"https://api.github.com/repos/sonatype/nexus-book/contributors","subscribers_url":"https://api.github.com/repos/sonatype/nexus-book/subscribers","subscription_url":"https://api.github.com/repos/sonatype/nexus-book/subscription","commits_url":"https://api.github.com/repos/sonatype/nexus-book/commits{/sha}","git_commits_url":"https://api.github.com/repos/sonatype/nexus-book/git/commits{/sha}","comments_url":"https://api.github.com/repos/sonatype/nexus-book/comments{/number}","issue_comment_url":"https://api.github.com/repos/sonatype/nexus-book/issues/comments{/number}","contents_url":"https://api.github.com/repos/sonatype/nexus-book/contents/{+path}","compare_url":"https://api.github.com/repos/sonatype/nexus-book/compare/{base}...{head}","merges_url":"https://api.github.com/repos/sonatype/nexus-book/merges","archive_url":"https://api.github.com/repos/sonatype/nexus-book/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/sonatype/nexus-book/downloads","issues_url":"https://api.github.com/repos/sonatype/nexus-book/issues{/number}","pulls_url":"https://api.github.com/repos/sonatype/nexus-book/pulls{/number}","milestones_url":"https://api.github.com/repos/sonatype/nexus-book/milestones{/number}","notifications_url":"https://api.github.com/repos/sonatype/nexus-book/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/sonatype/nexus-book/labels{/name}","releases_url":"https://api.github.com/repos/sonatype/nexus-book/releases{/id}","deployments_url":"https://api.github.com/repos/sonatype/nexus-book/deployments","created_at":"2009-04-29T20:25:10Z","updated_at":"2016-09-06T15:21:13Z","pushed_at":"2016-09-07T10:52:36Z","git_url":"git://github.com/sonatype/nexus-book.git","ssh_url":"git@github.com:sonatype/nexus-book.git","clone_url":"https://github.com/sonatype/nexus-book.git","svn_url":"https://github.com/sonatype/nexus-book","homepage":"http://books.sonatype.com/nexus-book/reference/index.html","size":708311,"stargazers_count":53,"watchers_count":53,"language":"XSLT","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":27,"mirror_url":null,"open_issues_count":11,"forks":27,"open_issues":11,"watchers":53,"default_branch":"master"}},"base":{"label":"sonatype:nexus-3.1.x","ref":"nexus-3.1.x","sha":"0cd69e33c55d929d1eb95e22bb6671591e81eb40","user":{"login":"sonatype","id":44938,"avatar_url":"https://avatars.githubusercontent.com/u/44938?v=3","gravatar_id":"","url":"https://api.github.com/users/sonatype","html_url":"https://github.com/sonatype","followers_url":"https://api.github.com/users/sonatype/followers","following_url":"https://api.github.com/users/sonatype/following{/other_user}","gists_url":"https://api.github.com/users/sonatype/gists{/gist_id}","starred_url":"https://api.github.com/users/sonatype/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sonatype/subscriptions","organizations_url":"https://api.github.com/users/sonatype/orgs","repos_url":"https://api.github.com/users/sonatype/repos","events_url":"https://api.github.com/users/sonatype/events{/privacy}","received_events_url":"https://api.github.com/users/sonatype/received_events","type":"Organization","site_admin":false},"repo":{"id":188759,"name":"nexus-book","full_name":"sonatype/nexus-book","owner":{"login":"sonatype","id":44938,"avatar_url":"https://avatars.githubusercontent.com/u/44938?v=3","gravatar_id":"","url":"https://api.github.com/users/sonatype","html_url":"https://github.com/sonatype","followers_url":"https://api.github.com/users/sonatype/followers","following_url":"https://api.github.com/users/sonatype/following{/other_user}","gists_url":"https://api.github.com/users/sonatype/gists{/gist_id}","starred_url":"https://api.github.com/users/sonatype/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sonatype/subscriptions","organizations_url":"https://api.github.com/users/sonatype/orgs","repos_url":"https://api.github.com/users/sonatype/repos","events_url":"https://api.github.com/users/sonatype/events{/privacy}","received_events_url":"https://api.github.com/users/sonatype/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/sonatype/nexus-book","description":"Repository Management with Nexus","fork":false,"url":"https://api.github.com/repos/sonatype/nexus-book","forks_url":"https://api.github.com/repos/sonatype/nexus-book/forks","keys_url":"https://api.github.com/repos/sonatype/nexus-book/keys{/key_id}","collaborators_url":"https://api.github.com/repos/sonatype/nexus-book/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/sonatype/nexus-book/teams","hooks_url":"https://api.github.com/repos/sonatype/nexus-book/hooks","issue_events_url":"https://api.github.com/repos/sonatype/nexus-book/issues/events{/number}","events_url":"https://api.github.com/repos/sonatype/nexus-book/events","assignees_url":"https://api.github.com/repos/sonatype/nexus-book/assignees{/user}","branches_url":"https://api.github.com/repos/sonatype/nexus-book/branches{/branch}","tags_url":"https://api.github.com/repos/sonatype/nexus-book/tags","blobs_url":"https://api.github.com/repos/sonatype/nexus-book/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/sonatype/nexus-book/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/sonatype/nexus-book/git/refs{/sha}","trees_url":"https://api.github.com/repos/sonatype/nexus-book/git/trees{/sha}","statuses_url":"https://api.github.com/repos/sonatype/nexus-book/statuses/{sha}","languages_url":"https://api.github.com/repos/sonatype/nexus-book/languages","stargazers_url":"https://api.github.com/repos/sonatype/nexus-book/stargazers","contributors_url":"https://api.github.com/repos/sonatype/nexus-book/contributors","subscribers_url":"https://api.github.com/repos/sonatype/nexus-book/subscribers","subscription_url":"https://api.github.com/repos/sonatype/nexus-book/subscription","commits_url":"https://api.github.com/repos/sonatype/nexus-book/commits{/sha}","git_commits_url":"https://api.github.com/repos/sonatype/nexus-book/git/commits{/sha}","comments_url":"https://api.github.com/repos/sonatype/nexus-book/comments{/number}","issue_comment_url":"https://api.github.com/repos/sonatype/nexus-book/issues/comments{/number}","contents_url":"https://api.github.com/repos/sonatype/nexus-book/contents/{+path}","compare_url":"https://api.github.com/repos/sonatype/nexus-book/compare/{base}...{head}","merges_url":"https://api.github.com/repos/sonatype/nexus-book/merges","archive_url":"https://api.github.com/repos/sonatype/nexus-book/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/sonatype/nexus-book/downloads","issues_url":"https://api.github.com/repos/sonatype/nexus-book/issues{/number}","pulls_url":"https://api.github.com/repos/sonatype/nexus-book/pulls{/number}","milestones_url":"https://api.github.com/repos/sonatype/nexus-book/milestones{/number}","notifications_url":"https://api.github.com/repos/sonatype/nexus-book/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/sonatype/nexus-book/labels{/name}","releases_url":"https://api.github.com/repos/sonatype/nexus-book/releases{/id}","deployments_url":"https://api.github.com/repos/sonatype/nexus-book/deployments","created_at":"2009-04-29T20:25:10Z","updated_at":"2016-09-06T15:21:13Z","pushed_at":"2016-09-07T10:52:36Z","git_url":"git://github.com/sonatype/nexus-book.git","ssh_url":"git@github.com:sonatype/nexus-book.git","clone_url":"https://github.com/sonatype/nexus-book.git","svn_url":"https://github.com/sonatype/nexus-book","homepage":"http://books.sonatype.com/nexus-book/reference/index.html","size":708311,"stargazers_count":53,"watchers_count":53,"language":"XSLT","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":27,"mirror_url":null,"open_issues_count":11,"forks":27,"open_issues":11,"watchers":53,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/226"},"html":{"href":"https://github.com/sonatype/nexus-book/pull/226"},"issue":{"href":"https://api.github.com/repos/sonatype/nexus-book/issues/226"},"comments":{"href":"https://api.github.com/repos/sonatype/nexus-book/issues/226/comments"},"review_comments":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/226/comments"},"review_comment":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/sonatype/nexus-book/pulls/226/commits"},"statuses":{"href":"https://api.github.com/repos/sonatype/nexus-book/statuses/4766505b363047565122f7ff811bbbd8a9d17890"}}}}
{"actor":{"display_login":"jwayman"}}