En esta entrada voy a explicaros los pasos que debéis seguir para llevar a cabo la actualización de SonarQube Community Edition a la versión 7.9.3 LTS.
Introducción
Para aquellos que no conozcáis las aplicación os diré que se trata de una plataforma desarrollada en Java que nos permitirá realizar análisis de código con diferentes herramientas de forma automatizada. Con la ayuda de esta aplicación nos será fácil mantener un cierto nivel de calidad en nuestros códigos fuentes.
Consideraciones previas
Antes de explicaros los pasos a seguir para llevar a cabo el proceso de actualización de nuestro servidor os diré que existen 2 versiones de SonarQube, las versiones LTS y las no LTS. Esto es importante que lo conozcáis ya que en caso de tener que realizar una actualización en la que haya versiones LTS intermedias previamente deberemos ir pasando por cada de estas versiones LTS antes de llegar a nuestro objetivo final. Os pongo un ejemplo para que lo entendáis mejor.
Imaginaros que nos encontramos en la versión 6.5 y queremos actualizar a la versión 7.9.3 LTS, el mapa de actualización que deberíamos seguir sería el siguiente: de la versión 6.5 tendremos que realizar una primera actualización a la versión 6.7.7 LTS, una vez nos encontremos en esta versión entonces podremos actualizar a la versión 7.9.3 LTS, es decir, primero tendremos que ir actualizando hacia las versiones LTS intermedias (en caso que existan) antes de llegar a la versión final que necesitemos.
Una vez aclarado este punto voy a explicaros los pasos que debéis seguir para poder actualizar SonarQube a la versión 7.9.3 LTS.
Nota: Esta guía se ha realizado en una instancia de SonarQube sobre la plataforma Windows por lo que en caso de que la tengáis sobre Linux los pasos pueden diferir aunque como guía debería serviros.
Pasos a seguir
En primer lugar tendremos que realizar un inventario de los plugins que tengamos instalados (si los tenemos).
La versión 7.9.3 LTS de SonarQube requiere la versión JDK 11 de Java por lo que tendremos que descargarla de la página oficial e instalarla en nuestro servidor.
Una vez instalado Java nos iremos a la página oficial de SonarQube para descargarnos la versión 7.9 LTS.
A continuación descomprimiremos el .zip en una nueva carpeta del servidor de SonarQube.
Paramos el servicio de SonarQube yéndonos a la carpeta_instalación_version_antigua_sonarqube/bin/windows-x86-64 y ejecutando el fichero StopNTService.bat.
Una vez parado el servicio es muy importante que realicéis un backup de la base de datos de SonarQube. No voy a explicaros como realizarlo ya que los pasos a dar dependerán de si la tenéis montado sobre SQL Server, Oracle, etc… y deberéis actuar como si hicieras un backup de una base de datos cualquier, no hay diferencias.
Continuamos desinstalando el servicio de SonarQube. Para ello ejecutaremos el fichero UninstallNTService.bat que podremos encontrar en la ruta anterior.
Ahora tendremos que traspasar, de forma manual, la configuración (cadenas conexión base de datos, puertos, etc…) que tenemos en los ficheros sonar.properties y wrapper.conf de nuestra instancia actual a estos mismos ficheros que encontraremos en la carpeta que hemos descomprimido con la nueva versión. Estos ficheros podéis encontrarlo, en ambas carpetas, en la ruta carpeta_sonarqube/conf.
Es muy importante que hagáis el traspaso de configuración de forma manual y no copiando y pegando los ficheros ya que en la nueva versión hay parámetros que no existen en versiones anteriores y si machacamos los ficheros seguramente la nueva versión no funcione como debería.
Nota: Os recomiendo utilizar la aplicación gratuita Notepad++ junto con el plugin compare el cual os será de gran utilidad para traspasar la configuración de forma rápida y sin errores.
Una vez traspasada la configuración tendremos que instalar el servicio de SonarQube de la versión 7.9 LTS. Para ello nos iremos a la siguiente ruta carpeta_instalación_nueva_version_sonarqube/bin/windows-x86-64 y ejecutaremos el fichero InstallNTService.bat.
Iniciamos el servicio ejecutando el fichero StartNTService.bat.
Por último visitamos la web http://yourserver/setup para que se inicie el proceso de migración de la base de datos de SonarQube y se inicie nuestra nueva instancia.
Por último reinstalaremos/actualizaremos los plugins que tuvieramos.
Y listo con estos sencillos pasos ya tendremos nuestro servidor de SonarQube en la versión 7.9.3 LTS.
Espero os sea de utilidad.
Me dedico a la Administración de Sistemas y he creado este blog para compartir mis conocimientos con toda la comunidad y así aportar mi granito de arena y ayudar a todo el que lo necesite.