Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="icon=false|title=Table of Contents" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86aWNvbj1mYWxzZXx0aXRsZT1UYWJsZSBvZiBDb250ZW50c30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvY30&amp;locale=en_GB&amp;version=2" data-macro-name="toc"></td></tr></table><h1>How to Upgrade</h1><p>Note that you can directly upgrade from one version to another. For example, to upgrade from version 3.1 to version 3.5, it is not necessary to first upgrade to version 3.2, then to version 3.3, and so on.</p><ol><li>Check compatibility of installed plugins<br /><ul><li>If Sonar is not connected to the Internet, check for minimum required versions <a href="http://docs.codehaus.org/display/SONAR/Plugin+version+matrix">listed in this page</a>.</li><li>If Sonar is connected to the Internet, the <a class="confluence-link" href="/display/SONAR/Update+Center" data-linked-resource-id="185598091" data-linked-resource-type="page" data-linked-resource-default-alias="Update Center" data-base-url="http://docs.codehaus.org">Update Center</a> lists all the plugins to upgrade or to uninstall:<br /><br /> <img class="confluence-embedded-image image-center" height="326" width="695" confluence-query-params="effects=drop-shadow" src="/download/attachments/231080121/updatecenter.jpg?version=1&amp;modificationDate=1369353565875&amp;effects=drop-shadow" data-image-src="/download/attachments/231080121/updatecenter.jpg?version=1&amp;modificationDate=1369353565875&amp;effects=drop-shadow" data-linked-resource-id="231375581" data-linked-resource-type="attachment" data-linked-resource-default-alias="updatecenter.jpg" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231080121" title="null > updatecenter.jpg" data-element-title="updatecenter.jpg"></li></ul></li><li>Read notes below for each version</li><li><p>Stop Sonar:</p><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>bin/&lt;SYSTEM>/sonar stop</pre></td></tr></table></li><li><a href="http://sonarsource.org/downloads">Download</a> and unzip Sonar in a fresh directory, let's say {$NEW_SONAR_HOME}</li><li>Update the content of the sonar.properties and wrapper.conf files located in the {$NEW_SONAR_HOME}/conf directory according of the content of the related files in the {$OLD_SONAR_HOME}/conf directory</li><li>Copy the directories extensions/plugins and extensions/rules from {$OLD_SONAR_HOME} to {$NEW_SONAR_HOME} (if you see problems while starting, try to remove the copied plugins from the extensions/plugins-directory and reinstall the plugins manually via the webinterface)</li><li>If a custom JDBC driver is used, copy it into {$NEW_SONAR_HOME}/extensions/jdbc-driver/&lt;dialect&gt;</li><li>Doing a database backup is recommended</li><li>If Sonar is deployed on a <a class="confluence-link" href="/display/SONAR/Deploying+Sonar+on+Tomcat+or+Jetty" data-linked-resource-id="229737654" data-linked-resource-type="page" data-linked-resource-default-alias="Deploying Sonar on Tomcat or Jetty" data-base-url="http://docs.codehaus.org">Tomcat or Jetty server</a>, build the WAR file by executing the script {$NEW_SONAR_HOME}/war/build-war</li><li><p>Start server (or deploy war on server):</p><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>bin/&lt;SYSTEM>/sonar start</pre></td></tr></table></li><li>Browse to <a href="http://localhost:9000/setup">http://localhost:9000/setup</a> (replace &quot;localhost:9000&quot; by your own URL) and follow the setup instructions</li><li>Analyze your projects to get fresh measures</li></ol><table class="wysiwyg-macro" data-macro-name="note" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vdGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>Upgrading can take a while depending on the size of projects portfolio. To monitor the process, check the logs and the console.</p><p>Upgrade is completed when an analysis has been run on project. Only at that point will you get new functionality working for sure.</p></td></tr></table><h1>Release Upgrade Notes</h1><p><span style="color: rgb(51,51,51);">Usually Sonar releases come with some specific recommendations for upgrading from the previous version. You have to read the upgrade notes for all versions between your current version and the target version.</span></p><p><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2NoaWxkcmVufQ&amp;locale=en_GB&amp;version=2" data-macro-name="children"></p>