Step-by-Step Process Guide for Alfresco Migration from 5.x to 6.0

As a robust, open-source framework for offering digital operations with exceptional experiences, Alfresco has gained ground across 190 countries globally. One of the reasons for this platform’s increasing popularity is Alfresco keeps on coming with updated versions to meet the diverse needs of modern businesses. On July 11, 2018, Alfresco has introduced Alfresco 6.0 in its Content Services.

Entrepreneurs can leverage the benefits of the latest version of Alfresco by migrating their existing software to 6.0. It is highly recommended for Alfresco developers to follow a structured path while updating the versions in Alfresco Content Services. Here we give a step-by-step guide for Alfresco content migration from 5.x to 6.0. This migration procedure can be done by using the distribution zip or installer.

The Alfresco document migration involves a new installation of the Alfresco Content Services binaries and configuration or installer along with an in-place upgrade of a copy of the repository. However, in-place upgrade of the binaries and configuration is not recommended. Whenever you create a new installation, you can remain assured that if anything goes wrong during the upgrade, the original or existing Alfresco document management system will stay intact and available for immediate restart.

This displays a list of installed modules. Make a note of the module ID of the module you wish to uninstall,
for example,
org.alfresco.integrations.google.docs in the amps directory
org.alfresco.integrations.share.google.docs in the amps_share directory.

iii. Uninstall the module by entering the following command:
java -jar bin/alfresco-mmt.jar uninstall org.alfresco.integrations.google.docs tomcat/webapps/alfresco.war
and
java -jar bin/alfresco-mmt.jar uninstall org.alfresco.integrations.share.google.docs tomcat/webapps/share.war
You can check that the AMP files have been removed by rerunning the command:
java -jar bin/alfresco-mmt.jar list tomcat/webapps/alfresco.war
and
java -jar bin/alfresco-mmt.jar list tomcat/webapps/share.war
iv.Delete the tomcat/webapps/alfresco and tomcat/webapps/share folders in the installation directory

Ref: https://docs.alfresco.com/6.0/concepts/remove-apps-install.html
Ref: https://docs.alfresco.com/6.0/tasks/uninstall-amp.html

c) Install the required AMP files. (This may require little changes in your custom code because some of the features may have been removed or deprecated)
i. Place Repository amps in /alfresco/amps folder and Share amps in /alfresco/amps_share folder.
ii. Browse to the /bin directory:
Windows : C:\Alfresco\bin
Linux : /opt/alfresco/bin
iii. Run the apply_amps application to apply all AMP files that are in the amps and amps_share directories:
For Windows, navigate to the bin directory and double click apply_amps.
For Linux, enter the command: bin/apply_amps.sh

Ref: https://docs.alfresco.com/6.0/tasks/amp-install.html

d) Do not copy the files. Copy the override settings only so that you will not overwrite the new extension files in the upgraded version.
i. Copy the override settings, Like directory files and alfresco-global.properties parameter (do not replace this file but just add additional parameter).

e) Start the Alfresco server.
i.Monitor the start-up log messages for information on the status of the upgrade. If any issue(s) occur in the logs during start-up, you need to roll-back the whole repository to fix the issue(s) and then try again.

f) Fully test the working and configuration of your customization.

g) Stop the server

4) Restore the backup to new Alfresco version

a) Remove(or Copy for safer side) all the files and directories under the contentstore directory of the new installation. Also, rename new alfresco database and create a new database at same place with the same name.

b) Delete(or Copy for safer side) the files in the Solr4/alfrescoModels directories, and the indexes in the two directories (solr/workspace/ and solr/archive/) of the new installation.

c) Restore the backup of the indexes(optional but takes time to reindex if no of document are too large), contentstore directory, and database from your previous installation into the new installation.

d) Start the server and monitor logs.

That’s it! Your document management system is ready with the new Alfresco 6.0 version.

Tridhya Tech is a renowned Alfresco development company. We have an in-house team of experienced Alfresco developers to enable our corporate users to make the most of the latest Alfresco 6.0 version.

Click to Know More: https://docs.alfresco.com/6.0/tasks/upgrade-process.html