Adding a Swift CLI backup location
Add a Swift CLI backup location.
Add a Swift CLI backup location.
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
Procedure
-
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. - 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
Theswift_cli_sync_status_delay_seconds
default is 10 seconds. -
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)
Note: 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 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.
- 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.