Backup and restore of running containerized applications is a critical task. Without this capability, organizations run the risk of disruption of service and unplanned downtime. This article outlines the architecture, setup, and configure the OADP operator for backup and restoring the Manage application in the OpenShift cluster. OADP is the OpenShift API for the Data Protection operator. This open-source operator sets up and installs Velero on the OpenShift platform, allowing users to backup and restore applications.

Architecture

1.  Configure S3 Storage to store backup files

• Login to your IBM Cloud account.
• Create and configure object storage service.

Multiple storage backends are supported including IBM Cloud Object Storage, Amazon S3, Google Cloud Storage, Azure Blob Storage, and Minio.

2.  Setup OADP operator

• Log on to the OpenShift web console as the cluster administrator.
• In the navigation panel, click Operators> OperatorHub.
• To install the OADP Operator, enter OADPin the search field. Click the OADP Operator card.

• Click on the OADP card and install.

• Click Install.

    2.1  Create Credentials Secret

• Create a secret file with the following content. For example, cloud-cred.yaml:

[default]
aws_access_key_id=<storage_access_key_id>
aws_secret_access_key=<storage_secret_access_key>

• Create secret

oc create secret generic cloud-credentials
--namespace openshift-oadp
--from-file cloud - <path-to-secret-file>
​

• For example,

oc create secret generic cloud-credentials --namespace openshift-adp --from-file cloud=cloud-cred.yaml​

   2.2  Create the DataProtectionApplication Custom Resource

• Create an instance for DataProtectionApplication.
  • Add s3Url in config and update bucket in objectStorage section.
  • For example, dataprotectionapplication-velero-sample.yaml

spec:
  backupLocations:
    - velero:
        config:
          profile: default
          region: us-east-1
          s3ForcePathStyle: 'true'
          s3Url: 'http://s3.us-east.cloud-object-storage.appdomain.cloud'
        credential:
          key: cloud
          name: cloud-credentials
        default: true
        objectStorage:
          bucket: my-bucket-name
          prefix: velero
        provider: aws
  configuration:
    restic:
      enable: true
    velero:
      defaultPlugins:
        - openshift
        - aws
  snapshotLocations:
    - velero:
        config:
          profile: default
          region: us-west-2
        provider: aws
​

• After DataProtectionApplication is reconciled, verify BackupStorageLocations is created.

  
    2.3  Verify Install

• Verify all the correct resources have been created, the command “oc get all -n openshift-adp”should look similar to:

3.  Create Backup

• In the navigation panel, go to installed Operators. Select OADP and create a Backup instance.
• Update “includedNamespaces” in the yaml with your Manage namespace/project. For example, backup-all-manange-sample-1.yaml
• Check the backup status.

  3.1  Backup Details and Troubleshooting

• Navigate to Workloads->Pods in openshift-adp project.
• Click on Velero pod. Go to Terminal tab. Run the following commands to get backup details

Retrieve backup:
./velero  get backups

Describe backups:
./velero backup describe <backup_name> --details

Retrieve backup logs
 ./velero backup logs <backup_name>

 
4.  Create Restore

• In the navigation panel, go to installed Operators. Select OADP and create a Restore instance.
• Restore needs to be done in two steps. Restore service accounts in step1 and Manage project resources in step 2.
• Sample restore-all-manage-sample-1.yaml and restore-all-manage-sample-2.yaml
  • Update “includedNamespaces” in the yaml with your Manage namespace/project and backup name.

    4.1  Restore Details and Troubleshooting

• Navigate to Workloads->Pods in openshift-adp project.
• Click on Velero pod. Go to Terminal tab. Run the following commands to get restore details.

Retrieve restores:
./velero get restores

Describe restores:
./velero restore describe <restore_name>

Retrieve restore logs
 ./velero restore logs <restore_name>
​

Schedule Backup
You can specify a schedule to run backups. The duration can be specified using a combination of minutes (m), and hours (h).

Go to Schedule by navigating to Schedule tab or click on create instance on Schedule card.  For example,  schedule-all-manage-sample-1.yaml

#Maximo
#AssetandFacilitiesManagement