{"id":2295,"date":"2014-12-14T10:37:35","date_gmt":"2014-12-14T09:37:35","guid":{"rendered":"http:\/\/qualilogy.com\/fr\/?p=2295"},"modified":"2014-12-15T18:41:33","modified_gmt":"2014-12-15T17:41:33","slug":"upgrade-sonarqube","status":"publish","type":"post","link":"http:\/\/qualilogy.com\/fr\/upgrade-sonarqube\/","title":{"rendered":"Upgrade SonarQube"},"content":{"rendered":"

\"Upgrade<\/a>Cela fait un moment que\u00a0 je n\u2019ai pas mis \u00e0 jour mon environnement SonarQube. Un bon six mois, voire plus, puisque je suis encore en version 4.2 alors que la derni\u00e8re version disponible<\/a> est une 4.5.1 LTS (Long Term Support). Donc une version \u00e9minemment candidate \u00e0 installation.<\/p>\n

Cet article sur le blog de SonarSource d\u00e9crit les buts et objectifs d’une telle version : Walking the Tightrope: Balancing Agility and Stability<\/a>. La 4.5.1 ne propose pas uniquement des corrections mais \u00e9galement nombre d\u2019\u00e9volutions et de nouvelles features<\/a>.<\/p>\n

<\/p>\n

Ce n\u2019est pas le premier post que j\u2019\u00e9cris sur ce sujet, vous les retrouverez tous group\u00e9s sous cette partie SonarQube – Installation<\/a> de mon blog. Cet article sera donc plus concis, avec probablement des renvois nombreux en cas de besoin vers ces posts pr\u00e9c\u00e9dents et plus d\u00e9taill\u00e9s.<\/p>\n

Plan d\u2019actions<\/h2>\n

Je prends mon temps pour faire un upgrade (d\u00e9j\u00e0 que je n\u2019en fais pas si souvent), car il y a, sinon une proc\u00e9dure, du moins un plan \u00e0 suivre. En commen\u00e7ant par ce que j\u2019appelle les pr\u00e9-requis<\/a>.<\/p>\n

Je commence par regarder quels sont les nouveaut\u00e9s de la version SonarQube et surtout, surtout, surtout, je v\u00e9rifie la doc d’upgrade<\/a> parce que m\u00eame si je la connais quasiment par coeur, m\u00eame si je peux consulter sur mon blog un article d\u00e9crivant un upgrade ant\u00e9rieur, et bien ce processus peut varier quelque peu, et cela m’est d\u00e9j\u00e0 arriv\u00e9 de rencontrer une erreur pour ne pas avoir suivi avec attention ces pr\u00e9-requis. L’installation ou la mise-a-jour de SonarQube n’est pas automatique, ce n’est pas un click sur un ex\u00e9cutable pour impl\u00e9menter le software, il y a quelques \u00e9tapes manuelles.<\/p>\n

D’ailleurs ces notes d’upgrade en version 4.5<\/a> listent des impacts possibles sur mon environnement SonarQube, les diff\u00e9rents analyses et projets dans mon repository, leurs configurations, et surtout pour ce qui est de notre upgrade : les conflits \u00e9ventuels avec des plugins en version pr\u00e9c\u00e9dente. Je vois en particulier qu’il me faudra supprimer le plugin Technical Debt \u2013 vous savez, le plugin SQALE que j’utilise dans toutes mes analyses \u2013 avant de proc\u00e9der \u00e0 l’installation de cette nouvelle version de SonarQube.<\/p>\n

\"SonarQube<\/a><\/p>\n

L’Update Center m’offre \u00e9galement une vision globale et synth\u00e9tique des diff\u00e9rents plugins \u00e0 actualiser.<\/p>\n

\"SonarQube_Admin_Settings\"<\/a>Pour cela, dans SonarQube, je me logue en Admin, puis le menu Settings m\u2019am\u00e8ne \u00e0 la page de m\u00eame nom …<\/p>\n

\"SonarQube_MenuUpdateCenter\"<\/a>… dans laquelle je s\u00e9lectionne le menu Update Center (barre de menu gauche) pour arriver dans cette m\u00eame page ‘Update Center’, avec diff\u00e9rents onglets. Nous commen\u00e7ons d\u2019abord par l\u2019onglet \u2018System Updates\u2019 qui me permet de v\u00e9rifier que :<\/p>\n

    \n
  1. Je peux upgrader directement ma version install\u00e9e 4.2 en la derni\u00e8re version 4.5.1 sans passer par une version interm\u00e9diaire. Super !<\/li>\n
  2. La proc\u00e9dure d\u2019upgrade qui consiste en l\u2019upgrade pr\u00e9alable de certains plugins avant \u2026<\/li>\n
  3. \u2026 l\u2019installation de la version SonarQube 4.5.1<\/li>\n<\/ol>\n

    \"SonarQube<\/a><\/p>\n

    Mais auparavant, dernier pr\u00e9-requis : la sauvegarde de ma base de donn\u00e9es, ou plut\u00f4t du sch\u00e9ma (user) Sonar. Si vous avez Oracle comme moi, reportez vous \u00e0 la proc\u00e9dure pr\u00e9cise de backup<\/a>.<\/p>\n

    Upgrade de plugins (1)<\/h2>\n

    Je commence donc par mettre \u00e0 jour les plugins indiqu\u00e9s ci-dessus, en cliquant sur le bouton \u2018Upgrade\u2019 pour chacun d\u2019eux \u2026 pour voir s\u2019afficher un message d\u2019erreur :\u00a0 \"SonarQube_UpdatePlugin_ErrMsg1\"<\/a>Bon, \u00e7a se mord un peu la queue : l\u2019onglet \u2018System Updates\u2019 me dit d\u2019upgrader certains plugins avant d\u2019upgrader SonarQube, mais lorsque je tente de suivre ces indications, ce message m\u2019indique qu\u2019il faut d\u2019abord actualiser la version de SonarQube avant de proc\u00e9der ainsi.
    \nD\u2019ailleurs, c\u2019est ce qui est indiqu\u00e9 clairement dans l\u2019onglet \u2018Plugin Updates\u2019 :<\/p>\n

    \"SonarQube_UpdateCenter_PluginsUpdate\"<\/a><\/p>\n

    J\u2019ai tent\u00e9 de downloader une nouvelle version du plugin ‘Developer Cockpit’ dans le r\u00e9pertoire correspondant \u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\plugins\u2019 puis un restart du service Sonar, mais sans succ\u00e8s :<\/p>\n

    \"SonarQube_UpdatePlugin_ErrMsg2\"<\/a><\/p>\n

    Le log d\u2019erreur \u2018..\\Sonar\\sonarqube-4.5.1\\logs\\sonar.log\u2019 m\u2019indique clairement que je ne peux pas travailler avec cette version de plugin pour cette version de SonarQube. En fait, c’est la doc\u00a0d’upgrade en version 4.5<\/a> qu’il faut suivre, d’o\u00f9 encore une fois l’importance de toujours consulter celle-ci avant toute action. Je vais donc supprimer le plugin Technical Debt, le seul plugin deprecated dans mon environment, avant d’installer la nouvelle version de SonarQube.<\/p>\n

    Upgrade de SonarQube<\/h2>\n

    Les instructions d\u00e9taill\u00e9s se trouvent dans un post pr\u00e9c\u00e9dent Sonarqube Upgrade 4-0<\/a>. Donc je vais les lister succinctement, sauf si nous rencontrons quoi que ce soit de nouveau et diff\u00e9rent.<\/p>\n

      \n
    1. Arr\u00eat du service Sonar.<\/li>\n
    2. Backup (via zip) du r\u00e9pertoire actuel de SonarQube (\u2018..\\Sonar\\sonarqube-4.2\u2019), par s\u00e9curit\u00e9.<\/li>\n
    3. Download du fichier \u2018sonarqube-4.5.1.zip\u2019 depuis la page de download<\/a>.<\/li>\n
    4. Suppression du service Sonar existant, par le fichier \u2018..\\Sonar\\sonarqube-4.2\\bin\\windows-x86-64\\UninstallNTService.bat\u2019. Evidemment, choisissez le r\u00e9pertoire correspondant \u00e0 votre syst\u00e8me d\u2019exploitation (Windows 7 64 bits en ce qui me concerne).<\/li>\n
    5. Copie des plugins de la version pr\u00e9c\u00e9dente vers la version nouvelle, donc depuis \u2018..\\Sonar\\sonarqube-4.2\\extensions\\plugins\u2019 vers \u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\plugins\u2019.
      \nAttention<\/strong> : pour cette installation particuli\u00e8re en version 4.5.1, je ne vais pas recopier le plugin Technical Debt, puisque celui-ci est deprecated et doit \u00eatre supprim\u00e9 du r\u00e9pertoire de plugins, comme indiqu\u00e9 pr\u00e9c\u00e9demment.<\/li>\n
    6. Copie du driver de base de donn\u00e9es Oracle \u2018ojdbc6.jar\u2019 vers son nouveau r\u00e9pertoire \u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\\\jdbc-driver\\oracle\u2019 (puisque j\u2019utilise une base de donn\u00e9es Oracle).<\/li>\n
    7. Comme indiqu\u00e9 sur la page d’upgrade SonarSource<\/a>, nous reprenons les caract\u00e9ristiques propres \u00e0 notre installation pour mettre \u00e0 jour le fichier \u2018..\\Sonar\\sonarqube-4.5.1\\conf\\sonar.properties\u2019 avec l\u2019adresse de ma base de donn\u00e9es Oracle. On pourrait faire de m\u00eame avec le fichier \u2018wrapper.conf\u2019, mais je pr\u00e9f\u00e8re commencer avec la version par d\u00e9faut, et \u00e9ventuellement envisager certains ajustements en cas de probl\u00e8me.<\/li>\n<\/ol>\n

      Les modifications dans le fichier \u2018sonar.properties\u2019 sont donc classiquement les suivantes :<\/p>\n