Lancement
Architecture
Avant de configurer Sonar, il faut comprendre son architecture, celle ci est disposée de quatre parties :
Sonar architecture
- Source Code : le code source à analyser.
- Analysers : les outils qui vont analyser les sources.
- Database : une base de données pour sauvegarder les résultats.
- Server : le serveur qui va permettre de naviguer et de consulter les résultats.
Configurer l'installation
Afin de pouvoir utiliser Sonar, il y a quelque pré-requis à respecter :
- Minimum de 500 Mb de ram pour le serveur
- Java : Oracle JDK 1.5 | 1.6 (1.7 non testé)
- Base de données :
- H2 (Livré avec)
- MS SQL Server
- MySQL > 5.X
- Oracle > 10G
- PostegreSQL
- Serveur d’application :
- Jetty 6 (Livré avec)
- Apache Tomcat
Par défaut Sonar est livré avec une base de données H2 et un serveur d'application Jetty 6 ce qui permet de le tester de façon simple et rapide. Par contre, il est grandement déconseillé d'utiliser cette configuration pour un Sonar en production.
Dans ce cas il faut modifier le fichier de configuration conf/sonar.properties qui est divisé en plusieurs parties.
La première concerne la configuration web de Sonar en mode standalone, celle-ci n'est prise en compte que si Sonar est exécuté en serveur propre donc et ne concerne pas l'intégration à un serveur d'application.
La deuxième partie concerne la base de données, un exemple existe pour chaque type de base de données, il suffit juste de modifier l'url et le port éventuellement.
Il faudra penser à créer l'utilisateur sonar dans la base de données afin qu'il puisse ajouter les différents projets. Il est d'ailleurs possible de modifier le nom et le mot de passe de l'utilisateur dans le fichier de configuration. Il est également possible de modifier le pool de connexion à la base de données pour Sonar.
La partie suivante concerne la configuration d'un éventuel proxy pour que Sonar puisse accéder à Internet afin de télécharger d'éventuels plugins.
Comment le lancer
Une fois la configuration effectuée, il existe trois façons de lancer Sonar qui sont les suivantes :
- Exécution basique : Pour chaque OS, on peut trouver un script de démarrage. Celui se trouve dans : bin\windows-X\StartSonar.bat pour Windows et bin/[OS]/sonar.sh pour les autres environnements.
- Installation comme un service Windows : Sonar peut être installé comme service Windows. Il suffit d'exécuter bin/windows-X/InstallNTService.bat pour l'installer puis il faut démarrer le service windows ainsi créé. Il est possible de supprimer le service grâce à la commande bin/windows-x86-32/UninstallNTService.bat.
- Intégration à un serveur d'application : Il suffit d'exécuter le script war/build-war.sh. Une fois le war généré, il suffit de prendre le fichier war créé et de le déployer dans le serveur d'application. Il faut se rappeler que Sonar nécessite 500Mo de mémoire, ainsi il faut penser à configurer la configuration du serveur d'application. (CATALINA_OPTS="-Xmx=512m" par exemple pour Tomcat)
Une fois que Sonar est lancé il est possible de l'utiliser directement en accédant à l'adresse que vous avez configuré.
L'interface se décomposera toujours en trois parties :
- Une barre de menu horizontal contenant un fil d'arianne
- Un menu contextuel vertical
- Vue principale en fonction d'où on se trouve
Vue principale de Sonar : liste des projets