Installer SonarQube sur Windows 10 n’est pas une sinécure, mais c’est faisable si l’on sait comment s’y prendre. Souvent, les plus gros problèmes viennent de dépendances manquantes ou de mauvaises configurations, notamment avec Java ou la base de données. Si vous avez essayé d’exécuter SonarQube et qu’il ne démarre pas, ou que le tableau de bord ne s’affiche pas, ces étapes devraient vous aider à résoudre le problème et à le faire fonctionner au moins localement. C’est un peu étrange, mais parfois, un simple redémarrage du serveur ou une double vérification des fichiers de configuration suffit à résoudre le problème. En général, il suffit de s’assurer que Java fonctionne correctement et que les informations de connexion à la base de données sont correctes. Une fois tout aligné, vous devriez pouvoir analyser le code pour détecter les problèmes de qualité et de sécurité. Voici comment procéder étape par étape, avec quelques conseils tirés de cas concrets.
Comment installer et réparer SonarQube sur Windows 10
Assurez-vous que Java est correctement installé et configuré
Si SonarQube ne démarre pas, vérifiez d’abord si Java est installé et correctement configuré. SonarQube nécessite généralement Java 11, mais vérifiez votre version dans la documentation de SonarQube.
- Téléchargez le dernier JDK depuis le site Web d’Oracle ou utilisez OpenJDK.
- Installez-le, puis ouvrez l’invite de commande et exécutez
java -version. Si vous voyez la bonne version de Java, c’est parfait. Sinon, revenez en arrière et définissez la variable d’environnement JAVA_HOME. Pour cela, faites un clic droit sur « Ce PC », choisissez « Propriétés », puis « Paramètres système avancés ». Sous « Variables d’environnement », ajoutez ou modifiez JAVA_HOME pour qu’il pointe vers votre dossier JDK (par exempleC:\Program Files\Java\jdk-11.0.x), puis ajoutez-le%JAVA_HOME%\binà votre variable Path.
Sur certaines machines, cela ne fonctionne pas immédiatement. Redémarrez donc l’invite de commande ou même votre PC si nécessaire. De cette façon, Java sera dans le chemin système et SonarQube pourra le trouver.
Télécharger et extraire SonarQube
Rendez-vous sur la page de téléchargement de SonarQube et choisissez l’édition souhaitée. Community est gratuite, mais si vous travaillez en entreprise, les versions payantes offrent davantage de fonctionnalités. Extrayez le fichier zip dans un emplacement du type C:\SonarQube. Pas de surprise, mais assurez-vous que le chemin d’accès au dossier ne comporte pas d’espaces ni de caractères étranges, sinon SonarQube risque de s’engorger.
Configurez correctement votre base de données
SonarQube n’inclut pas sa propre base de données ; vous aurez donc besoin d’une base de données comme PostgreSQL ou MySQL. Sur une configuration que j’ai effectuée, PostgreSQL était la plus simple. Créez une nouvelle base de données et un nouvel utilisateur ; par exemple :
CREATE DATABASE sonarqube; CREATE USER sonaruser WITH PASSWORD 'yourpassword'; GRANT ALL ON DATABASE sonarqube TO sonaruser;Ensuite, ouvrez C:\SonarQube\conf\sonar.properties et mettez à jour vos informations de connexion à la base de données :
sonar.jdbc.username=sonaruser sonar.jdbc.password=yourpassword sonar.jdbc.url=jdbc:postgresql://localhost/sonarqubeCette partie fait trébucher beaucoup de gens si vous oubliez de modifier le fichier ou si vous ne redémarrez pas le serveur après les modifications.
Démarrer le serveur SonarQube
Accédez au dossier bin dans le répertoire SonarQube extrait. Sous Windows, il s’agit probablement de C:\SonarQube\bin\windows-x86-64. Faites un clic droit sur StartSonar.bat et sélectionnez Exécuter en tant qu’administrateur.
Oui, vous pourriez voir apparaître des journaux ou une invite de commande. Ne paniquez pas si le système semble lent ou génère des erreurs. Cependant, si vous constatez des erreurs concernant Java ou la base de données, vérifiez les chemins et les configurations. Certains utilisateurs arrêtent simplement le processus et le redémarrent si le système se bloque. Sur certaines configurations, la première exécution échoue, mais les suivantes fonctionnent correctement après un redémarrage ou un nettoyage des fichiers temporaires.
Accédez au tableau de bord dans votre navigateur
Si le serveur démarre correctement, ouvrez http://localhost:9000 dans votre navigateur. L’écran de connexion devrait s’afficher avec les identifiants par défaut : admin/ admin. S’il ne se charge pas, vérifiez que le serveur est en cours d’exécution et que votre pare-feu ne bloque pas le port 9000.
Parfois, le simple redémarrage du serveur ou de votre PC fait la différence : Windows et SonarQube ne fonctionnent pas toujours correctement du premier coup.
Conseils supplémentaires pour le dépannage
Si SonarQube refuse de démarrer ou plante en cours de route, consultez les journaux stockés dans C:\SonarQube\logs. Recherchez les erreurs liées à Java, à la base de données ou à la mémoire. Sur certaines configurations, augmenter la taille du tas dans sonar.properties peut s’avérer utile :
# For example, add these lines at the end wrapper.java.opts=-Xmx4g -Xms512mEn pratique, certaines machines ont besoin d’un peu plus de mémoire. Si des erreurs de mémoire surviennent, augmentez-la. Assurez-vous également que Java n’exécute pas de versions conflictuelles, surtout si plusieurs JDK sont installés.
Résumé
- Installez Java 11+ et mettez à jour les variables d’environnement si nécessaire.
- Téléchargez et configurez SonarQube en vous assurant que les chemins sont simples.
- Configurer une connexion à une base de données fonctionnelle.
- Démarrez le serveur, vérifiez les journaux si quelque chose ne va pas.
- Accédez au tableau de bord à l’adresse http://localhost:9000.
Conclure
Installer SonarQube en local n’est pas toujours simple, surtout avec Java et les bases de données. Mais une fois opérationnel, c’est un sérieux atout pour la qualité du code. L’essentiel est de vérifier les configurations, de surveiller les fichiers journaux et, parfois, de faire un redémarrage rapide. La première fois est difficile, mais ensuite, ce n’est plus qu’une simple maintenance de routine. Espérons que cela vous évitera les mêmes frustrations rencontrées avec plusieurs configurations ; bien sûr, Windows adore rendre les choses un peu plus compliquées que nécessaire.