Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Check compatibility of installed plugins
    • If Sonar the SonarQube server is not connected to the Internet, check for minimum required versions listed in this page.
    • If Sonar the SonarQube server is connected to the Internet, the Update Center lists all the plugins to upgrade or to uninstall:

  2. Read upgrade notes below for each version
  3. Stop Sonar:

    Code Block
    bin/<SYSTEM>/sonar stop
  4. Download and unzip Sonar the new SonarQube distribution in a fresh directory, let's say {$NEWNEW_SONARSONARQUBE_HOME}
  5. Update the content of the and wrapper.conf files located in the {$NEW_SONARthe NEW_SONARQUBE_HOME}/conf directory according of with the content of the related files in the {$OLD_SONARthe OLD_SONARQUBE_HOME}/conf directory (web server URL, database settings, etc.)
  6. Copy the directories OLD_SONARQUBE_HOME/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 web interface directory into NEW_SONARQUBE_HOME/extensions/plugins (replace plugins with compatible versions if necessary)
  7. If a custom JDBC driver is used, copy it into {$NEWNEW_SONARSONARQUBE_HOME}/extensions/jdbc-driver/<dialect>
  8. Doing a database backup is recommendedBack up your database
  9. Start the web server:

    Code Block
  10. Browse to http://localhost:9000/setup (replace "localhost:9000" by your own URL) and follow the setup instructions
  11. 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.