Nuestro camino desde Alfresco CE 4.2.c hasta Alfresco CE 5.0.c

/ / Blog, Document Management
alfresco-singleupgrade
La participación de keensoft en "Alfresco Tech Talk Live 82: Upgrading to Alfresco 5.0"
alfresco-myfiles-quota: nuevo addon para Alfresco disponible

Alfresco 5.0.c

La liberación de la versión 5.0.c de Alfresco Community, primera de la rama 5 que se considera adecuada para uso en entornos semi-productivos, nos a animado a actualizar nuestro servidor corporativo de gestión documental. A continuación os mostramos cómo ha sido nuestro proceso de actualización de versión.

Situación inicial

  • Disponíamos de una instalación de Alfresco CE 4.2.c sobre PostgreSQL 9.1 corriendo en un servidor Ubuntu 14
  • El tamaño del repositorio era de 15 Gb y albergaba cerca de 60.000 documentos
  • La autenticación estaba integrada con nuestro LDAP corporativo
  • Disponíamos de diferentes módulos AMP de personalización
  • Existía un proceso de backup personalizado

Planificación de la migración

Para garantizar una migración exitosa, a pesar de nuestra experiencia en este tipo de operaciones, revisamos previamente el flujo de trabajo propuesto por Alfresco para la realización de estas operaciones:

  • Validar requisitos previos
  • Realizar una copia de seguridad de Alfresco 4.2.c (sistema de ficheros y base de datos)
  • Realizar una instalación limpia de Alfresco 5.0.c
  • Verificar la instalación limpia de Alfresco 5.0.c
  • Aplicar los cambios de configuración y los módulos AMP
  • Restaurar la copia de seguridad de Alfresco 4.2.c en la instalación limpia de Alfresco 5.0.c
alfresco singleupgrade

Stages for upgrading Alfresco (from docs.alfresco.com)

Ejecución del proceso

Nota. Los pasos que incluimos a continuación pueden no ser adecuados para vuestro entorno, los incluimos como referencia para vuestros propios procesos.

# Parar Alfresco
$ service alfresco stop
# Realizar una copia de seguridad de Alfresco 4.2.c
$ mv alfresco alfresco-old
$ pg_dump alfresco > alfresco-4.2.c.sql

# Realizar una instalación limpia de Alfresco 5.0.c
$ wget http://dl.alfresco.com/release/community/5.0.c-build-00145/alfresco-community-5.0.c-installer-linux-x64.bin
$ chmod +x alfresco-community-5.0.c-installer-linux-x64.bin
$ ./alfresco-community-5.0.c-installer-linux-x64.bin
Launch Alfresco Community Share [Y/n]: Y

# Aplicar la configuración previa (LDAP, alfresco-global.properties, AMPs...)
$ service alfresco stop
$ mkdir -p /opt/alfresco/tomcat/shared/classes/alfresco/extension/subsystems/Authentication/ldap-ad/ldap-ad1
$ cp /opt/alfresco-old/tomcat/shared/classes/alfresco/extension/subsystems/Authentication/ldap-ad/ldap-ad1/*
\ /opt/alfresco/tomcat/shared/classes/alfresco/extension/subsystems/Authentication/ldap-ad/ldap-ad1
$ ...

# Restaurar la copia de seguridad de Alfresco 4.2.c
$ rm -rf /opt/alfresco/alf_data/contentstore
$ rm -rf /opt/alfresco/alf_data/contentstore.deleted
$ rm -rf /opt/alfresco/alf_data/solr4/*/*
$ cp -r /opt/alfresco-old/alf_data/contentstore /opt/alfresco/alf_data
$ cp -r /opt/alfresco-old/alf_data/contentstore.deleted /opt/alfresco/alf_data
$ psql alfresco < alfresco-4.2.c.sql

# Arrancar alfresco 5.0.c
$ service alfresco start

Ahora ya disponemos de nuestra nueva versión, lo que nos permite sacar partido de sus nuevas funcionalidades (previsualización HTML 5, búsquedas facetadas…) para gestionar nuestros documentos de una manera más eficiente (y agradable).

