Restoring a Cloud Pak for Data online backup on the target cluster with IBM Storage Fusion

Restore a Cloud Pak for Data online backup to the target cluster with IBM Storage Fusion.

Before you begin

If you previously restored a Cloud Pak for Data backup, delete the Cloud Pak for Data instance projects (namespaces) before you try another restore. The projects must be deleted regardless of whether the previous restore was successful or unsuccessful. For details, see Restoring an online backup prerequisite tasks.

About this task

You cannot restore a backup to a different project of the Cloud Pak for Data instance.

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

Restoring Cloud Pak for Data applications

  1. In IBM Storage Fusion on the hub cluster, expand Backup & restore and click Backed up applications.
  2. If installed, restore the ${PROJECT_SCHEDULING_SERVICE} application by selecting it, clicking Actions icon and then clicking Restore.

    Otherwise, go to step 8.

  3. In the Restore page, select Choose a different cluster to restore the application in., select the target cluster, and click Next.
  4. In the next restore page, select a backup to restore and click Next.
  5. In the next restore page, do not change any default options and click Restore.
    Note: Make sure that the Include missing etcd resources checkbox is selected.
  6. In the Confirm restore dialog, click Restore.
  7. Wait for the application restore to complete and its resources to be fully running before starting to restore the next application.
  8. Repeat these steps to restore the Cloud Pak for Data instance (tenant) application (${PROJECT_CPD_INST_OPERATORS}).

    When the ${PROJECT_CPD_INST_OPERATORS} application is restored, the Cloud Pak for Data instance project (${PROJECT_CPD_INST_OPERANDS}) is restored at the same time.

    Note: If Cloud Pak for Data operator install plans in the source 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.
  9. To monitor restore jobs, go to Backup & restore > Jobs and click the Restores tab.
  10. Select a job to view the inventory of what resources will be restored and the progress of the restore flow.

What to do next

When the restore jobs are 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. Log the cpd-cli in to the Red Hat® OpenShift® Container Platform cluster:
    ${CPDM_OC_LOGIN}
    Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
  2. Get the status of all services.
    cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}
  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.