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.
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 'SONAR_HOME_PATH/war/build-war.sh' script (or 'SONAR_HOME_PATH/war/build-war.bat' on MS Windows)
- Deploy 'SONAR_HOME_PATH/war/sonar.war' in the application server
- Browse to and follow the setup instructions
- the SONAR_HOME_PATH directory cannot be removed
- the WAR file must be rebuilt when a configuration file is updated (directory 'SONAR_HOME_PATH/conf')
- there is no need to rebuild the WAR when installing/uninstalling plugins or rule extensions
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)
Note that after having upgraded Sonar, it is required to restart the web server.
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, generating the WAR and deploying it on different machines, etc.), you can override SONAR_HOME_PATH by setting the SONAR_HOME environment variable to the new path.
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.|