Upgrading from Liferay 6.1 to 6.2 Part 2

Created: 10 March 2016  Modified:

Now that we have repaired the database we are ready to configure Liferay 6.1 to prepare it for the upgrade. For the upgrade I recommend that you deploy only the core Liferay installation. This keeps the number of things that can go wrong to a minimum. You can then later deploy any additional Liferay and custom portlets.

For the upgrade the “passwords.encryption.algorithm.legacy” property needs to be set in portal-ext.properties.

portal-ext.properties

...
passwords.encryption.algorithm.legacy=SHA
...

Additionally I would go ahead and set the following properties as we determined they are needed for Liferay 6.2 to run smoothly.

portal-ext.properties

...
# Prevents empty blue bar issue in 6.2 
locale.prepend.friendly.url.style = 1;
# Enable quartz clustering
org.quartz.jobStore.isClustered=true    

# Secure filter is now needed.  
# Performance recommendations for 6.1 suggest disabling it.
com.liferay.portal.servlet.filters.secure.SecureFilter=true
    ...

You will also want to acquire a new license for your server that is compatible with Liferay 6.2 if you are using the enterprise edition. Additionally I highly recommend backing up your database for this upgrade. If there are any problems during the upgrade you can restore the database, fix the issue and start again. Once you startup the server you shold start seeing entries similar to the ones below. If something goes wrong you will likely see many additional errors.

logs/catalina.out

...
14:30:33,270 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.UpgradeProcess_6_2_0
14:30:33,271 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeSchema

14:30:36,560 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeAssetPublisher
14:30:36,962 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeBlogs
14:30:40,224 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeBlogsAggregator
14:30:40,232 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeCalendar
14:30:44,479 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeCompany
14:30:44,541 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeCustomizablePortlets
14:30:45,243 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeDocumentLibrary
14:30:45,247 INFO  [localhost-startStop-1][Table:157] Starting backup of DLFileEntryType to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-DLFileEntryType-1455978645247
14:30:45,273 INFO  [localhost-startStop-1][Table:191] Finished backup of DLFileEntryType to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-DLFileEntryType-1455978645247 in 26 ms
14:30:46,391 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeDynamicDataListDisplay
14:30:46,481 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeDynamicDataMapping
14:30:46,487 INFO  [localhost-startStop-1][Table:157] Starting backup of DDMTemplate to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-DDMTemplate-1455978646487
14:30:46,539 INFO  [localhost-startStop-1][Table:191] Finished backup of DDMTemplate to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-DDMTemplate-1455978646487 in 52 ms
14:30:47,410 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeGroup
14:30:47,418 INFO  [localhost-startStop-1][Table:157] Starting backup of Group_ to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-Group_-1455978647418
14:30:52,347 INFO  [localhost-startStop-1][Table:191] Finished backup of Group_ to /apps01/tomcat7/liferay/apache-tomcat/temp/temp-db-Group_-1455978647418 in 4929 ms
14:30:54,144 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeImageGallery
14:30:54,820 INFO  [localhost-startStop-1][UpgradeProcess:164] Upgrading com.liferay.portal.upgrade.v6_2_0.UpgradeJournal
...

If the upgrade process goes smoothly you can shutdown the server and drop the license file into the deploy directory. You should now be able to connect to your new version of Liferay. There is still more to do. In the next part we will be configuring Solr 4 to work with Liferay 6.2.

tags: liferay - EE - 6.1 - 6.2 - portal-ext.properties - upgrade
   Less Is More