Our road from Alfresco CE 4.2.c to Alfresco CE 5.0.c

/ / Blog, Document Management
alfresco-singleupgrade
keensoft at "Alfresco Tech Talk Live 82: Upgrading to Alfresco 5.0"
alfresco-myfiles-quota: new add-on available for Alfresco

Alfresco 5.0.c

The release of the 5.0.c version of Alfresco Community, which is the first in the 5 range and is considered suitable for use in semi-productive environments, has prompted us to upgrade our company document manager server. The following is a rundown on how our version upgrading process was performed.

Initial situation

  • We had an Alfresco CE 4.2.c installation on PostgreSQL 9.1 running in an Ubuntu 14 server
  • The repository size was 15 Gb and housed almost 60,000 documents
  • Authentication was integrated with our corporate LDAP
  • We had different AMP personalization modules
  • There was a personalized backup process

Planning migration

In spite of our experience in this type of operation, in order to guarantee the success of migration we first reviewed the work flow proposed by Alfresco to perform these operations:

  • Validate prerequisites
  • Perform a backup copy of Alfresco 4.2.c (file system and database)
  • Perform a clean installation of Alfresco 5.0.c
  • Check the clean installation of 5.0.c
  • Apply the configuration changes and AMP modules
  • Restore the backup copy of Alfresco 4.2.c on the clean installation of Alfresco 5.0.c
alfresco singleupgrade

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

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

Execution of the process

Note. The steps indicated here may not be suitable for your environment so they are only intended to be a guideline for your own processes.

# 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

We now have our new version and we can take full advantage of all its new features (HTML 5 preview, faceted searches….) to manage our documents in a more efficient (and more enjoyable) way.

 

The processes for upgrading between Alfresco versions should be carried out following Alfresco’s own specifications. And if you are not sure then it is best to ask for expert help and always try them out in advance in a test environment.

Unidad de negocio, keensoft