Upgrade Process of Alfresco

Posted: December 12, 2011 in Alfresco
Tags: , , , ,

It’s common for a software product to undergo changes, made by its R & D team, and to have newer versions. Basing on the changes that have implemented, the releases might be MINOR or MAJOR. The same applies for Alfresco as well. Lets discuss the upgrade process of Alfresco (Both Minor and Major upgrades).

UPGRADING TO A MINOR RELEASE:

This type of upgrade will be between the minor releases such as 3.0 to 3.0.1, 3.3 to 3.4, etc. As there will be no new features, except some small patches and minor UI changes, we can do the upgrade by simply replacing the Web Application (WAR) file.

The WAR file can be downloaded, and replaced with the existing WAR files under <install_folder>\tomcat\webapps.

The following steps can be followed for upgrading the alfresco with minor release:

1. Download the latest release of Alfresco WAR file from the Alfresco website.

2. Stop the alfresco instance. (TOMCAT and MySQL).

3. Backup the data, and the customization files.

4. Delete the Alfresco folder in <install_folder>\tomcat\webapps.

5. Replace the existing Alfresco.war file in the above said location with the recently downloaded WAR file.

6. Restore the customizations (If any).

7. Start Alfresco

The Above said procedures will upgrade Alfresco to a new minor release.

UPGRADING TO A MAJOR RELEASE:

This type of upgrade will be between the Major releases such as 2.x to 3.x, 3.x to 4.x, etc. An Alfresco’s major release contains new features, performance enhancements, and bug fixes.

The following steps can be followed for upgrading the alfresco with minor release:

1. Download the complete Alfresco package and the Tomcat bundle for the Windows operating system.

2. Stop Alfresco.

3. Backup the data, and the customization files.

4. Perform a new installation in a different folder.

5. Copy the older Alfresco file content folder to the newer installation

(Copy C:\alfresco_old_version\alf_data folder to C:\alfresco_new_version\alf_data).

6. Create a new database table, and restore the relational database content from the older database.

7. Update the Alfresco configuration file (alfresco-global.properties) in the new installation, to point to this new database.

8. Restore the customization files in the new installation.

9. Start Alfresco in the new installation.

The Above said procedures will upgrade Alfresco to a new Major release. Test thoroughly to verify whether your old configurations are working fine with the new release or not.

More information regarding the upgrade process can be found here in the alfresco site.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s