Restoring a Cloud Pak for Data online backup to the same cluster with IBM Storage Fusion

Important: IBM Cloud Pak® for Data Version 4.6 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.6 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

In combination with the Cloud Pak for Data OADP backup and restore utility, you can restore an online backup of a Cloud Pak for Data instance to the same cluster with IBM® Storage Fusion.

About this task

In IBM Storage Fusion 2.5.2, you can use only the backup and restore (legacy) service to restore a backup. For more information about this service, see Backup and Restore (Legacy).

Best practice: You can run the commands in this task exactly as written if you set up environment variables. For instructions, see Setting up installation environment variables.

Ensure that you source the environment variables before you run the commands in this task.

Procedure

  1. Delete the Cloud Pak for Data instance project (namespace) and any tethered projects.
    oc delete namespace ${PROJECT_CPD_INSTANCE}
    oc delete namespace ${PROJECT_TETHERED}
  2. In IBM Storage Fusion, go to Applications and select the application to restore.
    Important: Select only one application to restore at a time. Do not select applications that end with :resources.
  3. Select Restore.
    You are shown all the backups that you can restore from.
  4. Select the backup that you want to restore and click Restore.
    Note: If Cloud Pak for Data operator install plans in the cluster are set to the manual approval strategy (installPlanApproval: Manual), you must approve the install plans as the operators are restored. Otherwise, the restore process will not progress. For more information about operator install plans, see Install plan.

What to do next

When the IBM Spectrum® Protect Plus restore job has completed, all resources are restored. However, the Cloud Pak for Data platform and services might need more time for the services to reconcile and start up before you can start using them. In Cloud Pak for Data, check that all service instances are restored and in good status.
  1. Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example:
    cpd-cli manage login-to-ocp \
    --username=${OCP_USERNAME} \
    --password=${OCP_PASSWORD} \
    --server=${OCP_URL}
  2. Get the status of all services.
    cpd-cli manage get-cr-status \
    --cpd_instance_ns=${PROJECT_CPD_INSTANCE}
  3. Verify that all services show Completed.

If your Cloud Pak for Data deployment has services that connect to an external database, and you followed the recommendation to back up the database at the same time that you back up Cloud Pak for Data, restore the database backup that was taken at the same time as the Cloud Pak for Data backup.