Alfresco, trayectoria de actualización para la versión Community

/ / Blog, Document Management
Instalando Alfresco 5.1.g paso a paso
Parnaso 2.0. Ni un día sin poesía

La versión Enterprise de Alfresco dispone de un mapa detallado de migración, que incorpora los caminos de actualización desde versiones 2.2.x hasta la más reciente 5.1.

Sin embargo, la versión Community no cuenta con este recurso de manera oficial. En este artículo os contamos nuestra experiencia actualizando una instalación desde 3.4.d hasta 5.1.f

Decidiendo el camino de actualización

De acuerdo a lo que muestra el gráfico para la versión Enterprise y a nuestra propia experiencia, la primera aproximación fue intentar el siguiente camino:

3.4.d > 4.2.f > 5.0.d > 5.1.f

Preparando la actualización

  • Realizamos una instalación limpia para cada una de las versiones de Alfresco descargando los instalables desde la wiki de Alfresco
  • Cada una de las instalaciones dispone de su propio sistema de ficheros alf_data y de su propia base de datos PostgreSQL
  • Se crea una base de datos PostgreSQL genérica sobre la que se ejecutarán las actualizaciones
  • Preparamos un cliente CMIS capaz de realizar comprobaciones para todas las versiones de Alfresco
  • Generamos una estructura inicial de carpetas y ficheros de 200 MB en la instalación de Alfresco 3.4.d

Ejecutando la actualización

Ejecutamos los siguientes pasos para cada actualización:

  • Realizar un backup de contenidos y base de datos en la versión inferior (p. e. 3.4.d)
  • Copiar los contenidos de alf_data/contentstore y alf_data/contentstore.deleted de la versión inferior (p. e. 3.4.d) a la versión superior (p. e. 4.2.c), eliminando los contenidos existentes
  • Eliminar los índices SOLR de la versión superior (p. e. 4.2.f)
  • Modificar la configuración de base de datos en el fichero alfresco-global.properties de la versión superior (p. e. 4.2.f) para que apunte a la base de datos PostgreSQL genérica
  • Lanzar el servidor de Alfresco de la versión superior (p. e. 4.2.f) para que actualice la base de datos
  • Lanzar las pruebas del cliente CMIS para la verificación de contenidos

Durante este proceso, identificamos un problema de actualización en la base de datos para la transición 3.4.d > 4.2.f. Dado que la base de datos había quedado corrupta, restauramos la versión anterior en la base de datos PostgreSQL genérica (3.4.d) e introdujimos como paso intermedio la versión 4.0.d. Para ello, reinstalamos la versión 4.2.f y realizamos una nueva instalación de 4.0.d.

Tras esta modificación, el proceso funcionó sin incidencias, por lo que el camino final quedó establecido como:

3.4.d > 4.0.d > 4.2.f > 5.0.d > 5.1.f

De esta manera, en algo más de 1 hora conseguimos llevar una instalación desde la versión 3.4.d (año 2010) hasta la versión 5.1.f (año 2016) de manera segura.

Conclusiones

  • Es necesario tener preparada una marcha atrás para cada paso (básicamente un backup de datos y configuración inicial)
  • Tener preparado un validador de contenido, preferiblemente que se ejecute de manera automática
  • Realizar pruebas en entornos locales antes de realizarlas en el entorno del cliente

El proceso de actualización en Alfresco se realiza de una manera rápida y segura, aunque siempre es conveniente contar con las herramientas adecuadas antes de comenzar el proceso.

Unidad de negocio, keensoft

4 Comments to “ Alfresco, trayectoria de actualización para la versión Community”

  1. Horacio Medina dice:

    Hola Angel

    Estoy en proceso de migración desde un 4.0.d.
    Una consulta, ¿Que te llevo a elegir la versión 5.1.f?
    Y una más ¿Esa es la versión estable o a hoy 03/06/2016 debería pensar en otra?
    Desde ya muchas gracias.
    Horacio

  2. Angel Borroy dice:

    Buenas Horacio,

    La versión más estable hoy en día es la 201605 GA (aka 5.1.g), que incluye el parche para ImageTragick (https://www.keensoft.es/instalando-alfresco-5-1-g-paso-a-paso/). Si vas a utilizar una 5.1, utiliza ésta.

    Desde la 4.0.d hasta la 5.1 ha habido muchas mejoras. Puedes ver el histórico de funcionalidades añadidas aquí: https://wiki.alfresco.com/wiki/Category:Release_Notes

    Lo cierto es que a partir de la 5, el producto ganó bastante estabilidad (con la introducción de Maven y la unificación del core de ECM), así que cualquier versión por encima de ésa debería ser más eficiente que la tuya.

    En cualquier caso, vas a tener que pasar por varias versiones intermedias hasta llegar a la 5.1, así que puedes probar cada una para ver si se adapta a tus necesidades.

    Algo que debes tener en cuenta es que a partir de la 4.2.d se discontinuó la SOAP API. Esto es, si tenías integraciones con Web Services, tendrás que cambiar al API CMIS o al API REST.

    Suerte

  3. Buenas Angel:

    Una pregunta, conservas la versión de la base de datos de la instalación en cada path, o migras un dump a la versión de postgresql actualizada del instalador ?

    Saludos.

    –C.

  4. Angel Borroy dice:

    Buenos días, César.

    No uso el instalador, el PostgreSQL está instalado en la máquina previamente. Así que uso nombres de esquema diferentes (p. e. alfresco42, alfresco51…) y así es más cómodo realizar los DUMPs y los RESTOREs.

    Como siempre, es únicamente una manera de proceder, con el instalador también puede realizarse un proceso similar.

    Saludos