Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

Documents and Images Missing After Restoring Backup to PaaS

Written By

Daniel Carrillo Broeder

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.

Issue

  • After restoring a database and document library backup to a Liferay Cloud PaaS environment, the documents and images are missing.

Environment

  • Liferay DXP.
  • Liferay Cloud PaaS
  • Google Cloud Storage (GCS)

Resolution

  • Liferay Cloud PaaS environments use Google Cloud Storage (GCS) by default for improved backup restore performance.
  • GCS relies on Simple File System Store directory structure:
    • If your on-premise instance uses the AdvancedFileSystemStore (or any other), a file store migration is required in order to upload the backup.
  • Follow these steps to migrate your document library to be compatible with the structure used in GCS.
    1. Start your on-premise Liferay DXP server.
    2. Go to Control Panel > System Settings > File Storage > Simple File System Store Configuration and configure a new destination path.
      • For example, [Liferay Home]/data/SFSS/document_library.
      • Ensure the final directory is named "document_library", and is different from the directory used by the current used store.
    3. Go to Control Panel > Server Administration > Data Migration > Migrate Documents from one repository to another.
        • Select com.liferay.portal.store.file.system.FileSystemStore.
        • Do not check "Delete files from previous repository" and ensure sufficient storage space in the destination file system.
    4. Execute the migration and monitor the logs for the following message: 
      • Finished conversion for com.liferay.document.library.internal.convert.document.library.DocumentLibraryConvertProcess in <time>
    5. Update the file store configuration by adding the following to your portal-ext.properties file to verify that the migration was successful. 
      1. dl.store.impl=com.liferay.portal.store.file.system.FileSystemStore
  • Once verified, create and upload a new backup with the migrated document library using the Liferay Cloud CLI command: 
    lcp backup upload --project [Project name] --environment [Environment] --doclib [Path to document library folder] --database [Path to database .gz file]

Additional Information

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?