Skip to main content

Liferay migration to version 7.x

This blog explains the process of upgrading the Liferay core installation to version 7.0 in simple steps.

Note : If you are doing migration from 6.1 and earlier, go through the following link Upgrade to Liferay 7 and proceed with the following steps.

Step 1

Install jdk 8 and mysql 5.7 in your system. Please refer this compatibility matrix for version details Compatibility Matrix PDF.

Step 2 

Take backup of your existing Liferay installation and Database that you are about to migrate.

Step 3

Install Liferay 7 in your system. Update the 'portal-ext.properties' by pointing out the existing database (i.e earlier version).
Dont start it.

If you start it, you will get error message as follows:
You must first upgrade to Liferay Portal 7000

Step 4

Copy and paste existing [Liferay Home]/data/document_library folder in to new installation.
For more details about Document Management , follow this document-repository-configuration

Step 5

Create a file called com.liferay.portal.search.configuration.IndexStatusManagerConfiguration.config in your [Liferay Home]/osgi/configs folder and add the following content:
indexReadOnly="true".

This will disable indexing to prevent upgrade process performance issues that arise when the indexer attempts to reindex content.

Step 6

The db_upgrade.sh script (db_upgrade.bat on Windows) invokes the upgrade tool.
It resides in the [Liferay Home]/tools/portal-tools-db-upgrade-client folder.

Once you invoke this file, It asks the server and database details. After entering the details, it will be saved as text files such as app-server.properties,
portal-upgrade-database.properties, portal-upgrade-ext.properties

Or you can manually configure these properties files.

Once you given these properties , upgrade process for database and Liferay core installation will start.

And you will get the success message as follows:

Completed Liferay core upgrade and verify processes in xxx seconds
Checking to see if all upgrades have completed... done.

Conclusion

The above steps can help you to upgrade the core modules of Liferay installation to version 7.

For upgrading custom installation modules and more details, refer this Upgrade process.




Comments

  1. Bon tutoriel et c'est un article essentiel. Merci pour moi. Ces étapes sont faciles. Nous sommes Chef de projet Liferay Maroc et proposons également les services Liferay. Contactez-nous pour plus de détails.

    ReplyDelete

Post a Comment

Popular posts from this blog

Liferay 7 overriding MVC Commands

MVCActionCommand : An interface that allows the portlet to process a particular action request. By extending  BaseMVCActionCommand , we can customize processAction method. MVCRenderCommand : An interface that handles the render phase of the portlet. By   extending  BaseMVCRenderCommand , we can customize render method. MVCResourceCommand : An interface that allows the portlet to serve a resource. By  extending  BaseMVCResourceCommand , we can customize serveResource method. Now , we will see how to customize processAction method. Step 1: Initially, Create one module as mentioned in Liferay 7 document. Step 2: In controller class, write the component property depends on which modules you are customizing, for eg., if we customize create account page, write as following @Component( property = { "javax.portlet.name=com_liferay_login_web_portlet_FastLoginPortlet", "javax.portlet.name=com_liferay_l...

Migrating a Legacy Liferay DXP Theme to Client Extensions

Migrating a legacy WAR-based Liferay theme to modern Theme CSS and JavaScript Client Extensions is an important step toward a more modular, maintainable, and upgrade-friendly Liferay DXP architecture. Traditional themes package styling, JavaScript, templates, and static resources together in a deployable WAR. With client extensions, you can separate styling and JavaScript from the core portal runtime, simplify deployments, and reduce dependencies on traditional theme modules. This guide explains how to analyze a legacy theme, migrate its components to client extensions, reorganize project files, configure the required YAML files, and apply the new extensions to Liferay pages. 1. Understand the Traditional Theme Components Before starting the migration, identify the components used by your existing theme and determine their modern Liferay equivalents. Legacy theme component Recommended replacement portal_normal.ftl Master Pages, Page Templates, and supported page configuration options ...

Embed portlet in liferay 7 FTL theme

To include portlet in liferay 7 ftl theme , use the code as follows. <@liferay_portlet["runtime"] defaultPreferences="${freeMarkerPortletPreferences}" portletProviderAction=portletProviderAction.VIEW instanceId="blablabla1" portletName="com_liferay_site_navigation_directory_web_portlet_SitesDirectoryPortlet" /> where , instanceId="blablabla1" have to be given only for instanceable portlet, "com_liferay_site_navigation_directory_web_portlet_SitesDirectoryPortlet" is portletId.