Install and Configure Sonar on Windows 2008 For .Net Part 1

CONFIGURE SONAR WITH VS2010

1. Download the "C# Plugins Ecosystem" 
   - Version 1.0 http://docs.codehaus.org/download/attachments/201228384/CSharpPluginsEcosystem-1.0-RC2.zip
   (Lastest version can be found on the top right here: http://docs.codehaus.org/display/SONAR/C-Sharp+Plugins+Ecosystem)
2. Extract to the plugins directory C:\Sonar\sonar-2.9\extensions\plugins

Rather than using Mavern it's much easier to to use the Java Runner to kick off Sonar.

1. Download the Java Runner: http://docs.codehaus.org/display/SONAR/Analyse+with+a+simple+Java+Runner#AnalysewithasimpleJavaRunner-Installation
2. Extract to dir i.e. c:\Sonar\sonar-runner-1.1
3. Modify C:\Sonar\sonar-runner-1.1\conf\sonar-runner.properties to enble the default site and Derby DB
   My modifed file looks like this:
   
   

    #----- Default directory layout  
    sources=src/main/java  
    tests=src/test/java  
    binaries=target/classes  
    sonar.sourceEncoding=UTF-8  
    #----- Default Sonar server  
    sonar.host.url=http://localhost:9000  
    #----- Global database settings  
    sonar.jdbc.username=sonar  
    sonar.jdbc.password=sonar  
   

4. Make sure you have the following environment varaibles:
   JAVA_HOME = C:\Program Files\Java\jdk1.6.0_23
   SONAR_RUNNER_HOME = C:\Sonar\sonar-runner-1.1
5. Add the sonar runner bin path to your PATH environment (for my install this is C:\Sonar\sonar-runner-1.1\bin)
6. There are two ways to tell Sonar where your .sln file is located
   a) You can create a sonar-project.properties file in the same directory as your solution file, Sonar will find it OR
   b) Create a sonar-project.properties file but use the sonar.dotnet.visualstudio.solution.file property to specify the path (this is my prefered option)
7. Create a file called "sonar-project.properties" as descrivbed in the above step (literally as it is don't replace project with your project name!) placing it 
   Here's my sample properties file located on the root of my application:
   
   AppName
   ---->BuildTools
   ---->Lib
   ---->src
   --------->AppName.sln
   build.proj
   sonar-project.properties

8.    
    # Project identification  
    sonar.projectKey=DMG:AppName
    sonar.projectVersion=1.0-SNAPSHOT  
    sonar.projectName=AppName
      
    # Info required for Sonar  
    sources=.  
    sonar.language=cs  
      
    #Core C# Settings  
    sonar.dotnet.visualstudio.solution.file=\src\\AppName.sln  
      
    #Gendarme  
    sonar.gendarme.assemblies=\build\\DmgTech*.*  
    sonar.gendarme.mode=skip  
      
    # Gallio  
    sonar.gallio.mode=skip  
      
    # FXCop  
    sonar.fxcop.mode=skip  
      
    #StyleCop  
    sonar.stylecop.mode=skip  
      
   

9. To run Sonar-Runner against your project
   - Shell out to DOS
   - Change directory to the location of your "sonar-project.properties" file
   - Execute "sonar-runner"
10. View your reports at http://localhost:9000

• If you receive something like: Fail to connect to database: undefined method `getActiveRecordDialectCode' for nil
  Check the JDK version you are running
• If you receive a maintenance warning then try http://localhost:9000\setup
• View the logs \logs\sonar.log
• If you receive the following error make sure the path to Java is in the environment path (I had to put C:\Program Files\Java\jdk1.7.0\bin).  To test head to DOS and type java.