Prerequisite

The only prerequisite for running Sonar is to have Java (Oracle JRE 6 onwards) installed on your machine.

Hardware Requirements

The Sonar web server requires at least 500Mb of RAM to run efficiently.
The amount of disk space you need will depend on how much code you analyze with Sonar. As an example, Nemo the public instance of Sonar, has more than 13 millions Lines of Code under analysis with 4 years of history. Nemo is currently running on a Amazon EC2 small instance, using about 10 Gb of drive space

Supported Platforms

Java
Oracle JRE	6 7
IBM JRE
GCJ
Oracle JRockit
Database
Apache Derby	Prior to Sonar 3.2. Bundled with Sonar but supported for evaluation use only. Although using the Derby database gives access to a fully functional version, upgrades are disabled. Therefore, before deploying to a production environment, we strongly recommend that you use an enterprise database.
H2	Since Sonar 3.2. Bundled with Sonar but supported for evaluation use only. Although using the H2 database gives access to a fully functional version, upgrades are disabled. Therefore, before deploying to a production environment, we strongly recommend that you use an enterprise database.
Microsoft SQL Server	2005 with bundled jTDS driver. Microsoft drivers are not supported. Express Edition is supported. 2008 with bundled jTDS driver. Microsoft drivers are not supported. Express Edition is supported. Collation must be case-sensitive (CS) and accent-sensitive (AS)
MySQL	5.0, 5.1 and 5.5 with the driver packaged with Sonar. 5.6 is supported in Sonar 3.5 (see SONAR-4137).
Oracle	10G with Oracle 11.2.x drivers 11G with Oracle 11.2.x drivers XE Editions are supported The driver ojdbc14.jar is not supported Only the thin mode is supported, not OCI
PostgreSQL	8.3 8.4 9.0 9.1
Application Server
Jetty 6	Bundled with Sonar
Apache Tomcat	5.5 6.0 7.0
JBoss
GlassFish
Web Browser
To get the full experience Sonar has to offer, you should enable Javascript in your browser.
Microsoft Internet Explorer	IE7 (not compatible with Views administration console) IE8 IE9
Mozilla Firefox	Supported
Google Chrome	Supported
Opera	Not tested
Safari	Supported

Unable to render {include} The included page could not be found.

Table of Contents

How to Upgrade
Release Upgrade Notes

How to Upgrade

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.

Check compatibility of installed plugins
- If Sonar is not connected to the Internet, check for minimum required versions listed in this page.
- If Sonar is connected to the Internet, the Update Center lists all the plugins to upgrade or to uninstall:
Read notes below for each version
Stop Sonar:
Download and unzip Sonar in a fresh directory, let's say {$NEW_SONAR_HOME}
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
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)
If a custom JDBC driver is used, copy it into {$NEW_SONAR_HOME}/extensions/jdbc-driver/<dialect>
Doing a database backup is recommended
If Sonar is deployed on a Tomcat or Jetty server, build the WAR file by executing the script {$NEW_SONAR_HOME}/war/build-war
Start server (or deploy war on server):
Browse to http://localhost:9000/setup (replace "localhost:9000" by your own URL) and follow the setup instructions
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.