Recovering from a disaster

Reinstall your analytics subsystem, restore your analytics CR, secrets, and your database backup.

About this task

Analytics subsystem backups can be restored in the same environment where they were taken, or in a different environment that has the same network configuration, endpoints, and deployment profile. You cannot restore an analytics subsystem backup in a different network environment, form factor, or deployment profile. If you want to move your API Connect deployment to a different form factor or change endpoints, see Migrating from v10 to v10 on a different form factor.

Procedure

  1. Install the replacement analytics subsystem, configuring the same ai-endpoint as your original installation.
    Follow the installation procedures for your platform:

    Refer to your infrastructure configuration backup to check the ai-endpoint. Also, if you disabled local storage, you must configure this in your analytics CR before installation.

  2. Update the analytics CR on your replacement installation with the analytics backup settings and any other analytics features you configured in your previous installation.
    Your previous analytics settings are in your infrastructure configuration backup. If you are installed on Cloud Pak for Integration or OpenShift with the top-level CR, then add these settings to the spec.analytics section of your APIConnectCluster CR.
  3. Re-create the analytics secrets that you backed up in your infrastructure configuration backup:
    1. Create the backup credential secret from your backup file: analytics-backup-secret_backup.yaml. 
      kubectl -n <analytics namespace> apply -f analytics-backup-secret_backup.yaml
    2. If you are using the analytics offload feature, then create the offload secret from your backup file: analytics-offload-secret_backup.yaml. 
      kubectl -n <analytics namespace> apply -f analytics-offload-secret_backup.yaml
    3. If your object-store has a self-signed CA certificate, then create the secret that contains the certificate from your backup file. 
      kubectl -n <analytics namespace> apply -f analytics-objstore-CA-secret_backup.yaml
    4. If you manually created or customized any other analytics subsystem certificates, then restore those secrets from their backup files. 
      kubectl -n <analytics namespace> apply -f <backup filename>
  4. Restore the analytics database: Restoring the analytics database.