• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer
TSB Alfresco Cobrand White tagline

Technology Services Group

  • Home
  • Products
    • Alfresco Enterprise Viewer
    • OpenContent Search
    • OpenContent Case
    • OpenContent Forms
    • OpenMigrate
    • OpenContent Web Services
    • OpenCapture
    • OpenOverlay
  • Solutions
    • Alfresco Content Accelerator for Claims Management
      • Claims Demo Series
    • Alfresco Content Accelerator for Policy & Procedure Management
      • Compliance Demo Series
    • OpenContent Accounts Payable
    • OpenContent Contract Management
    • OpenContent Batch Records
    • OpenContent Government
    • OpenContent Corporate Forms
    • OpenContent Construction Management
    • OpenContent Digital Archive
    • OpenContent Human Resources
    • OpenContent Patient Records
  • Platforms
    • Alfresco Consulting
      • Alfresco Case Study – Canadian Museum of Human Rights
      • Alfresco Case Study – New York Philharmonic
      • Alfresco Case Study – New York Property Insurance Underwriting Association
      • Alfresco Case Study – American Society for Clinical Pathology
      • Alfresco Case Study – American Association of Insurance Services
      • Alfresco Case Study – United Cerebral Palsy
    • HBase
    • DynamoDB
    • OpenText & Documentum Consulting
      • Upgrades – A Well Documented Approach
      • Life Science Solutions
        • Life Sciences Project Sampling
    • Veeva Consulting
    • Ephesoft
    • Workshare
  • Case Studies
    • White Papers
    • 11 Billion Document Migration
    • Learning Zone
    • Digital Asset Collection – Canadian Museum of Human Rights
    • Digital Archive and Retrieval – ASCP
    • Digital Archives – New York Philharmonic
    • Insurance Claim Processing – New York Property Insurance
    • Policy Forms Management with Machine Learning – AAIS
    • Liferay and Alfresco Portal – United Cerebral Palsy of Greater Chicago
  • About
    • Contact Us
  • Blog

Upgrading to Alfresco 5 – Keys to Success

You are here: Home / Alfresco / Upgrading to Alfresco 5 – Keys to Success

January 12, 2015

With the recent release of Alfresco 5 Enterprise, many clients are beginning to plan to upgrade to the latest version of Alfresco in the coming months.  On January 8th, TSG participated in an Alfresco Tech Talk Live Session that focused on upgrading to Alfresco 5.  Alfresco Tech Talk Live is a regularly scheduled webcast where a panel of subject matter experts discuss various topics related to Alfresco.  A recording of the Alfresco 5 Upgrade session can be found here.  A complete list of Alfresco Tech Talk Live sessions can be found here.

During the session, some key points were brought up that contribute to the overall success of an Alfresco upgrade.  This post will discuss 5 of those factors in more detail.

Those of us who have performed an Alfresco upgrade know that there’s a lot more involved than just running an executable to install patches.  The upgrade process typically involves performing a clean install of the new version of Alfresco, migrating configurations and customizations to the new version of Alfresco, and finally pointing the new version of Alfresco at the existing database and content store.  For heavily customized systems, upgrading Alfresco can be a lengthy process requiring time for planning and testing.

The tips below come from lessons that we’ve learned over the years when performing Alfresco upgrades.  Admittedly, some of them were learned the hard way…

1.  Take Inventory of Configurations and Customizations

Part of the Alfresco upgrade process is moving configurations and customizations from the old version of Alfresco to the new version.  It’s important to take an inventory of all of the configurations and customizations in your Alfresco installation ahead of time.  Most configurations can be easily ported into the new version of Alfresco, but if they haven’t been identified in advance, it’s just as easy to forget them.  If your system has customizations, it’s important to verify that the customizations are compatible with the new version of Alfresco, and to recompile them against the new version of the Alfresco SDK.

A complete inventory of Alfresco configurations and customizations is also a great guide for helping determine what functionality needs to be tested after the upgrade is complete.  From our experience with upgrades, out-of-the-box Alfresco functionality typically requires very little testing after an upgrade, but customizations should be thoroughly tested to ensure compatibility with the new version of Alfresco.

Don’t forget to hang on to your inventory of configurations and customizations because the list can help you kick start future Alfresco upgrades as well.

