{"id":1348,"date":"2014-12-15T16:19:36","date_gmt":"2014-12-15T15:19:36","guid":{"rendered":"http:\/\/qualilogy.com\/en\/?p=1348"},"modified":"2014-12-15T18:22:24","modified_gmt":"2014-12-15T17:22:24","slug":"sonarqube-upgrade","status":"publish","type":"post","link":"http:\/\/qualilogy.com\/en\/sonarqube-upgrade\/","title":{"rendered":"SonarQube upgrade"},"content":{"rendered":"

\"Upgrade<\/a>It’s been a long time since I updated my SonarQube environment. Six months or more, I’m still in version 4.2, while the latest version is a 4.5.1 LTS (Long Term Support). Therefore a good candidate for installation.<\/p>\n

This article Walking the Tightrope: Balancing Agility and Stability<\/a>\u00a0on the blog SonarSource describes the aims and objectives of such a version.\u00a0This 4.5.1 release not only offers corrections but also\u00a0many changes and new features<\/a>.<\/p>\n

This is not the first post I write about a SonarQube upgrade, you will find them all together under this part SonarQube – Installation<\/a> on my blog. This article will be more concise, with referrals to these previous and detailed posts, when needed. <\/p>\n

Action plans<\/h2>\n

I take my time to do an upgrade (especially that I don’t do that so often) because there is, if not a procedure, but at least a plan to follow. Starting with what I call the prerequisites<\/a>.<\/p>\n

I start by looking at what’s new and, above all, I check the upgrade documentation<\/a> because even if I know it well, even if I can refer to a previous article on my blog, this process may vary and it did happen that I get an error for not following carefully these requirements. The installation or the update of SonarQube is not automatic, it is not a click on an executable to implement the software, there are some manual steps.<\/p>\n

Besides these Upgrade Notes for version 4.5<\/a> list possible impacts on my SonarQube environment, the different analysis and projects in my repository, their configurations, and especially the potential conflicts with previous versions of\u00a0plugins. For instance, I can see that I must remove the Technical Debt plugin \u2013 you know, the SQALE plugin that I use in all my tests \u2013 prior to installing this new version of SonarQube.<\/p>\n

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

The SonarQube Update Center also gives me a global overview of the various plugins to update.<\/p>\n

\"SonarQube_Admin_Settings\"<\/a>In order to acces it, I log as an Admin, and then the ‘Settings’ menu brings me to the page with the same name, \"SonarQube_MenuUpdateCenter\"<\/a>in which I select the ‘Update Center’ menu (in the left menu bar) to go into in the same page ‘Update Center’ with different tabs. We first start with the tab ‘System Updates’ which allows me to check that:<\/p>\n

    \n
  1. I can directly upgrade my installed version 4.2 to the latest version 4.5.1 without going through an intermediate version. Great!<\/li>\n
  2. The upgrade procedure consists in a prior upgrade of some plugins before …<\/li>\n
  3. … Installing the SonarQube 4.5.1 release.<\/li>\n<\/ol>\n

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

    But first, the last pre-requisite: a backup of the Oracle user (schema) Sonar. I did describe previously the complete procedure<\/a>.<\/p>\n

    Plugins upgrade (1)<\/h2>\n

    I begin by updating the plugins listed above by clicking on the ‘Upgrade’ for each of them … and get an error message:
    \n    \"SonarQube_UpdatePlugin_ErrMsg1\"<\/a>Well, it’s like the dog chasing it’s tail: the tab ‘System Updates’ told me to upgrade some plugins before a SonarQube upgrade, but when I try to follow these instructions, this message indicates to me that we must first update the version of SonarQube before updating the plugins.
    \nMoreover, this is what is clearly indicated in the tab ‘Plugin Updates’:<\/p>\n

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

    I tried to download and install a new version of the ‘Developer Cockpit’ plugin in the corresponding directory\u00a0\u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\plugins\u2019, then a Restart of the Sonar service, but unsuccessfully:<\/p>\n

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

    The log \u2018..\\Sonar\\sonarqube-4.5.1\\logs\\sonar.log\u2019 clearly tells me that I can not work with this version of this plugin for this version of SonarQube. In fact, this is the Upgrade Notes to version 4.5 that must be followed, so once again: always consult it before any action. I’ll remove the Technical Debt plugin, the only one deprecated in my environment (according to these notes), before installing the new version of SonarQube.<\/p>\n

    SonarQube upgrade<\/h2>\n

    Detailed instructions can be found in a previous post SonarQube Upgrade 4-0<\/a>. So I’ll list them briefly, unless we find anything new and different.<\/p>\n

      \n
    1. Stop the current (4.2) Sonar service.<\/li>\n
    2. Backup of the current SonarQube directory (\u2018..\\Sonar\\sonarqube-4.2\u2019), for safety.<\/li>\n
    3. Download of the \u2018sonarqube-4.5.1.zip\u2019 file from the Download page<\/a>.<\/li>\n
    4. Delete of the existing Sonar service with the file \u2018..\\Sonar\\sonarqube-4.2\\bin\\windows-x86-64\\UninstallNTService.bat\u2019. Obviously, choose the directory for your operating system (Windows 7 64-bit for me).<\/li>\n
    5. Copy of the plugins from the previous version to the new version, so from \u2018..\\Sonar\\sonarqube-4.2\\extensions\\plugins\u2019 to \u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\plugins\u2019.
      \nNote<\/strong>: for this particular installation of the 4.5.1 release, I will not copy the plugin Technical Debt, since it is deprecated and should be removed from the plugins directory, as described above.<\/li>\n
    6. Copy of the Oracle driver \u2018ojdbc6.jar\u2019 to the new directory \u2018..\\Sonar\\sonarqube-4.5.1\\extensions\\\\jdbc-driver\\oracle\u2019.<\/li>\n
    7. As indicated on the SonarSource upgrade page<\/a>, I update the configuration file \u2018..\\Sonar\\sonarqube-4.5.1\\conf\\sonar.properties\u2019 with the characteristics of my environment, principally the address of my Oracle database. We could do the same with the file\u00a0\u2018wrapper.conf\u2019 (for the JVM configuration), but I prefer to start with the default configuration and possibly consider some adjustments in case of problems.<\/li>\n<\/ol>\n

      Changes in the file ‘sonar.properties’ are typically as follows:<\/p>\n