Sonar Upgrade

Cela faisait un moment que nous n’avions pas parlé de Sonar. J’ai été un peu occupé récemment à découvrir de nouveaux territoires (cf. les posts précédents Elasticité des applications, La qualité dans le Cloud) et j’ai donc pris du retard dans la mise-à-jour de de mon environnement Sonar. De surcroît, il y a une nouvelle version 3.0 avec un tas de nouveautés.

Donc et sans plus attendre, le moment est venu d’effectuer un upgrade Sonar.

Notez bien qu’il s’agit d’un upgrade de notre environnement complet, pas simplement d’une version Sonar mais également de plugins obsolètes ou à mettre à jour ou de plugins nouveaux à ajouter. Pour vous faire une idée de mon installation Sonar, vous pouvez vous reporter à ce post Sonar – Notre environnement.

Nous allons donc commencer par noter :

  1. Les plugins que l’on veut quitter: j’ai testé quelques plugins pour lesquels une licence est nécessaire et celle-ci est venue à expiration. Je vais donc retirer ces plugins.
  2. Les plugins que l’on veut upgrader, pour lesquels existe une nouvelle version.
  3. Les plugins nouveaux que l’on veut installer.

Update Center

Pour ce faire, nous allons aller visiter l’Update Center: login admin / admin dans Sonar.

Puis ‘Configuration’ / ‘Update Center’…

et dans cet écran, nous pouvons voir :

  • Les plugins installés.
  • Les plugins non installés et disponibles á l’installation.
  • Les plugins pour lesquels une nouvelle version est disponible.
  • Toute(s) nouvelle(s) version(s) de Sonar disponible(s).

L’écran ci-dessous montre que 4 updates possibles de plugins, dont l’un (le plugin Views) incompatible avec la version Sonar actuelle nécessitera au préalable un upgrade Sonar.

La mise à jour de mon environnement Sonar va donc consister en :

  1. Suppression de plugins obsolètes.
  2. Upgrade de version de plugins existants.
  3. Upgrade de version Sonar.
  4. Upgrage (post-upgrade Sonar) du plugin Views ou ajout de plugins existants.

Suppression de plugins

Afin de supprimer un plugin existant, il suffit de sélectionner celui-ci depuis l’onglet ‘Installed Plugins’ afin de voir apparaître sa description et un bouton ‘Uninstall’.

Vous pouvez sélectionner plusieurs plugins à désinstaller.

Il est nécessaire de redémarrer Sonar afin de mettre à jour l’Update Center. Dans notre environnement, cela passe par un Stop / Start de Tomcat.

Tiens, j’ai oublié de faire un backup de mon schéma Sonar en base de données. Profitons que Tomcat est arrêté pour ce faire.

Backup du schéma Oracle de Sonar

Je fais mes dumps de schéma en ligne de commandes, avec un export Oracle et les paramètres suivants :

  • file : le nom du fichier de dump ;
  • log : un fichier de log afin de vérifier que le dump est correct ;
  • userid : les paramètres de connexion à mon instance Oracle, pour le schéma à backuper. Donc sous la forme user/password@instance_Oracle (le nom assigné à la base de données Oracle).

On ne peut pas faire plus simple.

Une fois l’export terminés sans ‘warnings’, je peux voir les fichiers .dmp et .log créés dans le répertoire de backup où je me suis positionné afin de lancer la commande ‘EXP’.

Start de Tomcat et retour dans l’Update Center : les plugins supprimés n’apparaissent plus dans l’onglet ‘Installed Plugins’.

Upgrade de plugins

La mise à jour de versions de plugins va se jouer exactement selon le même mode opératoire que le précédent.

Depuis l’onglet ‘Plugin Updates’, cliquer sur le bouton d’upgrade de versions pour chaque plugin à updater.

Là encore, on peut mettre-à-jour plusieurs versions en une seule fois. Puis à nouveau Stop / Start du serveur Tomcat afin de voir apparaître les nouvelles versions de plugins dans l’Update Center.

Sauf pour le plugin Views qui nécessite un upgrade de version Sonar. Ce que nous allons donc faire maintenant.

