High level Activities/Process We Follow For The Liferay Upgradation
1
Backup Everything
- Backup of everything which includes the database, Liferay Server folder, Source code, Configurations, and binary files like images, documents, and PDFs.
2
Data Cleanup
- Remove unnecessary database records like previous versions of web content, blogs, audit records, Kaleo log records, and many more after assessing the existing Liferay Portal.
- Remove previous versions of documents to minimize data folder size.
- It's recommended to write a Liferay module that will delete records and documents using Liferay’s API rather than deleting them using SQL queries or file removal. This will ensure an error-free data cleanup process and allow for easier execution in multiple environments.
3
Database Upgrade
- Copy the document_library folder from the previous Liferay to the new Liferay server folder.
- Upgrade the Liferay database using the Liferay upgrade tool. Perform configurations like increasing memory for JVM, disabling indexing during the upgrade, and disabling filters during the upgrade.
- During the Liferay database upgrade, the process might throw errors related to data, necessitating updates to data in the previous version of Liferay to solve these errors. In this case, the upgrade process must be restarted from the beginning.
- The Liferay database upgrade tool will convert existing Liferay data to new Liferay version data after the successful completion of the database upgrade.
4
New Liferay Server Setup
- Configure the new Liferay server with an upgraded database. Update Liferay configuration properties file (remove deprecated properties and add new relevant properties).
- Start the Liferay server with migrated data.
- Observe the default behavior of Liferay after the database upgrade:
- Check all portlet conditions from the gogo shell.
- Check the error logs during the Liferay startup process.
- Reindex the data to the Elasticsearch.
- Compare a few pages with the previous version of Liferay.
5
Upgrade Template Files
- Upgrade Liferay template files for web content templates and widget templates if the Liferay portal gives you errors on pages for Liferay templates.
6
Source Code Management
- Create a new branch from the master branch of the previous Liferay source code to maintain the previous history of the source code. Push source code upgrade changes to the new branch to track the history of changes made during the upgrade process.
7
Liferay Workspace Upgrade
- To upgrade the Liferay workspace, we can follow two approaches.
- IDE upgrade tool
- Manual upgrade
- The process is dependent on the codebase structure and size.
- Workspace upgrade contains the following changes:
- Gradle properties changes
- Gradle dependency files
- Gradle wrapper jar and property file
8
Liferay Theme Upgrade
- Upgrade the Liferay theme with the new version of Liferay by either following Liferay's standard way of theme upgrade or creating a new Liferay theme with the latest version and copying CSS, JS, fonts, and other theme-related files from the previous version of the Liferay theme.
9
Liferay Layout Template Upgrade
- Upgrade the Liferay Layout template modules to the newer version. It includes creating a new layout template module and copying the layout XML configuration files.
10
Liferay Service Builder Module Upgrade
- Service builder upgrade depends on the below changes
- Service.xml file upgrade to the latest version supported file
- Generate the new service class by performing the buildService command
- Update the service implementation classes (especially component declarations and imports)
- Check the bnd.bnd related settings and update it.
11
Liferay MVC Module Upgrade
- Find less dependent modules by inspecting the build.gradle
- Here Major work involves updating the build.gradle, bnd.bnd files, and replacing Liferay APIs with new Liferay version API. The use of a Gogo shell will be helpful.
- Update the import statements in the class as per the new dependencies.
12
Liferay JSP fragment upgrade
- Liferay JSP fragment upgrade is not a straightforward process. We need to create new fragment module for the new Liferay version and get all the changes one by one in the fragment that we did for the previous Liferay version.
13
Liferay Customization Upgrade
- Liferay customization like service wrappers and model listeners perform big roles in functionalities
- It includes changing the attributes, imports, method parameters, etc.
- Other customizations like search tuning.
- We need to validate the customization against Liferay OOTB features.
- If things are not well with OOTB features, we need to customize the search based on the latest supported version.
Upgraded So Far
Liferay Portals
0
+
Modules
0
+
Themes
0
+
Templates
0
+
Liferay Pages
0
+
Why Choose IGNEK For Liferay Upgradation?
At IGNEK, Our expert engineers use up to date softwares and vast knowledge to craft solutions that match your needs and expectations. Putting clients first is our thing, and we’re proud to support our very first business client till today!
