Installing a Bundled Service Pack or Update

Liferay DXP service packs and updates are built from source code and bundled with the following updates included:

  1. An updated patching tool (if the tool has been updated since the original release)
  2. Updated plugins (if new versions have come out since the original release)
  3. An updated version of Tomcat (most, but not all service packs)
  4. The latest fix pack or update level

Here’s how to update your installation from one service pack or update level (source) to another (destination). If possible, update to the latest available service pack or update.

Resolution

Always back up your database and installation before updating.

    1. Download the service pack or update archived bundle from Help Center Downloads.
    2. Extract the new bundle to your location of choice.
    3. Copy your database vendor's JDBC driver JAR to the appropriate lib folder:
      1. For Liferay DXP 7.3 and below the JDBC drivers, by default, are in $CATALINA_HOME/lib/ext.
      2. For Liferay DXP 7.4 and above the JDBC drivers, by default, are in $CATALINA_BASE/webapps/ROOT/WEB-INF/shielded-container-lib.
    4. Copy your portal-ext.properties file to the $LIFERAY_HOME folder.
    5. Copy any osgi config files to the $LIFERAY_HOME/osgi/configs folder.
    6. Copy a license xml file to the $LIFERAY_HOME/deploy folder.
    7. Copy data/document_library folder from your previous bundle
    8. Ensure that any application server configurations made in your previous bundle are also made in the new service pack or update bundle.
    9. Ensure that any additional customizations made or deployed in your previous bundle are also made or deployed in the new service pack or update bundle.
    10. Clean up the cache folders within DXP's {$LIFERAY_HOME}:
      1. Delete the $LIFERAY_HOME/osgi/state folder.
      2. Empty the $LIFERAY_HOME/Work folder.
      3. Empty the $LIFERAY_HOME/tomcat-version/temp folder.
      4. Empty the $LIFERAY_HOME/tomcat-version/work folder.
    11. Consult the DXP Release Notes portlet to determine if there are any upgrade processes in the destination service pack or update.
    12. Consult the DXP Release Notes portlet for any Important Changes relevant to your installation.
    13. Consult the Upgrade Processes for Fix Packs in DXP 7.3 and Above article to decide your process for updating from the source service pack or update to the destination service pack or update.
    14. Shut down the previous DXP instance.
    15. Start the new DXP instance or run Database Upgrade Tool.

Additional Information

Was this article helpful?
1 out of 1 found this helpful