2.  Validate Supported Stack

 It’s really tempting to dive head first into an Alfresco upgrade, but it’s critical to first validate that the database, OS, browsers, etc. are supported with the new version of Alfresco before proceeding with the upgrade.  It’s common for Alfresco to drop support for some components and add support for others, especially when major versions are released.  It’s important to stay on a supported stack in order to ensure that Alfresco can provide support for any cases that you log via the support portal.  A complete list of the Alfresco supported stacks can be found here.  Note that significant changes to the supported stacks have come with the release of Alfresco 5.

3.  Document the Process

Upgrading Alfresco can be a lengthy process.  Alfresco provides good documentation for performing upgrades, found here, but every upgrade is different.  Some of the steps may be relevant for your environment, and others may not.  Documenting the upgrade process as you perform it will not only help ensure that that all of the appropriate steps are taken in all environments (development, test, production, etc.), but it will also help future upgrades go more quickly.  Since the process does not change much between versions, your documentation can likely be reused.

4.    Test on a Clone of Production Data

Even if you have non-production Alfresco environments (development, test, etc.), we recommend performing an Alfresco upgrade on a clone of the production data prior to performing the actual production upgrade.  From experience, we’ve seen successful upgrades in non-production environments still lead to issues when upgrading production.  Because of differences in the type and amount of data in production, sometimes unforeseen errors can occur.  For example for one client, upgrading Alfresco required a full re-index in Solr, and during the upgrade the system ran out of memory due to the amount of data in the production repository.  The out of memory error was not encountered during the upgrade in the test environment because the amount of data in the test environment was only 5% of what was in production.

Testing on a clone of production data also has the benefit of giving you an idea of how long the production upgrade will take.  If the upgrade runs more slowly than is acceptable for production, steps can be taken in advance to optimize the process (database tuning, more CPU/RAM, etc.).

5.  Have a Backout Plan

No matter how much planning you do for an Alfresco upgrade, there’s always a possibility that things will not go as expected when upgrading a production environment.  It’s important to have a plan in place for backing out the upgrade if things do not go well.  If you’re working in a virtual environment, the quickest way to back out an upgrade is to create a snapshot of the VM, database, and content store before starting the upgrade, and reverting back to the snapshots if necessary.

Hopefully this list of tips is helpful in planning your upgrade to Alfresco 5.  Please feel free to add comments below.

Filed Under: Alfresco, Tech Tip

Reader Interactions

Leave a Reply Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Primary Sidebar

Search

Related Posts

  • Alfresco Performance – Making Property Queries Faster
  • Alfresco and Angular 2.0: Technical First Look
  • Avoiding Alfresco Performance Problems from Day 1 – Keeping My ECM Healthy
  • Alfresco’s Transactional Metadata Query System – Mystery Results
  • Harnessing the Power of Alfresco Data Lists for Cascading Value Assistance
  • Auto-Numbering Content in Alfresco
  • Auto-Filing Content in Alfresco
  • Alfresco Post-Installation Configuration
  • Content Deletion in Alfresco – More than Meets the Eye
  • Alfresco Data List-Driven Value Assistance

Recent Posts

  • Alfresco Content Accelerator and Alfresco Enterprise Viewer – Improving User Collaboration Efficiency
  • Alfresco Content Accelerator – Document Notification Distribution Lists
  • Alfresco Webinar – Productivity Anywhere: How modern claim and policy document processing can help the new work-from-home normal succeed
  • Alfresco – Viewing Annotations on Versions
  • Alfresco Content Accelerator – Collaboration Enhancements
stacks-of-paper

11 BILLION DOCUMENT
BENCHMARK
OVERVIEW

Learn how TSG was able to leverage DynamoDB, S3, ElasticSearch & AWS to successfully migrate 11 Billion documents.

Download White Paper

Footer

Search

Contact

22 West Washington St
5th Floor
Chicago, IL 60602

inquiry@tsgrp.com

312.372.7777

Copyright © 2023 · Technology Services Group, Inc. · Log in

This website uses cookies to improve your experience. Please accept this site's cookies, but you can opt-out if you wish. Privacy Policy ACCEPT | Cookie settings
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.
Non-necessary
Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.
SAVE & ACCEPT