Adding a Swift Command Line Interface (CLI) backup location

About this task

Add a Swift CLI backup location.

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.

Prerequisites

Install a Swift CLI container to store your backup data.

Procedure

Locate the cluster_name.conf file to edit. The location of this file depends on the type of installation:
- Package installations: /etc/opscenter/clusters/cluster_name.conf
- Tarball installations: install_location/conf/clusters/cluster_name.conf
To enable Swift CLI for backup, add use_swift_cli to cluster_name.conf:
```
[labs]
use_swift_cli = True
```
Backing up to Swift is currently a Labs feature.
Optional: To set a delay before allowing the Openstack Swift backup to be verified, using the default delay, add swift_cli_sync_status_delay_seconds to cluster_name.conf.
```
[labs]
swift_cli_sync_status_delay_seconds = N (1)
```
1 The delay default is 10 seconds. Add = N to the delay statement to change the default value, where N is a numeric value of your choosing.
Install the Swift client on each DSE node of the monitored DSE cluster:
```
$ pip install python-swiftclient==3.7.0
```
Restart opscenterd.
Access the Create (or Edit) Backup dialog.
In the Create or Edit Backup dialog, under Location, click +Add Location.

The Add Location dialog appears.
Select OpenStack Swift as the backup Location.

Select the Credentials Source. Provide the required credential information.

Credentials Source	Credential Fields
User-Supplied Credentials	Container Name Sub Folder (optional) Authentication Endpoint User Key
Detect Swift Enviromental Variables	Container Name Sub Folder (optional)

Credentials Source

Credential Fields

User-Supplied Credentials

Container Name
Sub Folder (optional)
Authentication Endpoint
User
Key

Detect Swift Enviromental Variables

Container Name
Sub Folder (optional)

If any of your credentials are incorrect, your location will not validate.

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 edit a location and its retention policy if applicable. Click the delete icon to delete a location. The On Server location cannot be deleted.
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.
Click Save Location.

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

Adding a Swift Command Line Interface (CLI) backup location

About this task

Prerequisites

Procedure

Was this helpful?

Give Feedback