Upgrade de version Sonar

La procédure d’upgrade est simple et logique, mais je vais systématiquement consulter le guide d’upgrade, car il est facile d’oublier un point.

Tout d’abord, récupérer un zip de la version Sonar 3.0 depuis la page de download et extraire celui-ci dans un nouveau répertoire: ‘C:\Soft\Sonar\sonar-3.0’, dans mon environnement.

Nous allons ensuite récupérer les différents fichiers spécifiques à notre environnement, depuis la version précédente (2.13.1 sur ma machine) vers la nouvelle version. Donc :

  1. Copier les fichiers ‘sonar.properties’ (de paramètres d’environnement) et ‘wrapper.conf’ depuis ‘C:\Soft\Sonar\sonar-2.13.1\conf’ vers ‘C:\Soft\Sonar\sonar-3.0\conf’.
  2. Copier les fichiers .jar des plugins installés dans notre actuel environnement Sonar depuis ‘C:\Soft\Sonar\sonar-2.13.1\extensions\plugins’ vers ‘C:\Soft\Sonar\sonar-3.0\extensions\plugins’.
  3. Copier le driver ‘C:\Soft\Sonar\sonar-2.13.1\extensions\jdbc-driver\oracle\ojdbc6.jar’ vers le répertoire ‘C:\Soft\Sonar\sonar-3.0\extensions\jdbc-driver\oracle’ (en fonction de la base de données que vous utilisez).
  4. Créer un nouveau fichier .war à installer sous Tomcat, pour cette nouvelle version Sonar. Pour cela, lancer le fichier ‘C:\Soft\Sonar\sonar-3.0\war\build-war.bat’, qui va créer dans ce même répertoire un fichier ‘sonar.war’.

Ensuite, je vais installer ce fichier ‘sonar.war’ sous Tomcat (en prenant soin de backuper au préalable le fichier ‘sonar.war’ existant).

Note: il est préfèrable de mettre à jour votre environnement avec la suppression ou l’update de plugins avant d’installer une nouvelle version Sonar puisque (point 2 ci-dessus) nous récupérons les fichiers .jar de ces plugins pour les copier dans le répertoire correspondant à la nouvelle version Sonar.

Une fois Tomcat relancé, je vais génèralement avoir le message suivant sous Sonar :

La première fois, j’ai pensé que je m’y étais mal pris ou que j’avais oublié quelque chose. C’est la raison pour laquelle je consulte systématiquement la procédure d’upgrade: il reste un dernier point qui consiste à mettre à jour la base de données, depuis la page ‘setup’ de Sonar. Dans mon environnement: http://localhost:8888/sonar/setup.

Upgrade (post-upgrade Sonar) / ajout de plugins existants

Vous vous rappelez que la dernière version du plugin (Views) ne fonctionne qu’avec la version 3.0 de Sonar. Celle-ci étant maintenant installée, nous pouvons donc effectuer cet upgrade.

A nouveau, il faut se connecter en admin pour accéder à l’Update Center et procéder à cet upgrade depuis l’onglet ‘Plugin Updates’ :

Je vais également aller dans l’onglet ‘Available Plugins’ et ajouter de nouveaux plugins, comme par exemple les plugins ‘XML’, ‘Violation density’, ‘Sonar Tab Metrics’ par exemple.

Le processus est le même qu’auparavant : Stop / Start de Tomcat.

De retour dans l’Update Center, je peux maintenant vérifier l’upgrade du plugin Views et l’installation des nouveaux plugins.

Et voilà. Il ne nous reste plus qu’à relancer une nouvelle analyse de nos projets.

Nous avons vu tous les cas possibles de mise-à-jour d’un environnement Sonar : suppression de plugins, update / ajout de plugins et upgrade de versions Sonar.

Vous pouvez adapter facilement ce mode opératoire en fonction de votre propre environnement. N’oubliez pas de toujours consulter le guide d’upgrade et les release notes.

Je vous laisse apprécier toutes ces nouveautés.

Ce article est également disponible en Leer este articulo en castellano et Read that post in english.

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *