SonarQube installeren op Windows 10 is niet bepaald een fluitje van een cent, maar het is wel te doen als je weet waar je op moet letten. Vaak komen de grootste problemen voort uit ontbrekende afhankelijkheden of verkeerde configuraties, vooral met Java of de database. Als je SonarQube hebt geprobeerd te draaien en het start gewoon niet op, of het dashboard wordt niet weergegeven, zouden deze stappen voldoende moeten zijn om het probleem op te lossen en het lokaal te laten werken. Het is een beetje vreemd, maar soms is het probleem al opgelost door de server opnieuw op te starten of je configuratiebestanden nogmaals te controleren. Meestal draait het erom ervoor te zorgen dat Java soepel werkt en dat de databaseverbindingsinformatie klopt. Zodra alles op elkaar is afgestemd, zou je de code moeten kunnen analyseren op kwaliteits- en beveiligingsproblemen. Hier lees je hoe je het stap voor stap doet, met een paar tips gebaseerd op praktische problemen.
SonarQube installeren en repareren op Windows 10
Zorg ervoor dat Java correct is geïnstalleerd en ingesteld
Als SonarQube niet start, controleer dan eerst of Java geïnstalleerd en correct geconfigureerd is. SonarQube vereist doorgaans Java 11, maar controleer uw versie aan de hand van de SonarQube-documentatie.
- Download de nieuwste JDK van de website van Oracle of gebruik OpenJDK.
- Installeer het, open de opdrachtprompt en voer het uit
java -version. Als u de juiste Java-versie ziet, is dat prima. Zo niet, ga dan terug en stel de omgevingsvariabele JAVA_HOME in. Klik hiervoor met de rechtermuisknop op Deze pc, kies Eigenschappen en vervolgens Geavanceerde systeeminstellingen. Voeg onder Omgevingsvariabelen JAVA_HOME toe of bewerk het zodat het verwijst naar uw JDK-map (zoalsC:\Program Files\Java\jdk-11.0.x), en voeg het toe%JAVA_HOME%\binaan uw Path- variabele.
Op sommige machines werkt dit niet meteen. Start daarom de opdrachtprompt of indien nodig zelfs je pc opnieuw op. Zo kunnen Java’s in het systeempad worden gevonden en kan SonarQube deze vinden.
SonarQube downloaden en uitpakken
Ga naar de SonarQube-downloadpagina en download de gewenste versie. Community is gratis, maar als je zakelijke toepassingen gebruikt, bieden de betaalde versies meer functies. Pak de zip uit in bijvoorbeeld C:\SonarQube. Geen verrassingen, maar zorg ervoor dat het pad naar de map geen spaties of vreemde tekens bevat, anders kan SonarQube vastlopen.
Configureer uw database correct
SonarQube heeft geen eigen database, dus je hebt er een nodig zoals PostgreSQL of MySQL. In een configuratie die ik gebruikte, was PostgreSQL het makkelijkst. Maak een nieuwe database en gebruiker aan; bijvoorbeeld:
CREATE DATABASE sonarqube; CREATE USER sonaruser WITH PASSWORD 'yourpassword'; GRANT ALL ON DATABASE sonarqube TO sonaruser;Open vervolgens C:\SonarQube\conf\sonar.properties en werk de verbindingsgegevens van uw database bij:
sonar.jdbc.username=sonaruser sonar.jdbc.password=yourpassword sonar.jdbc.url=jdbc:postgresql://localhost/sonarqubeDit onderdeel kan voor veel problemen zorgen als je vergeet het bestand aan te passen of de server niet opnieuw opstart na de wijzigingen.
Start de SonarQube-server
Navigeer naar de map ‘bin’ in de uitgepakte SonarQube-map. Voor Windows is dit waarschijnlijk C:\SonarQube\bin\windows-x86-64. Klik met de rechtermuisknop op StartSonar.bat en kies ‘ Als administrator uitvoeren’.
Ja, je ziet mogelijk een flits van logs of een opdrachtprompt verschijnen. Raak niet in paniek als het traag lijkt of fouten geeft, maar ALS je fouten ziet over Java of de database, controleer dan de paden en configuraties. Sommige mensen stoppen het proces gewoon en starten het opnieuw op als alles vastloopt. Bij sommige installaties mislukt de eerste run, maar werken de volgende prima na een herstart of het opschonen van tijdelijke bestanden.
Toegang tot het dashboard in uw browser
Als de server goed start, open dan http://localhost:9000 in je favoriete browser. Je zou het inlogscherm moeten zien met de standaardreferenties: admin/ admin. Als het niet laadt, controleer dan of de server actief is en of je firewall poort 9000 niet blokkeert.
Soms is het al voldoende om de server of uw pc opnieuw op te starten. Windows en SonarQube werken niet altijd even goed bij de eerste poging.
Extra tips voor probleemoplossing
Als SonarQube niet opstart of halverwege crasht, controleer dan de logs in C:\SonarQube\logs. Zoek naar fouten met betrekking tot Java, de database of het geheugen. In sommige configuraties kan het helpen om de heapgrootte in sonar.properties te vergroten:
# For example, add these lines at the end wrapper.java.opts=-Xmx4g -Xms512mIn de praktijk hebben sommige machines wat meer heap nodig. Als er geheugenfouten optreden, verhoog die dan. Zorg er ook voor dat Java geen conflicterende versies draait, vooral als je meerdere JDK’s hebt geïnstalleerd.
Samenvatting
- Installeer Java 11+ en werk indien nodig de omgevingsvariabelen bij.
- Download en installeer SonarQube en zorg ervoor dat de paden eenvoudig zijn.
- Configureer een werkende databaseverbinding.
- Start de server en controleer de logs om te zien of er iets misgaat.
- Ga naar het dashboard op http://localhost:9000.
Afronding
SonarQube lokaal aan de praat krijgen is niet altijd even eenvoudig, vooral niet met Java en databases. Maar als het eenmaal werkt, is het een flinke boost voor de codekwaliteit. De sleutel is het dubbel controleren van configuraties, het bekijken van logbestanden en soms een snelle herstart. De eerste keer is het lastig, maar daarna is het gewoon routineonderhoud. Hopelijk voorkomt dit dezelfde frustraties die je ervaart bij meerdere installaties – Windows maakt het natuurlijk graag net iets moeilijker dan nodig is.