IBM Software Hub backup and restore issues
This section lists the troubleshooting tips and tricks during backup and restore of IBM Software Hub.
Original namespace as destination for IBM Software Hub application
- Problem statement
- OpenShift® restore from IBM Storage Protect Plus does not force you to select the original namespace as destination for IBM Software Hub application.
- Impact
- From IBM Storage Protect Plus user interface, IBM Software Hub restore fails whenever you do not select the original namespace as the target destination to restore to.
- Resolution
- Whenever you restore IBM Software Hub from IBM Storage Protect Plus user interface, ensure that you select the
original namespace as the restore destination.
These steps are applicable while you backup and test restore of IBM Software Hub applications. For more information about the procedure, see https://www.ibm.doc/docs/en/SSQNUZ_4.5_test/cpd/admin/online_bar_fusion_spp.html.
Tethered namespace issues
- Problem statement
- For IBM Software Hub Application type, you can tether secondary or other namespaces to the primary IBM Software Hub platform namespace. However, after a successful restore, the IBM Fusion application associated with the IBM Software Hub namespace does not restore the tethered namespace.
- Resolution
-
- Uninstall
cpdbr-oadpand reinstall it. - After you add the tethered namespaces, restart the
isf-application-controller-manager -xxxxpod that is within theibm-spectrum-fusion-nsto force a reconcile.. - In about five minutes, run the following command to verify whether the
fappis updated to include the tethered namespace inspec.includedNamespacesoc get fapp -n ibm-spectrum-fusion-ns cpd-instance -o yaml
- Uninstall
IBM Software Hub backup of zen namespace fails partially in IBM Storage Protect Plus user interface
- Problem statement
- For an on-demand backup of a single application from a policy that has multiple applications assigned, a snapshot backup is taken only for that selected application but the copy backup is initiated for all of the applications assigned to the policy. This behavior causes the copy backup of the applications without a snapshot backup to fail. This issue does not impact the application selected for the ad-hoc backup.
Backup fails for the platform with error in EDB Postgres cluster
- Cause
- Labels and annotations in the EDB Postgres cluster resources were not updated after a switchover of the EDB Postgres cluster's primary instance and replica.
- Diagnosis
- For example, in IBM Fusion, the backup fails at the
Hook: br-service hooks/pre-backupstage in the backup sequence.In thecpdbr-oadp.logfile, you see the following error:time=<timestamp> level=info msg=cmd stderr: Error: cannot take a cold backup of the primary instance or a target primary instance if the k8s.enterprisedb.io/snapshotAllowColdBackupOnPrimary annotation is not set to enabled
- Resolution
- The following workaround will automatically run before you create a backup. This workaround is
useful if you set up automatic backups.Note: This resolution works only for online backup and restore.
- Download the edb-patch-aux-ckpt-cm.yaml file.
- Run the following
command:
oc apply -n ${PROJECT_CPD_INST_OPERATORS} -f edb-patch-aux-ckpt-cm.yaml - Retry the backup.