Skip to main content
Version: 2.8

Backup and restore with FADA

PXB’s integration with FlashArray Direct Access LUNs (FADA) provides seamless and efficient protection for containerized applications. Utilizing Direct Access LUNs ensures low-latency performance, while FlashArray enhances scalability and robustness. This combination simplifies Kubernetes workload backup and recovery, offering consistent and dependable data management across hybrid and multi-cloud environments. The following section outlines the prerequisites and provides instructions for performing backup and restore operations post integration.

Prerequisites

  • FlashArray (FA) Purity Version 5.3.0
  • FlashArray Purity version 6.6.11 in case of Azure Cloud Block Store
  • Portworx installed as a storage provisioner for FlashArray/CBS

Before you begin

  • Create a storage class with the following specifications:

    kind: StorageClass
    apiVersion: storage.k8s.io/v1
    metadata:
    name: px-sc-fada
    provisioner: pxd.portworx.com
    parameters:
    backend: "pure_block"
    csi.storage.k8s.io/fstype: ext4
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
  • Create a volume snapshot class based on Portworx CSI driver pxd.portworx.com with the following specifications:

    apiVersion: snapshot.storage.k8s.io/v1
    kind: VolumeSnapshotClass
    metadata:
    name: px-pure-snapshotclass-1732616962
    annotations:
    snapshot.storage.kubernetes.io/is-default-class: "true"
    spec:
    driver: pxd.portworx.com # Portworx CSI driver
    deletionPolicy: Retain # The snapshot will be retained even after the snapshot object is deleted
note

PXB currently supports backup and restore utilizing the following drivers for FADA:

  • KDMP (cross-cloud backup)
  • CSI
  • CSI + offload (KDMP)

Backup with FADA LUNs

  1. Refer to Create manual backup or Create scheduled backup until you get Create Backup window based on the type of the backup you want to create.

  2. In the Create Backup window:

  • Enter name for Backup: provide a relevant name for your backup

  • Backup location: choose the required backup location you have created previously from the drop-down

  • Cross Cloud Backup/Restore: Make sure this is disabled for Portworx volumes

  • Snapshot Class Mapping: facilitates mapping of your storage provisioner with volume snapshot class. Select the Volume Snapshot Class based upon the pxd.portworx.com CSI provisioner during backup and restore operations of FADA PVCs as shown in Create Backup and Restore Backup window illustrations. During restore, the data will be restored from the local CSI snapshot.

    • CSI Provisioner: lists the CSI provisioners associated with the PVCs present in the namespaces selected for the backup

    • Volume snapshot class: lists all the volume snapshot class (vsc) resources along with default vsc

    • Offload CSI snapshots to backup location: this option helps to upload both specs and PVC data to the backup location. If not checked during backup, only specs will be uploaded without PVC data. If the specified backup’s CSI snapshot is absent locally, data will be restored from the backup location. Restore fails for the PVCs if this option is not selected during backup.

    • Backup type: allows you to choose the type of backup required (manual or scheduled backup)

      • On a schedule: enable this option to create an object locked scheduled backup

      • Choose a schedule policy: select a schedule policy from the drop-down list

    • Pre-exec rule: select a rule from the drop drown to execute before the backup is created

    • Post-exec rule: select a post rule you want to execute after the backup is created

    • Backup Labels: any labels that you want to add to the backup you are going to create

    • NAMESPACES LIST: lists all the namespaces selected for backup creation

  1. Click Create.

You have now backed up your Portworx volumes on a backup location on FlashArray Direct Access LUNs. To view the backup you have created, from the home page, navigate to Clusters > Backups tab.

To know the type of driver that PXB has utilized to create a backup, navigate to the end of the backup row, click Vertical ellipsis and select View Json as shown below. You cal also search the driver type quickly with the search phrase: driver_name in the View Json's Inspect Data window:

Json output:

Restore with FA

  1. Refer to restore a backup until you get Restore Backup window.

  2. In the Restore Backup window, specify the following:

    • Name: name your restore object. You need this to identify the restore operation in the PXB web console.

    • Destination cluster: select the cluster you want to restore your backup to. This can be a different cluster from where the backup occurred.

    • Default restore: Portworx Backup’s default behavior for namespace, storageclass and project mapping:

      • Namespace mapping: the source and destination remain the same. If the namespace does not exist on the destination cluster to map, a namespace is created for the restore to happen.

      • Storageclass mapping: the source and destination remain the same, Portworx Backup expects that the destination storageclass already exists.

      • Project mapping: the source and destination remain the same, Portworx Backup expects that the destination project already exists.

    • Custom Restore: allows to select the namespaces and the destination storageclasses to back up. Choosing Custom Restore displays the following options:

      • StorageClass Mapping: choose the source and destination storageclass(s) to restore the backup data.

        • Source Storageclass(s): Portworx Backup picks the storageclass that belongs to the backup you want to restore.

        • Destination Storageclass(s): Select the storageclass to which you want to restore the backup.

          note

          The StorageClass Mapping options appear, only when you restore the backups created using Portworx or the KDMP driver. These options do not appear when you restore backups that are created using the native cloud driver.

          For more information about the StorageClass Mapping and its options, refer to the Restore PVCs across storage classes.

      • Namespace Mapping: choose the backup namespaces to restore using the following options:

        • Source Namespace(s): You can select a namespace, if you want the content from that namespace not to be restored.

        • Destination namespace(s): specify a namespace on the target cluster you want to restore this backup to. If the namespace does not exist, Portworx Backup tries to create it.

      • Project Mapping: this option appears only if the backup resides on the Rancher cluster and the destination cluster where you want to restore is also a Rancher cluster associated with Rancher API credentials. Choose the backup projects to restore using the following options:

        • Source Project(s): List of projects (residing on Rancher cluster) which were backed up in the selected backup for restore

        • Destination Project(s): specify the required project that resides on the destination cluster and has required configuration parameters as that of the project in Rancher source cluster.

Related topic: