Documentation

Backup Service Overview

Maintaining regular backups is vital to protecting your project’s data. The DXP Cloud backup service stores iterations of environment data that can be used to restore your environments if needed. These backups include both the Liferay DXP Database and the full contents of the LIFERAY_HOME/data folder.

The backup service is one of several services available in DXP Cloud.

From the Backups page in any environment, you can create backups, view or download retained backups, and restore an environment from a backup.

You can also configure the backup service to meet your project’s needs via the DXP Cloud console or the backup service’s LCP.json file.

See the Backup service limitations section for more information.

The Backups Page

From the Backups page in any environment, you can view backup service information and retained backups, create manual backups, and more.

Note

The Backups page is only available in production environments for backup service versions older than 4.3.5.

Follow these steps to access the Backups page:

  1. Click on Backups in the menu on the left from any environment.

View backup history, create manual backups, and more from the Backups page in any environment.

From here, you can perform the following tasks:

  • View Backup Info: You can quickly view backup service information for the chosen environment. This includes the frequency of automated backups, the backup retention period, and timestamp information for the next scheduled backup, the latest created backup, and the oldest retained backup.

  • View Backup History: You can view the full list of retained backups in the chosen environment. Each entry lists the backup’s name, size, and time of creation.

  • Create Manual Backups: You can manually create a backup of the chosen environment. See Creating a Manual Backup for more information.

Note

Backup timestamps are displayed automatically based on your browser location, while backup schedules are based on the UTC±00 time zone.

From the Backups page, environment administrators also have access to the Actions button (⋮) and can download retained backups or restore environments.

For more information and instructions on how to perform these actions, see Downloading and Uploading Backups and Restoring Data from a Backup.

Administrators can download backups or restore an environment from the Backups page.

Creating a Manual Backup

To manually backup your environment from the Backups page, click on Backup Now. This process can take several minutes or hours depending on the size of your services.

Once started, the backup service icon will indicate a backup is in progress, and a new backup will appear in the Backup history.

The backup service icon will indicate a backup is in progress, and a new backup will appear in the Backup history.

Warning

Backups created while data is actively changing on your Liferay instance risk creating inconsistent data. To ensure a completely consistent backup, coordinate with your database administrator to freeze updates while you perform a manual backup.

Clicking View logs redirects you to the Logs page, where you can view the backup stages in real-time. You can also view backup logs in the Logs tab of the backup service’s page.

See Log Management for more information about viewing service logs.

Configuring the Backup Service

You can configure the backup service to meet your project’s needs via the DXP Cloud console or the backup service’s LCP.json file.

See Environment Variables Reference for a list of variables you can use to configure the backup service.

Important

Whenever the backup service is reconfigured, the backup service will restart and may stop receiving requests for some minutes or behave differently depending on the configuration.

Configuring the Backup Service via the DXP Cloud Console

Follow these steps to configure the backup service via the DXP Cloud Console:

  1. Navigate to an environment where the backup service is deployed.

  2. Click on Services in the environment menu.

  3. Click on the Backup service.

  4. Click on the Environment Variables tab.

    Navigate to the backup service's variables tab in your environment.

    You can also access the backup service’s page by clicking on Backup in the environment’s Overview page.

  5. Add variables from the Environment Variables Reference list to configure the backup service.

  6. Click on Save Changes.

Apart from regular environment variables, you can also set Secret variables via the DXP Cloud console. See Managing Secure Environment Variables with Secrets for more information.

Configuring the Backup Service via the Backup LCP.json File

Follow these steps to configure the backup service via its LCP.json file:

  1. Use a text editor to open the backup LCP.json file located at the following path: /{your_project_name}/backup/LCP.json.

    Note

    If you are using version 3.x.x services, then the backup LCP.json file is located at the following path: /{your_project_name}/lcp/backup/LCP.json.

  2. Scroll down to the environment section.

     "env": {
       "LCP_BACKUP_FOLDER": "/opt/liferay/data",
       "LCP_DATABASE_SERVICE": "mydatabase",
       "LCP_MASTER_USER_PASSWORD": "mypassword"
     },
    
  3. Add variables from the Environment Variables Reference list to configure the backup service.

  4. Save the file and deploy to your project to implement the configuration.

See Configuration via LCP.json for more information about configuring environment services via their LCP.json files.

Scheduling Automated Backups and Cleanups

Determining how frequently backups are created and removed can help protect your data and optimize storage. Only production environments can have scheduled backups.

Warning

Backups created while data is actively changing on your Liferay instance risk creating inconsistent data. Configure your backup schedule to create backups during times with reduced activity to mitigate the risk of data inconsistency. To ensure a completely consistent backup, coordinate with your database administrator to freeze updates while you perform a manual backup.

Use the following variables per environment to customize when backups are created and removed:

  • Automated Backups: Add the LCP_BACKUP_CREATE_SCHEDULE variable with a cron scheduling value to set the frequency of automated backups.

  • Automated Cleanups: Add the LCP_BACKUP_CLEANUP_SCHEDULE variable with a cron scheduling value to set the frequency of automated backup cleanups.

  • Retention Period: Add the LCP_BACKUP_RETENTION_PERIOD variable with a numerical value (between 1-30) to set the number of days backups are retained before being removed by automated cleanups.

Note

Both standard and non-standard cron scheduling syntax are based on the UTC±00 time zone. When using non-standard cron syntax, automated backups and cleanups run at the start of the specified value. For example, @daily runs backups every day at 00:00 UTC.

The following LCP.json example creates backups every 12 hours (i.e., 00:00 and 12:00 UTC) and performs monthly cleanups that remove backups over 30 days old:

 "env": {
   "LCP_BACKUP_FOLDER": "/opt/liferay/data",
   "LCP_DATABASE_SERVICE": "mydatabase",
   "LCP_MASTER_USER_PASSWORD": "mypassword",
   "LCP_BACKUP_CREATE_SCHEDULE": "0 0,12 * * *",
   "LCP_BACKUP_CLEANUP_SCHEDULE": "@monthly",
   "LCP_BACKUP_RETENTION_PERIOD": "30"
 },

Environment Variables Reference

Name Default Value Description
LCP_BACKUP_CLEANUP_SCHEDULE 0 1 * * * This variable schedules automated cleanups using cron scheduling syntax. Cleanups remove all backups that exceed the backup retention period.
LCP_BACKUP_CREATE_SCHEDULE [5-55][0-1] * * * This variable schedules automated backups using cron scheduling syntax. In versions 3.2.1 and above of the backup service, if no value is specified then a random default will be created.
LCP_BACKUP_FOLDER /opt/liferay/data The Liferay folder to back up.
LCP_BACKUP_RESTORE_SCHEDULE N/A This variable schedules automated restores using cron scheduling syntax. Intended for use with Disaster Recovery environments.
LCP_BACKUP_RETENTION_PERIOD 30 This variable determines which backups are removed during scheduled cleanups. Select the number of days backups are retained before being removed by cleanups. The maximum retention period is 30 days.
LCP_DATABASE_SERVICE database The database service's ID.
LCP_DBNAME lportal The database name.
LCP_DEBUG_LOG false Enables debug logging for the Backup service. Set to true or false.
LCP_MASTER_USER_NAME dxpcloud The master username.
LCP_MASTER_USER_PASSWORD LCP_PROJECT_MASTER_TOKEN The master password.