Liferay – Migración del portal a la 6.2


Realizamos la primera entrada de blog en referencia a la actualización/migración de Liferay a la versión 6.2. Esta entrada habla de la actualización del portal, la próxima tratará la actualización de plugins.

Se trata de una entrada más bien a modo de checklist de las tareas a realizar en una migración desde un punto de vista teórico. Vamos con ello…

Actualizar el portal. El algoritmo de permisos es muy importante

Previamente al proceso de migración:

1) (Opcional) (Recomendable) Aplicar los parches y actualizaciones pendientes de la versión actual

2) (Opcional) (Recomendable) Resolver los errores actuales del portal, intentar que todo funcione correctamente

3) (Opcional) (Recomendable) Ejecutar el proceso de verificación (*)

4) Hacer un Backup completo

– Base de datos

– Documentos y media

– (Opcional) Índices <- aunque después de actualizar se re-indexa

– (Opcional) Portal y su configuración <- aunque en principio no lo sobrescribiremos

5) Utilizar el algoritmo de permisos v6 <- seguramente ya sea el caso, mirar el siguiente punto para confirmación

Algoritmo de permisos

Para migrar a la 6.2 es obligatorio que se esté utilizando el algoritmo de permisos en versión nº 6.

Comprobar que estemos utilizando esta versión del algoritmo:

– Panel de control > Administración del servidor > Propiedades > Propiedades del Portal

– Navegar hasta encontrar la propiedad llamada “permissions.user.check.algorithm”

– Comprobar que sea la versión 6

Actualizar a la versión 6:

– Esto debe hacerse antes de actualizar el portal a la 6.2

– Panel de control > Administración del servidor > Migración de datos

– Al final de la página se encontrará un apartado “Convertir el antiguo algoritmo de permisos”

   El Checkbox es opcional, es para convertir permisos que estaban asociados a usuarios (directamente) a roles asignados a usuarios, ya que el algoritmo v6 no permite asociar permisos directamente a usuarios

Proceso de migración

1) Descargar la última versión del portal

2) Configurar el nuevo portal (portal-ext.properties) para que apunte a la antigua base de datos y documentos

3) Revisar y configurar el portal-legacy-XX.properties de vuestra versión (Consultar guía de usuario, enlace al final)

4) (Enterprise Edition) Pedir y/o descargar la licencia para la nueva versión

5) Arrancar el servidor

a)Primero lanzará un proceso de actualización de la base de datos y documentos

b)Luego ejecutará un proceso de verificación de inconsistencias

6) Buscar y aplicar parches pendientes si hay

7) (Recordatorio) No instalar aún los plugins personalizados

Posteriormente al proceso de migración

1) Comprobar que el portal funcione bien, utilizar las funciones más comunes

2) Revisar los logs

3) Instalar posibles plugins oficiales (la nueva versión), a veces con nuevas versiones se pasan funciones del núcleo a portlets, etc. Revisar también si se hecha de menos algo en el portal.

4) Re-indexar los índices

5) Instalar el resto de plugins personalizados (hasta ahora webapps debía estar con los portlets que venían por defecto) <- Se tratará en una entrada de blog para plugins

6) Utilizar el nuevo portal como producción

Resolución de Problemas

– documentLibrary.NoSuchFileException

– Posible configuración portal-ext.properties incorrecta en las líneas (dl.store.impl y dl.store.file.system.root.dir)

– posible estado inestable del repositorio

– posible falta de ficheros en el repositorio (eliminar desde el portal los ficheros o añadirlos al repositorio)

– Si ha ocurrido cualquier problema la recomendación es arreglarlo (suele ser configuración) y empezar de nuevo restaurando el Backup inicial.

– Si se intenta actualizar desde una base de datos corrompida o con actualizaciones a medias, puede ser muy difícil poder entender los errores

Recomendaciones

– No aprovechar la actualización para hacer otros cambios, solo puede incrementar y confundir la procedencia los posibles errores

– No hacer un cambio de tipo de base de datos (P.ej: MySQL a Oracle)

– No hacer un cambio de servidor de aplicaciones (P.ej: Tomcat a JBoss)

– No cambiar de servidor o hosting

– (Enterprise Edition) Utilizar el servicio oficial de soporte a la migración (customer portal o sales_es@liferay.com)

– (Enterprise Edition) Pedir la checklist de tareas para la migración (customer portal o sales_es@liferay.com)

Orden de actualización complejo (información extra para casos puntuales)

Aquí se describe el órden de actualización si se quieren hacer varios cambios en el sistema. Después de cada paso hace falta verificar el correcto funcionamiento y arreglar los errores.

1) Comunity edition (CE) a Entrerprise edition (EE)

2) Actualizar portal con los últimos parches

3) Algoritmo de permisos a versión nº 6

4) Actualizar a la última versión de portal (6.2)

5) Actualizar el software (bbdd, servidor de aplicaciones, etc) uno a uno

(*) Proceso de verificación

El proceso de verificación está disponible en todas las versiones y se puede ejecutar sin la necesidad de actualizar el portal.

Para lanzar-lo es necesario parar el servidor y añadir la siguiente linea verify.frequency=-1 en el portal-ext.properties. Ahora basta con arrancar el servidor.

Una vez pasado el proceso es necesario eliminar la línea para evitar volver a lanzar.Icon

Información extraída de: 

Esperamos que esta entrada os sirva de ayuda, a nosotros nos sirve como base para realizar migración de versiones.


Leave a Reply

Your email address will not be published. Required fields are marked *