SonarQube Update 7.6

De EjnTricks
Révision de 17 février 2019 à 18:20 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Cette mise à jour s'effectue sur le principe de l'installation décrite pour la version 4.4.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Download-icon.png Téléchargement

La version est téléchargée dans le répertoire /var/opt/sonarqube.

#sudo wget -O /var/opt/sonarqube/sonarqube-7.6.zip https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-7.6.zip


System-Install-icon.png Installation

Puis il faut décompresser l'archive dans la structure personnalisée sous /var/opt/sonarqube.

#sudo unzip /var/opt/sonarqube/sonarqube-7.6.zip -d /var/opt/sonarqube
#sudo mv /var/opt/sonarqube/sonarqube-7.6 /var/opt/sonarqube/7.6

Le fichier téléchargé peut être supprimé.

#sudo rm /var/opt/sonarqube/sonarqube-7.6.zip


Icon File Owner.png Propriétaire fichiers

L'installation a été réalisée avec le compte root. Il est préférable de donner la propriété au compte de service, soit sonar dans le cadre de cette installation.

#sudo chown -R sonar:sonar /var/opt/sonarqube/7.6


Icon ACL.png Sécurisation

Après avoir modifié le propriétaire des fichiers, il est conseillé de positionner des droits restrictifs afin que seul le propriétaire puisse accéder à ceux-ci.

#sudo chmod -R go-rwx /var/opt/sonarqube/7.6


Run-icon.png Script démarrage

La modifications dans le script de démarrage, fichier /var/opt/sonarqube/7.6/bin/linux-x86-64/sonar.sh, doit permettre de spécifier l'emplacement du fichier PID. Il est modifié ainsi.

# Location of the pid file.
#PIDDIR="."
PIDDIR="/run/sonarqube"

La création du répertoire est gérée lors du démarrage du service, comme décrit lors de l'installation du service.


Icon-log.png Fichiers log

Par défaut, les logs sont placés dans le répertoire logs de l’instance SonarQube :

  • /var/opt/sonarqube/7.6/logs/sonar.log
  • /var/opt/sonarqube/7.6/logs/access.log

La définition de ces emplacements se situe dans différentes configurations.

  • Fichier conf/wrapper.conf les écritures du wrapper dans les fichiers sonar.log
#********************************************************************
# Wrapper Logs
#********************************************************************

wrapper.console.format=PM
wrapper.console.loglevel=INFO
wrapper.logfile=../../logs/sonar.log
wrapper.logfile.format=M
wrapper.logfile.loglevel=INFO
  • Fichier conf/sonar.properties pour sonar.log et access.log
# Path to log files. Can be absolute or relative to installation directory.
# Default is <installation home>/logs
#sonar.path.logs=logs


Afin de centraliser les logs, les messages sont redirigés vers /var/log/sonarqube en mettant en place des liens symboliques. Ceci permet de ne pas modifier les fichiers de configurations, limitant les modifications lors des futures montées de version. Le répertoire /var/opt/sonarqube/7.6/logs existe déjà et sera supprimé. Du fait de cette organisation, utilisation d'un répertoire common, un répertoire /var/opt/sonarqube/common/logs sera créé lors du démarrage. Pour ce dernier, le lien est préalablement créé.

#sudo rm -rf /var/opt/sonarqube/7.6/logs
#sudo ln -s /var/log/sonarqube /var/opt/sonarqube/7.6/logs
#sudo chown -h sonar:sonar /var/opt/sonarqube/7.6/logs

Attention, contrairement aux précédentes versions, le répertoire logs n'était pas vide.


Icon-Configuration-Settings.png Paramétrages

Les fichiers de paramétrages n'ont pas été modifiés depuis la précédente version. Les fichiers externalisés sont alors repris.

#sudo rm -rf /var/opt/sonarqube/7.6/conf


Share-icon.png Fichiers communs

Les liens vers les fichiers communs sont mis en place.

#sudo rm -rf /var/opt/sonarqube/7.6/conf
#sudo ln -s /var/opt/sonarqube/common/conf /var/opt/sonarqube/7.6/conf
#sudo chown -h sonar:sonar /var/opt/sonarqube/7.6/conf
#sudo rm -rf /var/opt/sonarqube/7.6/data
#sudo ln -s /var/opt/sonarqube/common/data /var/opt/sonarqube/7.6/data
#sudo chown -h sonar:sonar /var/opt/sonarqube/7.6/data
#sudo rm -rf /var/opt/sonarqube/7.6/temp
#sudo ln -s /var/opt/sonarqube/common/temp /var/opt/sonarqube/7.6/temp
#sudo chown -h sonar:sonar /var/opt/sonarqube/7.6/temp


Plugin-icon.png Plugins

Il est nécessaire de recopier les plugins additionnels dans le répertoire extensions/plugins.


Run-icon.png Exécution

Lors de l'installation de SonarQube en service, un lien /var/opt/sonarqube/installed a été mis en place pour pointer sur la version à activer. Des liens ont également été mis en place depuis /var/opt/sonarqube/common vers /var/opt/sonarqube/installed. Ainsi, en modifiant le lien installed, ceux-ci seront automatiquement activés sans aucune modification nécessaire.

#sudo rm /var/opt/sonarqube/installed
#sudo ln -s /var/opt/sonarqube/7.6 /var/opt/sonarqube/installed
#sudo chown -h sonar:sonar /var/opt/sonarqube/installed

Il suffit de relancer le service pour la prise en compte de la mise à jour.

#sudo systemctl start sonarqube


Lock-icon.png Permissions compte base de données

Suite à l'installation, les droits d'accès du compte MySql ont été réduits. Afin de s'assurer qu'aucun problème n'aura lieu, les permissions sont temporairement augmentées pour la mise à jour, en cas de modification du schéma.

mysql> REVOKE ALL on sonar.* FROM 'sonar'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)

mysql> GRANT ALL ON sonar.* TO 'sonar'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)


Icon-database-process.png Mise à jour de la base

Une mise à jour de la base de données est nécessaire pour cette version, ce qui est indiqué dans la trace d'exécution, fichier /var/log/sonarqube/sonar.log.

################################################################################
      Database must be upgraded. Please backup database and browse /setup
################################################################################

Celle-ci se déclenche en accédant à l'URL http://SERVER/setup.

La page offre la possibilité de mettre à jour la base de données.


Il suffit de cliquer sur le bouton Upgrade. Une fenêtre d'attente est alors affichée. Une fois la mise à jour terminée, la page est rafraîchie sur la page d'accueil.


En fin de mise à jour, un message de succès est affiché.


Lock-icon.png Permissions compte base de données post install

Une fois l'installation terminée, les droits du compte sur la base de données sont diminués. Dans le cadre de cette mise à jour, cela n'était pas nécessaire. Les commandes suivantes sont exécutées.

mysql> REVOKE ALL on sonar.* FROM 'sonar'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)

mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON sonar.* TO 'sonar'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)


Viewer icon.png Voir Aussi

Upgrade Notes: https://docs.sonarqube.org/7.6/setup/upgrade-notes/