Planning of Migrating from Liferay 6.x to Liferay DXP.

Liferay Digital Experience Platform (DXP) gives you a full view of the customer in order to create and manage consistent customer experiences across mobile, social, desktop, in store and other touch based devices. DXP prepares you to adapt quickly to future digital innovations.

Liferay DXP adopted new architecture with latest features in the web technologies. Due to architectural changes there will be many challenges while upgrade/migrate to latest Liferay DXP from Liferay 6.x.

Top 5 things to think before doing migration to Liferay DXP.

Backup existing data:-

“Backup of existing data is must before doing any migration”.

Migrating from Liferay 6.x to Liferay DXP, the first thing is to take proper backup from the current running server. The backup will help you revert back to older state, if anything doesn’t work properly.

Backup need to be taken for the below listed items.

·         Database schema

·         Files from data folder (which contain document and media files)

·         Custom configurations in the properties files. (portal-ext.properties)

·         PortalPreferences which are associated with portlets.

Note: In Liferay DXP PortalPreferences_ has been removed and replaced by a modular OSGi-based configuration framework.

Database upgrade:-

Once the database backup is done, we need to upgrade the database with respect to Liferay DXP.

Database comes first everywhere which you must require to migrate to make it compatible with the new version.

Process of doing database upgrade are as follows:-

·         Disable indexing so that indexer doesn’t try to run during the upgrade.

Add below .cfg file in following server path - [Liferay Home]/osgi/configs

com.liferay.portal.search.configuration.IndexStatusManagerConfiguration.cfg with following content :- indexReadOnly=true.

Note: By adding the above file you will avoid indexing and save time during the upgrade process. Once you have upgraded your portal, remove that property or set it to false so that you can index all objects from control panel.

Note: Make sure all your database indexes have been applied correctly. A missing index can cause an upgrade to really slow down.

                                                                               

Upgrade to Java 8:-

Liferay DXP comes with Java 8 as default Java Runtime.

Java 8 is quite mature at this point, and brings a multitude of new features that improve the quality of life of Java developers significantly, it will improve both overall performance and maintainability.

While applications written for Java 7 can be run on Java 8 (in most cases), it is recommended to budget time into your migration plan to allow for each of your applications to be ported and validated using Java 8.

Change in Deployment Process:-

Since Liferay architecture of Liferay DXP is changed, it has adopted OSGi framework container which is based on modules based application. Due to OSGi container the deployment process has been changed based on different approaches.

Deployment process with different approaches.

WARs are traditional web apps to which we are all accustomed. WARs are not recommended in Liferay DXP because you lose access to any service that has been deployed to the OSGi container, though they can still access Liferay’s core services.

Bundles/Modules are plugins you’ve converted to an OSGi bundle. They are just simple

Java JARs with OSGi metadata. Bundles can only be deployed into the OSGi container.

Bundles cannot access services deployed as WARs besides Liferay’s core services. This is the recommended approach for all new development and will be the approach Liferay takes for all new development.

WABs are web archive bundles. If you deploy a WAR to the OSGi container, Liferay will convert the WAR into a WAB. This will give you all the benefits of a bundle without doing the conversion.

This is the recommended approach for deploying legacy applications built for older versions of Liferay.

The Liferay auto deploy directory now deploys to the OSGi container by default. The only way to deploy to your web application’s deploy folder is to do this manually through a direct deploy.

Many of our tools will directly deploy to the OSGi container.

Note: If you plan to cluster your servers, OSGi bundles may provide an additional hurdle if you rely on your app server’s administrative tools to do cluster deployment as those tools are not able to deploy to our OSGi container. As a current workaround, Liferay provide with Cluster Deployment Helper. This tool will take any number of files and bundle them into a WAR. The WAR will copy the files into Liferay’s deploy folder when it is deployed and then uninstall itself. You can then use the WAR with any app server administration tool.

Search:-

Liferay DXP comes with Solr and embedded Elasticsearch search engine. Elasticsearch will not be supported for production server. There is a choice Elasticsearch (non-embedded) or Slor as your search provider.

Basically you will be required separate search server to maintain the whole Liferay portal to work smoothly.

Fetching list of files in java / vm from specific folder in Liferay

We will have a requirement like we need to fetch the files from a specific folder of DLFile then for this type of requirement, the below code will be helpful to you.

Long parentFolderId = DLFolderConstants.DEFAULT_PARENT_FOLDER_ID;

DLFolder folder = DLFolderLocalServiceUtil.getFolder(groupId, parentFolderId, dirName);

ThemeDisplay themeDisplay = (ThemeDisplay) renderRequest.getAttribute(WebKeys.THEME_DISPLAY);

List fileEntryService = null;

try {

fileEntryService = DLFileEntryLocalServiceUtil.getFileEntries(themeDisplay.getScopeGroupId(),folder.getFolderId(),-1, -1, null);

} catch (SystemException e) {

e.printStackTrace();

}

for(DLFileEntry fileEntryObj : fileEntryService){

System.out.println(fileEntryObj.getTitle());

}

To fetch in VM file we can use this code :-

#set($service = $serviceLocator.findService("com.liferay.portlet.documentlibrary.service.DLFileEntryLocalService"))

#set($gid = $getterUtil.getLong($request.get("theme-display").get("scope-group-id"))) 

#set($fid = $getterUtil.getLong($folderId.getData())) 

#set($files = $service.getFileEntries($gid, $fid)) 

#foreach($doc in $files) 

#set($uet = $httpUtil.encodeURL($htmlUtil.unescape($doc.getTitle()))) 

$doc.getTitle()

#end

Fetching Tag Based Documents or Web Contents from Assets

Sometimes we will have the requirement like we need to fetch the documents which are specifically tagged with some tag name. Then no worries below code will help you to fetch the tag based documents from DLFile and also to fetch the tag based web content from Journal Article.

Java Code :-

String[] tagNames = {"get announcements"};

// Getting the ids of journalarticle and DLFille
 long[] requiredClassIds = {PortalUtil.getClassNameId(JournalArticle.class.getName()), PortalUtil.getClassNameId(DLFileEntry.class.getName())};

AssetEntryQuery assetEntryQuery = new AssetEntryQuery();
          assetEntryQuery.setAllTagIds(AssetTagLocalServiceUtil.getTagIds(groupId, tagNames));
         assetEntryQuery.setClassNameIds(requiredClassIds);

List assetEntryList = AssetEntryLocalServiceUtil.getEntries(assetEntryQuery);

for (AssetEntry ae : assetEntryList) {
      if(JournalArticle.class.getName().equalsIgnoreCase(ae.getClassName())){

           JournalArticle wc = JournalArticleLocalServiceUtil.getArticle(groupId, String.valueOf(ae.getClassPK() - 2));

             System.out.println("AnnouncementsPortlet : render : found web content name ::"+wc.getUrlTitle());

   } else if(DLFileEntry.class.getName().equalsIgnoreCase(ae.getClassName())){

    DLFileEntry dl =  DLFileEntryLocalServiceUtil.getDLFileEntry(ae.getClassPK());

    }

}