Troubleshooting problems with Portworx data replication

Collect and analyze log files to troubleshoot problems when you use Portworx to recover IBM Software Hub.

IBM Software Hub backup and restore logs

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

Tip: By default, the Portworx admin project (namespace) is kube-system.
  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=${OADP_OPERATOR_PROJECT} \
    --additional-namespaces=${PX_ADMIN_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}