Los procesos de actualización entre versiones de Alfresco deben realizarse de acuerdo a las especificaciones del propio Alfresco. Y si no estamos seguros, lo más recomendable es contar con la ayuda de un experto y ensayarlos previamente en entornos de prueba.

Unidad de negocio, keensoft

13 Comments to “ Nuestro camino desde Alfresco CE 4.2.c hasta Alfresco CE 5.0.c”

  1. Lo siento por mi español malo. Gracias por el artículo muy útil.

    No aparece que su copia de seguridad contiene los índices de Solr de su instalación de 4.2. La migración para 5.0.c requiere criando los índices de nuevo, pero la sistema permitirá mas funcionalidad de búsqueda antes del proceso finalice si la gente preserva los índices anteriores.

    Buena suerte.

    1. Angel Borroy dice:

      Gracias por tu comentario, Richard.

      Omitimos la copia de los índices de Solr porque se trata de una instalación pequeña y porque migrábamos de Solr1 a Solr4. El proceso completo (con recálculo de índices incluido) costó poco más de una hora por lo que se realizo de manera íntegra en ventana de mantenimiento.

      No obstante, como comentas, la restauración de los índices de Solr permitiría que el sistema entrase en funcionamiento al 100% más rápidamente.

  2. […] porAngel Borroy / Miércoles, 10 diciembre 2014 / Publicado enNoticias Nuestro camino desde Alfresco CE 4.2.c hasta Alfresco CE 5.0.c […]

  3. […] os sirva de ayuda y os recomendamos que antes de realizar una migración a Alfresco 5 estudiéis vuestro sistema para poder hacer frente a posibles imprevistos con […]

  4. Una preguntilla Angel:

    ¿ No fue necesario pasar por la 4.2.f ?

    Saludos.

    –C.

    1. Angel Borroy dice:

      César,

      Hemos hecho un par de migraciones de 4.2.c a 5.0.x

      En ninguno de ellos hemos necesitado pasar por la 4.2.f. Pero también es cierto que eran instalaciones de 4.2.c que habíamos hecho nosotros y que teníamos muy controladas.

      Saludos

  5. Gracias Angel,

    Justo he intentado lo mismo con la 5.0.d hoy y ha pasado de mi… pero con la 5.0.c si que ha hecho upgrade directo.

    Una preguntilla, ya que usais Alfresco 5.0.c. ¿ Se puede poner como una de las facetas del buscador las categorias ? Lo he hecho con las etiquetas pero no lo he encontrado las categorias como filtro disponible en la Community. ¿ Te suena ?

    Saludos.

    –C.

  6. Angel Borroy dice:

    Ahora que lo dices, es cierto: todas nuestras actualizaciones han sido a 5.0.c. Hasta la 5.0.d no hemos hecho todavía ninguna, así que vale mucho la pena tu aviso 🙂
    Las categorías no están como filtro por defecto. No sé si se podrá hacer algo definiéndolas en el fichero de configuración (http://docs.alfresco.com/5.0/tasks/filtered-search-custom.html)

    Suerte!

  7. Juan García dice:

    Que tal, soy nuevo en el tema de Alfresco, en donde trabajo se me asigno la tarea de investigar sobre la actualización de Alfresco 3.4.d Community ya que es una versión algo “viejita” en comparación con la que actualmente hay “5.0.d” pero que nos ha funcionado muy bien, he visto que se deben tomar varias consideraciones para la actualización, como escalar algunas versiones para llegar a la actual (diagrama presentado en el foro del Alfresco para la actualización), sin embargo no he encontrado un tema que hable de esa actualización 3.4.d a 5.0.d, o si se puede realizar directamente. Si me pudieran ayudar con ello, se los agradecería mucho

    1. Angel Borroy dice:

      Gracias por tu comentario, Juan.

      La manera más segura de realizar la actualización es migrar de 3.4.d a 4.2.c y después migrar de 4.2.c a 5.0.d.

      No obstante, te recomendaría que utilizases primero un entorno de prueba, para asegurarte de que nada se rompe al realizar estos pasos.

  8. […] Richard Esplin noted at keensoft blog entry, Solr indexes can be backed up and restored. If so, searches are available at boot time and users […]

  9. Jonatan dice:

    Existe algun tutorial de migrar los aspectos personalizados de la version 4.2 a la version 5?
    gracias