Legacy Knowledge Base
Published Sep. 10, 2025

Moving Existing Data From an Old Liferay bundle to a New One

Written By

Laura Li

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

This article provides a checklist when you move your existing data from an old Liferay environment to a new one.

Resolution

  1. For database, please backup the database in old environment and import it to the new environment.
  2. For documents, they are stored under [LIFERAY_HOME]/data/document_library by default.

    Please copy all of the files to the same directory in the new environment.

    If you have configured new directory in System Settings, depending on the defined store dl.store.impl= in your portal-ext.properties, please make sure the documents can be accessed in the new environment.

  3. For your customized configurations, please copy them to the new environment. The common configuration files are listed, but not limited to the following:
    1. portal-ext.properties 

      The database connection related statements and the dl store related statements might need to be changed to use the correct one in your new environment.

    2. osgi related configurations

      If there is any customized configurations in the osgi/configs folder, please copy them to your new environment.

  4. For all of your customizations, please deploy them on to the new server.
  5. After moving these contents, please perform a full re-index in Control Panel > Server Administration in your new environment.
Did this article resolve your issue ?

Legacy Knowledge Base