Después de preparar el update de nuestra versión SonarQube en el post anterior acerca de los requisitos previos para la actualización, y de ver también cómo hacer una copia de seguridad de la base de datos Oracle (o al menos del esquema Sonar), veamos ahora cómo realizar esta actualización.
Recuerdate que siempre puedes consultar la documentación sobre este tema desde el sitio web SonarSource. Este procedimiento cambia muy raramente, pero te recomiendo que siempre te refieres a esta pagina, porque este artículo podría resultar obsoleta.
Además, nuestra proceso de actualización tratará de un SonarQube instalado en un servicio de Windows.
Hemos visto en el post anterior que hacemos el upgrade desde el Update Center de SonarQube. Estas son las operaciones que se necesitan, a la hora de realizar esta operación, para mi versión actual:
Upgrade de plugins
Podemos ver en la illustración anterior, una serie de operaciones que se realizarán con los plugins que tenemos instalados en nuestro entorno de análisis de código.
Desinstalación de plugins
Se realiza esta actualización de plugins en dos etapas, la primera para desinstalar los plugins que no quiero más o que no son compatibles con la nueva versión de SonarQube.
Tenemos que reiniciar SonarQube para actualizar el Update Center, con un Stop / Start del servicio Windows.
Upgrade / Instalación de plugins
Una vez arrancado de nuevo SonarQube, podemos ver en el Update Center que los plugins eliminados han desaparecidos de la pestaña ‘Installed Plugins’. También no se encuentran más en el directorio ‘..\extensions\plugins‘.
Ahora podemos actualizar los plugins en una segunda etapa …
… e instalar o nuevos plugins o nuevas versiones de plugins que hemos suprimidos en el paso anterior.
Luego, un nuevo Re-Start del servicio Windows, y volvemos al Update Center para comprobar que todas las operaciones de actualización de plugins se han realizados correctamente. También puedes descargar los plugins desde el sitio SonarSource y copiarlos en su carpeta, pero esto supone el conocimiento de las versiones correctas. Para eso el Update Center nos facilita el trabajo
Upgrade de SonarQube
Ya hemos tratado este tema en el post Sonar Upgrade, cuando Sonar todavía no se llamaba SonarQube. La única diferencia es que este artículo está relacionado con una instalación de Sonar en Tomcat mientras ahora tengo un servicio Windows SonarQube. Sin embargo, la arquitectura de nuestro entorno sigue siendo la misma, y por lo tanto los pasos de upgrade también. Así que voy a enumerarlos simplemente.
Desinstalar el actual servicio SonarQube
Primero tenemos que desinstalar la versión actual de nuestro servicio SonarQube. En una ventana DOS, voy en:
- el directorio ‘..\bin’ de la actual versión de SonarQube,
- y luego en el sub-directorio correspondiente a nuestro sistema operativo.
Es decir ‘sonar-3..5.1\bin\windows-x86-64’, en mi caso.
En esta carpeta, lanzamos el fichero ‘UninstallNTService.bat’.
Podemos ver en la figura siguiente, este comando en la ventana DOS y el mensaje indicando la supresión del servicio Windows de SonarQube.
Preparar la instalación de la nueva versión de SonarQube
Vamos a descargar esta nueva versión desde la pagina de download de SonarSource. Aprovechamos esta oportunidad para leer las Release Notes, nunca está mal.
Voy a hacer un unzip de de esta versión en una carpeta que le corresponde: ‘..\sonar-3,7.2’.
Luego, voy a copiar les ficheros de configuración, desde la versión actual:
- Copiar los ficheros ‘sonar.properties’ (parametros del entorno SonarQube) y ‘wrapper.conf’, de ‘..\sonar-3.5.1\conf’ en ‘..\sonar-3.7.2\conf’.
- Copiar el driver de base de datos Oracle ‘..\sonar-3.5.1\extensions\jdbc-driver\oracle\ojdbc6.jar’ en el directorio ‘..\sonar-3.7.2\extensions\jdbc-driver\oracle’ (según la base de datos que se utiliza, claro).
- Copiar los ficheros .jar de los plugins instalados en el entorno SonarQube actual ‘..\sonar-3.5.1\extensions\plugins’ hacia ‘..\sonar-3.7.2\extensions\plugins’.
Y si quieres instalar nuevos plugins, o si olvidaste instalar uno desde el Update Center, puedes hacerlo ahora.
Upgrade de SonarQube
Ahora que hemos configurado la nueva versión de SonarQube, podemos instalar el correspondiente servicio Windows. Para ello, nos colocamos en el directorio ‘bin’ de la nueva versión: ‘sonar-7.3.2\bin\windows-x86-64’, y lanzamos el archivo de instalación ‘InstallNTService.bat ‘.
Tienes que elegir entre un servicio 64 bits o 32 bits según la versión – 64-bits o 32-bits – de la JVM, es decir, de tu instalación Java.
Activamos el servicio Sonar para comprobar que la instalación se ha realizado correctamente. Si te encuentras con un mensaje de error, te sugiero compruebar que el usuario tiene los derechos para ejecutar el servicio de Windows.
Queda un punto final para actualizar la base de datos, desde la página ‘setup’ de SonarQube.
Click en el botón ‘Upgrade’.
Y luego, después de unos minutos, dependiendo del tamaño de tu repositorio SonarQube:
En el Update Center, podemos ver que nuestro entorno SonarQube es ahora ‘al día’.
Et voilà !
Nos vemos pronto para el próximo post, vamos a celebrar dos años de este blog Qualilogy.
Esta entrada está disponible también en Lire cet article en français y Read that post in english.