Hacé ya bastante tiempo que no hablé de Sonar. He sido ocupado un poco recientemente descubriendo nuevos territorios (ver los posts Elasticidad del código, La calidad en el Cloud) y me retrasé en poner al día mi entorno Sonar. Por otra parte, hay una nueva versión 3.0 con un montón de novedades.

Así que sin más preámbulos, ha llegado el momento para una actualización de Sónar.

Que tengas en cuenta que esta es una actualización de todo nuestro entorno, no simplemente de una versión de Sonar, sino también de plugins desactualizados o para actualizar o añadir nuevos plugins. Para tener una idea de mi configuración Sonar, puedes ver este post Sonar – Notre environnement..

Vamos pues a empezar a ver:

1. Los plugins que queremos dejar: he probado unos plugins que necesitan una licencia que ha expirado. Voy a quitar esos plugins.
2. Los plugins que queremos actualizar, con nueva versión.
3. Los nuevos plugins que queremos instalar.

Update Center

Para ello, vamos a visitar el Update Center: login admin / admin en Sonar.

Luego ‘Configuration’ / ‘Update Center’…

y en esta pantalla podemos ver:

• Los plugins instalados.
• Los plugins no instalados.
• Los plugins para cuales una nueva version es disponible.
• Toda(s) nueva(s) versión(es) de Sonar disponible(s).

La pantalla siguiente muestra cuatro posibles actualizaciones de plugins, uno de los cuales (el plugin Views) es incompatible con la versión actual de Sonar y requerirá previamente un upgrade de Sonar.

Por lo tanto la actualización de mi entorno consistirá en:

1. Desinstalacion de los plugins obsoletos.
2. Upgrade de versión de plugins existentes.
3. Upgrade de versión Sonar.
4. Upgrage (post-upgrade Sonar) del plugin Views o añadido de nuevos plugins.

Supresión de plugins

Para suprimir un plugin existente, seleccionarlo desde la pestaña ‘Installed Plugins’ para ver aparecer su descripción y un botón ‘Uninstall’.

Puedes seleccionar varios plugins a desinstalar.
Es necesario arrancar de nuevo Sonar para actualizar el ‘Update Center’. En mi entorno, lo hago con un Stop / Start de Tomcat.

Bueno, olvidé hacer un backup de mi esquema Sonar en la base de datos Oracle. Aprovechemos que Tomcat está parado para hacerlo.

Backup del esquema Oracle de Sonar

Hago los dumps de esquema en línea de comandos, con un ‘export’ Oracle y los parametros siguientes:

• file : el fichero dump ;
• log : un log para comprobar que el log está correcto;
• userid : los parametros de la conexión a mi instancia Oracle: user/password@instance_Oracle (el nombre asignado a la base de datos Oracle).

Más sencillo no se puede.

Una vez el export terminado sin ‘warnings’, puedo ver los ficheros .dmp y .log creados en el directorio de backup donde he ejecutado el ‘EXP’.

Start de Tomcat y de vuelta en el Update Center : los plugins eliminados ya no aparecen más en la pestaña ‘Installed Plugins’.

Upgrade de plugins

La actualización de plugins sigue el mismo modo operativo que el anterior.

En la pestaña ‘Plugin Updates’, click en el botón de upgrade de versión para cada plugin que actualizar.

De nuevo, podemos actualizar diferentes versiones a la vez. Luego: Stop / Start de Tomcat para ver aparecer las nuevas versiones de plugins en el Update Center.

Excepto el plugin Views que requiere un upgrade de versión Sonar. Lo que vamos a hacer ahora.

Upgrade de versión Sonar

El procedimiento de actualización es sencillo y lógico, pero siempre voy a refrescar mi memoria con el manu manual de upgrade, para evitar olvidar algún paso.

Primero, descargar un zip de la versión Sonar 3.0 desde la pagina de download y extraerlo en un nuevo directorio: ‘C:\Soft\Sonar\sonar-3.0’ en mi entorno.

Luego recuperar los archivos específicos a nuestro entorno desde la versión anterior (2.13.1 en mi máquina) hacia la nueva versión:

1. Copiar los ficheros ‘sonar.properties’ (parametros de entorno) y ‘wrapper.conf’ desde ‘C:\Soft\Sonar\sonar-2.13.1\conf’ hacia ‘C:\Soft\Sonar\sonar-3.0\conf’.
2. Copiar los ficheros .jar de plugins instalados desde ‘C:\Soft\Sonar\sonar-2.13.1\extensions\plugins’ hacia ‘C:\Soft\Sonar\sonar-3.0\extensions\plugins’.
3. Copiar el driver ‘C:\Soft\Sonar\sonar-2.13.1\extensions\jdbc-driver\oracle\ojdbc6.jar’ hacia el directorio ‘C:\Soft\Sonar\sonar-3.0\extensions\jdbc-driver\oracle’ (según la base de datos que se utiliza).
4. Construir un nuevo fichero .war de instalación en Tomcat, para esta nueva versión Sonar. Para ello, ejecutar el fichero ‘C:\Soft\Sonar\sonar-3.0\war\build-war.bat’, que creará en el mismo directorio, el archivo ‘sonar.war’.

A continuación, voy a instalar este archivo ‘sonar.war’ en el servidor Tomcat.

Nota: es mejor poner al día su entorno con los plugins antes de instalar una nueva versión Sonar porque se recuperan los archivos .jar de estos plugins ya instalados (punto 2 anterior).

Una vez reiniciado Tomcat, se puede encontrar el siguiente mensaje en Sonar:

La primera vez, pensé que se me había olvidado algo. Es por eso que siempre me refiero al procedimiento de actualización: hay un punto final para actualizar la base de datos, desde la pagina ‘setup’ de Sonar. En mi entorno: http://localhost:8888/sonar/setup.

Upgrade (post-upgrade Sonar) / nuevos plugins

¿Te recuerdas que la última versión del plugin Views sólo funciona con la versión 3.0 de Sonar?. Ahora que se ha instalado, podemos realizar esta actualización.

Una vez más, tienes que iniciar una sesión de Administrator para acceder al Update Center y proceder en la pestaña ‘Plugin Updates’:

También, en la pestaña ‘Available Plugins’, voy a seleccionar nuevos plugins que añadir: ‘XML’, ‘Violation density’, ‘Sonar Tab Metrics’ por ejemplo.

El proceso es el mismo que antes: Stop / Start de Tomcat.

De vuelta en el Update Center, puedo comprobar ahora el upgrade del plugin Views y la instalación de los nuevos plugins.

Et voilà. Nos queda solamente lanzar un nuevo análisis de nuestros proyectos.

Hemos visto todos los casos posibles de actualización de nuestro entorno: plugins eliminados, actualizar / añadir plugins y actualizar la versión de Sonar.

Puedes adaptar este procedimiento a tu propio entorno. Recuerdate siempre consultar la guía de actualización y las ‘Release notes’ de la versión.

Que disfrutes de todas esas novedades.

Esta entrada está disponible también en Lire cet article en français y Read that post in english.