Information for: DEVELOPERS   PARTNERS   SUPPORT

Backing up sites

Cloud Platform provides many different back up options. For information about backups in Cloud Platform, see Taking backups. In addition to these back up options, Site Factory hosted-websites can also leverage full site back ups.

Using the Site Factory Management Console, you can create backups of your Site Factory-hosted websites. Each backup may include the website’s complete docroot directory, database, public files, and private files, all in a .tar.gz format suitable for exports.

You can create and download website backups using the Site Factory Management Console, and restore a website from a backup. You can also use the Site Factory REST API to create, list, and delete backups and to restore a website from a backup.

For procedures that you can use to exclude sensitive credentials, keys, or other private information from stored backups, see Storing sensitive information outside of your codebase.

Site Factory stores your backup files in the g/files directory. You can access this location to delete unwanted files.

For example,

[email protected]:/mnt/files/testacsf01live/sites/g/files$ du -sh      mxsain126/
17G mxsain126/

Note

The acsf-tools repository (also included with BLT) provides more backup scripts for Site Factory websites using Drupal 9. For more information, see Managing sites on a cluster with Drush.

Permissions

To create and download backups, you must have a role with the necessary permissions.

  • Users with the platform admin role have permission to create and download backups of all websites.
  • Users with the site builder role have permission to create backups of their websites and to download backups they have created.

Creating a backup

To create a backup of a website, complete the following steps:

  1. Sign in to the Site Factory interface.

  2. Find the website you want to back up, and then open its actions menu.

    Select "Back up site" from the site actions menu

  3. Click Back up site.

  4. In the Create site backup page, select the components you want to back up:

    Select components to back up

  5. Click Back up.

After your backup completes, you will receive an email letting you know the backup is now available on the Site Backups page. Backups can take several minutes to complete for small websites, but larger websites can take much longer to complete.

Partial backups

The site backup process allows partial file transfers. If a partial backup occurs, an email with the missing files is sent to the user who initiated the backup.

In the Site Factory management console, the Complete column indicates whether the backup was full or partial. A notification is displayed in the Complete column next to the listed backup when a backup is incomplete.

Partial backup notification

In the REST API, a partial backup is displayed as a “complete” field in the return body.

Viewing available backups

You can view and download your website backups on the Site Backups page:

  1. Sign in to the Site Factory interface.
  2. In the administrative menu at the top of the page, click Sites.
  3. At the bottom of the left-hand column, click All my site backups.

The backups are created with the site name, plus a timestamp from when the backup was created. To sort the table by name, by date, or by stack (if you have more than one stack) click the column heading you want to sort by.

Note

Backups that are more than one year old are automatically deleted. However, records of these backups may still appear in the user interface. For more information, see the Site Factory Product and Services Guide.

To restore a backup, identify the desired backup and in the Actions column, click Restore in the backup’s row:

View the list of backups

Note

When you create backups using the Site Factory REST API, you can use the label request parameter to modify the backup name.

Downloading backup files

To download a website backup file to your local computer, find the backup that you want to download on the Site Backups page and click the corresponding Download link.

Restoring from a backup file

Important

Site Factory non-production environments don’t make automated daily backups. Site Factory subscribers must create on-demand backups if necessary for their development process.

For information about using a backup file to restore a website, see Restoring a site from a backup.

More information