Versions Compared

Key

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

...

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.

  1. Check the compatibility of the installed plugins with the new version that you want to upgrade to. This information will be of use at step #6.
  2. If the SonarQube server is not connected to the Internet, check for minimum required versions listed in this page.
  3. If the SonarQube server is connected to the Internet, the Update Center lists all the plugins to upgrade or to uninstall (do not click on Upgrade or Uninstall, see 
    JIRA
    serverjira.codehaus.org
    keySONAR-5037
    ):
    Image RemovedRead the upgrade notes below for each version
  4. Stop the SonarQube server:

    Code Block
    bin/<SYSTEM>/sonar stop
  5. Download and unzip the new SonarQube distribution in a fresh directory, let's say NEW_SONARQUBE_HOME
  6. Update the content of the sonar.properties and wrapper.conf files located in the NEW_SONARQUBE_HOME/conf directory with the content of the related files in the OLD_SONARQUBE_HOME/conf directory (web server URL, database settings, etc.). Do not copy-paste the old files.
  7. Copy the OLD_SONARQUBE_HOME/extensions/plugins directory into NEW_SONARQUBE_HOME/extensions/plugins (replace plugins.
    Check for plugins compatibility and Upgrade the plugins with compatible versions if necessary, see step #1): see compatibility matrix.
  8. If a custom JDBC driver is used, copy it into NEW_SONARQUBE_HOME/extensions/jdbc-driver/<dialect>
  9. Back up your database
  10. Start the web server:

    Code Block
     NEW_SONARQUBE_HOME/bin/<SYSTEM>/sonar start
  11. Browse to http://localhost:9000/setup (replace "localhost:9000" by your own URL) and follow the setup instructions
  12. Analyze your projects to get fresh measures

 

Note

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

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

...