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 58 Next »

Upgrade guide

  • Before upgrading, please read the notes for versions 2.0 , 2.1, 2.2 or 2.3.
  • Stop Sonar :
  • Unzip the new version of Sonar in a fresh directory, let's say {$NEW_SONAR_HOME}
  • Copy and wrapper.conf files from {$OLD_SONAR_HOME}/conf to {$NEW_SONAR_HOME}/conf or configure
  • If you use rules extensions or your own jdbc drivers, copy the corresponding directories into /extensions from {$OLD_SONAR_HOME} to {$NEW_SONAR_HOME}
  • If you are using Sonar plugins, you should copy them to the new instance. Check the compatibility between Sonar core and the plugin before doing so.
  • Backup your database
  • If Sonar is deployed on a JEE application server, repackage the WAR file by executing the script /war/build-war
  • Start the server (or restart the application server)
  • Browse to http://localhost:9000/setup and follow setup instructions.
  • Re-analyze your projects to get fresh measures

Upgrade process


Upgrade process can take a while depending on the size of projects portfolio. To monitor the process, checks the logs and / or the console.

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

Release 2.3 Upgrade Notes


  • Some findbugs violations have been missing in previous versions (see SONAR-1666). A consequence is that some rules can generate more violations on the same codebase.
  • The profile "Sonar way with Findbugs" includes new rules (see SONAR-1534). Projects using this profile can have much more violations for the same codebase.


  • The rule CloneMethodMustImplementCloneable was badly configured, so it has never been executed (see SONAR-1805). This rule is activated in the profile "Sonar way", so some projects can have some new violations with the same codebase.

Metric LCOM4

  • Some member variables, for example loggers, are now excluded from LCOM4 (see SONAR-1641). This metric can vary on some classes compared to previous versions.

Not compatible plugins

Plugins Rules Meter and Web (version 0.1 only) are not compatible. They must be uninstalled before starting the SonarQube server. Delete the files from /extensions/plugins/.

  • No labels