Adding a Swift CLI backup location

Add a Swift CLI backup location.

Add a Swift CLI backup location.

Important: The Backup Service requires control over the data and structure of its destination locations. The backup destinations must be dedicated for use only by OpsCenter. Any additional directories or files in those destinations can prevent the Backup Service from properly conducting a Backup or Restore operation.

cluster_name.conf

The location of the cluster_name.conf file depends on the type of installation:
  • Package installations: /etc/opscenter/clusters/cluster_name.conf
  • Tarball installations: install_location/conf/clusters/cluster_name.conf

Prerequisites

Install a Swift CLI container to store your backup data.

Procedure

  1. To enable Swift CLI for backup, add use_swift_cli to the cluster_name.conf:
    [labs]
    use_swift_cli = True
    Note: Backing up to Swift is currently a labs feature.
  2. Optional: To set a delay before allowing the Openstack Swift backup to be verified, add swift_cli_sync_status_delay_seconds to cluster_name.conf.
    [labs]
    swift_cli_sync_status_delay_seconds = N
    The swift_cli_sync_status_delay_seconds default is 10 seconds.
  3. Install the Swift client on each DSE node of the monitored DSE cluster:
    pip install python-swiftclient==3.7.0
  4. Restart opscenterd.
  5. Access the Create (or Edit) Backup dialog:
  6. In the Create or Edit Backup dialog, under Location, click +Add Location.
    The Add Location dialog appears.
  7. Select OpenStack Swift as the backup Location.
  8. Select the Credentials Source. Provide the required credential information.
    Credentials SourceCredential Fields
    User-Supplied Credentials
    • Container Name
    • Sub Folder (optional)
    • Authentication Endpoint
    • User
    • Key
    Detect Swift Enviromental Variables
    • Container Name
    • Sub Folder (optional)
    Note: If any of your credentials are incorrect, your location will not validate.
  9. Click Save Location.

    The newly added Open location displays in the Location pane of the Create or Edit Backup dialog.

    Click the edit icon to the edit a location and its retention policy if applicable. Click the delete icon to delete a location. The On Server location cannot be deleted.

  10. Optional: For scheduled backups, indicate how long the snapshot data should be retained by selecting a Retention Policy. Retain All (default) saves the snapshot data indefinitely. Or, define a set period of time. After the snapshot data is older than the time set in Retention Policy, the snapshot data is deleted.

    DataStax strongly recommends setting a retention policy to periodically remove backups. This practice helps to avoid long-term performance issues caused by an excessive number of backups.

  11. Click Save Location.

    The newly added OpenStack Swift location displays in the Location pane of the Create or Edit Backup dialog.

  12. Click Save Backup or Create Backup as applicable.