blob: fb80a8df2ddf55a0f85be5389249928fc7209b22 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
# SonarQube
Put your technical debt under control. For more information please see:
* Website [sonarqube.org][1]
* [Issue tracker][2]
* [Wiki][3]
## Sources
This Git repository is core platform. Plugins are hosted in SonarCommunity and SonarSource organisations.
### Checkout Sources
If you have never used Git before, you need to do some setup first. Run the following commands so that GIT knows your name and email.
git config --global user.name "Your Name"
git config --global user.email "your@email.com"
Setup line endings preferences:
# For Unix/Mac users
git config --global core.autocrlf input
git config --global core.safecrlf true
# For Windows users
git config --global core.autocrlf true
git config --global core.safecrlf true
Get sources by executing:
git clone https://github.com/SonarSource/sonar.git
Committers must configure their SSH key (see GitHub documentation for Windows and Mac) and clone repository:
git clone git@github.com:SonarSource/sonar.git
### Build
* Install JDK 6 or greater
* Install Maven 3.0.5 or greater
* Execute `mvn clean install`. To quickly build in development environment, the script `quick-build.sh` does not execute unit tests and compile GWT components for Firefox/Chrome only.
* ZIP file of application is generated in sonar-application/target/
### Edit Ruby Code
The development mode is used to edit Ruby on Rails code. The application is automatically reloaded when Ruby files are saved. It avoids restarting the server. Changes are reloaded on the fly. Execute one of the following commands from the sonar-server/ directory to start server:
# for embedded database
sonar-server/derby-start.sh
# or for other dbs
sonar-server/mysql-start.sh
sonar-server/postgresql-start.sh
Then Ruby code can be directly edited from sonar-server/src/main/webapp/WEB-INF/app.
### Debug Maven Analysis
Debug Maven analysis by executing `mvnDebug sonar:sonar`. Then attach your IDE to the remote process (the listening port is 8000).
Example in Intellij Idea : Run -> Edit configurations -> Add new configuration -> Remote -> port 8000.
### Profile Maven Analysis with JProfiler
Duplicate $MAVEN_HOME/bin/mvnDebug to mvnJProfiler and replace the property MAVEN_DEBUG_OPTS by:
MAVEN_DEBUG_OPTS="-Xint -agentlib:jprofilerti=port=8849 -Xbootclasspath/a:/path/to/jprofiler/bin/agent.jar"
Then start JProfiler -> Connect to an application on a remote computer
### Log All Server SQL Requests
Download log4jdbc4-1.2.jar from http://log4jdbc.googlecode.com/files/log4jdbc4-1.2.jar in $SONAR_HOME/war/sonar-server/WEB-INF/lib/log4jdbc4-1.2.jar, and edit conf/logback.xml:
<logger name="jdbc.sqltiming">
<level value="OFF"/>
<appender-ref ref="PROFILING_FILE"/>
</logger>
<logger name="jdbc.connection">
<level value="INFO"/>
<appender-ref ref="PROFILING_FILE"/>
</logger>
<logger name="jdbc.audit">
<level value="OFF"/>
<appender-ref ref="PROFILING_FILE"/>
</logger>
<logger name="jdbc.resultset">
<level value="OFF"/>
<appender-ref ref="PROFILING_FILE"/>
</logger>
<logger name="jdbc.sqlonly">
<level value="OFF"/>
<appender-ref ref="PROFILING_FILE"/>
</logger>
## License
Copyright 2008-2013 SonarSource.
Licensed under the GNU Lesser General Public License, Version 3.0: http://www.gnu.org/licenses/lgpl.txt
[1]: http://www.sonarqube.org/
[2]: http://jira.codehaus.org/browse/SONAR
[3]: http://docs.codehaus.org/display/SONAR
|
