Troubleshooting problems with the IBM Fusion backup and restore service

Use the following information to troubleshoot problems when you run backup and restore jobs in IBM Fusion.

IBM Fusion backup and restore logs

Collect logs related to backup and restore in the IBM Fusion console.

  1. Click the Help (?) icon and select Support logs.
  2. In the Support logs page, click Collect logs +.
  3. In the Create a log package page, select Backup & Restore and then click Create.
  4. In the Support logs page, click the three vertical dots of the log package entry that was created and select Download.

    The log package is downloaded to your workstation.

IBM Software Hub backup and restore logs

Collect IBM Software Hub backup and restore logs by running the cpd-cli oadp gather info command.

Notes:

IBM Fusion OADP is in the ibm-backup-restore project (namespace).

By default, IBM Fusion is installed in the ibm-spectrum-fusion-ns project.

  1. Log in to Red Hat® OpenShift® Container Platform as a cluster administrator.
    ${OC_LOGIN}
    Remember: OC_LOGIN is an alias for the oc login command.
  2. Run the following command:
    cpd-cli oadp gather info \
--gather-cpdbr-logs-only \
--tenant-operator-namespace=${PROJECT_CPD_INST_OPERATORS} \
--namespace=ibm-backup-restore \
--additional-namespaces=ibm-spectrum-fusion-ns \
--insecure-skip-tls-verify \
--log-level debug \
--verbose
    Tip: For more information about this command, see oadp gather info.

Manually running restore posthooks

After a restore is completed, you might need to run restore posthooks to bring up some services that are not available. Do the following steps:

  1. Get the IBM Software Hub instance (tenant) pod:
    TENANT_POD=$(oc get po -l component=cpdbr-tenant,icpdsupport/app=br-service -o name -n ${PROJECT_CPD_INST_OPERATORS})
  2. Run restore post-hooks:
    oc exec -n ${PROJECT_CPD_INST_OPERATORS} $TENANT_POD -- /cpdbr-scripts/cpdbr-oadp restore posthooks --hook-kind=checkpoint --include-namespaces=${PROJECT_CPD_INST_OPERANDS},${PROJECT_CPD_INST_OPERATORS}
  3. Restore operators visibility to the namespaces to ensure that all installed services are available.
    oc exec -n ${PROJECT_CPD_INST_OPERATORS} $TENANT_POD -- /cpdbr-scripts/cpdbr/cpdbr-cpd-operators.sh restore-namespacescope --operators-namespace ${PROJECT_CPD_INST_OPERATORS} --foundation-namespace ${PROJECT_CPD_INST_OPERATORS}