Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 84 Next »

How to upgrade

This guide describes how to upgrade from one version of Sonar to a later version.

  1. Check compatibility of installed plugins
    • If Sonar is not connected to Internet, check for minimum required versions listed in this page.
    • If Sonar is connected to Internet, Update Center lists all the plugins to upgrade or to uninstall :
  2. Read notes bellow for each version
  3. Stop Sonar :

  4. Download and unzip Sonar in a fresh directory, let's say {$NEW_SONAR_HOME}
  5. Update the content of the 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
  6. 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)
  7. If a custom JDBC driver is used, copy it into {$NEW_SONAR_HOME}/extensions/jdbc-driver/<dialect>
  8. Doing a database backup is recommended
  9. If Sonar is deployed on a JEE server, build the WAR file by executing the script {$NEW_SONAR_HOME}/war/build-war
  10. Start server (or deploy war into JEE server) :

  11. Browse to http://localhost:9000/setup and follow setup instructions
  12. Analyze your projects to get fresh measures

Upgrading can take a while depending on the size of projects portfolio. To monitor the process, check the logs and the console.

Upgrade is completed when an analysis has been run on project. Only at that point will you get new functionality working for sure.

Release Upgrade Notes

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.

  • No labels