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 8 Next >>

Sonar can be packaged as a WAR then deployed in an existing JEE server. Note that you must already know how to deploy a web application in the server of your choice. Check the Requirements page to get the list of the supported servers.

Quick Installation

The SONAR_HOME_PATH will refer below to the path to the directory where the Sonar distribution has been unzipped.

Installation steps are:

  • Edit 'SONAR_HOME_PATH/conf/sonar.properties' as described in standalone mode (Note that 'SONAR_HOME_PATH/conf/wrapper.conf' is never used when deploying in application server).
  • Execute the script 'SONAR_HOME_PATH/war/build-war.sh' (or 'SONAR_HOME_PATH/war/build-war.bat' on MS Windows)
  • Deploy 'SONAR_HOME_PATH/war/sonar.war' in the application server
  • Browse to http://localhost/sonar and follow the setup instructions

Note that:

  • the SONAR_HOME_PATH directory cannot be removed
  • there is no need to rebuild the WAR when installing/uninstalling plugins or rule extensions

  • the WAR file must be rebuilt when a configuration file is updated (directory 'SONAR_HOME_PATH/conf')

  • the user who runs Tomcat must have read & write access to the SONAR_HOME_DIR directory (to allow plugin installation from the Web admin console for instance)

Advanced Usage

Moving the Sonar Distribution or Deploying in Another Machine

If for any reason, the SONAR_HOME_PATH has to change (moving the Sonar distribution into another directory, deploying on a different machine, etc.), you can override this path by setting the SONAR_HOME environment variable.

Injecting Environment Variables

You can inject environment variables in the 'sonar.properties' file with the following syntax.

For instance, to inject the JDBC connection string:

This can be quite valuable to better handle production environments.

Increasing Memory Heap Size on Tomcat

A minimum heap size of 512Mb is required. To increase the memory heap size on Tomcat, set the CATALINA_OPTS variable before starting Tomcat:

 

 

See also this blog.
Labels
  • None