Recovering service backups

Restore a service configuration from the service backup.

Before you begin

  • Ensure that the IBM Storage Fusion Backup & Restore (Legacy) service is not installed. This recovery replaces all existing objects with the objects in the service backup.
  • If service protection requires rebuilding the hub cluster, backup your application data to a cloud-based storage. Also, backup any defined local S3 storage on your cluster to a cloud storage. The recovery procedure in this topic restores only the metadata for backups, which got saved to the cloud storage.

    For example, you have a MinIO storage service defined and configured with a backup storage location that uses the local storage. The MinIO application must have its cloud backup policy to restore the service first, and then any applications backed up to the local S3 storage.

    You can use the local storage for sensitive applications, but ensure that you save the database to the cloud or another S3 location within the firewall. Restore the local storage location from a cloud backup before you attempt to restore other applications backed up to that storage service.

  • The IBM Storage Fusion namespace must remain the same between the service backup and service restore. When you recover a service backup to a new IBM Storage Fusion deployment, make sure that the deployment uses the same namespace as backup.

Procedure

  1. Go to Backup & Restore > Service protection.
    The Service protection page is displayed. Here, Configure Service backups and Recover service from backup tiles are available.
  2. Select Recover service from backup.
    The Add a backup location wizard page is displayed.
  3. In the Location type tab, select the location type and click Next.
    The available location types are Microsoft Azure, IBM Cloud®, S3 compliant object storage, Amazon Web Services, and Storage protect.
    The Location credentials tab page is displayed.
  4. In the Location credentials tab, enter the credentials to connect to your location. For SSL secured object storage locations, enter the Secret name for certificate.
    Provide the same S3 information or credentials as provided in the original Service Protection backup configuration.
  5. Click Connect.
    Option Description
    No service backups available If no service backups are available, then No backups discovered message is displayed.
    Note: It may take a while for the discovery of existing service backups to complete.
    Service backups are available Initiate restore by using either of the following methods:
    • Click Restore service.
    • From the ellipsis overflow menu of a service backup, select Restore.
    • Click Backup to display the Backup details slide out pane, and then click the Restore icon (
      restore icon

      ).

      .
    The Restore service page is displayed.
  6. Select a backup and click Restore.
    Note: This restore action reverts all Backup & Restore objects to the selected backup.

    When the Restore is in progress, the user interface disables Backup & Restore functions. However, you can still create CRs outside of the user interface.

  7. Do the following steps based on the scenario existing on your cluster:
    Option Description
    Empty cluster with no Backup & Restore (Legacy) No action required
    Empty cluster but Backup & Restore (Legacy) installed
    1. Type Recover.
    2. Click Initiate service restore.
    Note: The recover action restores all backup policy, location, policy assignment, CRs including the ones used by Backup & Restore (Legacy). However, any available Backup & Restore (Legacy) backups get deleted. If you need them, copy the backup CRs.
    The Service protection page is displayed. A Service restore is in progress notification message is displayed. You can monitor the progress of restore in the Summary section. When the restore begins, the service protection page gets replaced by a job summary page for restore.

What to do next

  1. Application backups are available to restore before the backup storage locations are connected. Wait for the backup storage location to be connected before you attempt to restore.
  2. Storage classes that are used by applications on the original cluster must exist or be created on the restored cluster before you attempt to restore the applications that use those classes.
  3. Scheduled backups resume after the service restore is complete. However, these backups fail until the applications are restored from a backup. You can ignore these failed backups. After the application is restored from a backup, subsequent backups will be successful.
  4. When you do a service protection restore, the Backed up applications page does not display the applications on the Spoke clusters that are not reconnected to the new Hub cluster. After a Spoke is manually reconnected, it may take a while for the backed up applications on that Spoke to appear on the page.