Migration from legacy tools

The backup and restore CLI tools underwent a major architectural change with the launch of Aerospike Backup Control (absctl), which provides the backup and restore subcommands.

This page explains the breaking changes and how to migrate from the legacy asbackup and asrestore tools.

For more information and downloads, see the following GitHub repositories:

• absctl: The Go-based backup and restore CLI tools
• backup-go: The Go backup library used by the new tools
• aerospike-tools-backup: The legacy C-based backup tools

Prerequisites

The absctl CLI supports Aerospike Database 5.7.0 and later. For older Aerospike Database versions, you must use a legacy tools package with asbackup and asrestore.

absctl supports the following operating systems:

• macOS (arm64/amd64)
• Windows (arm64/amd64)
• Linux (arm64/amd64) - .deb and .rpm packages are provided.

Upgrade from an older version

To upgrade, remove the old versions of the backup tools or the tools package, then download and use the new tools.

Linux

Debian

1. Download the Debian package from the absctl release page.
2. Remove old tools by running dpkg -r aerospike-tools. Removing the old tools package also removes asbench, aql, and asadm.
3. Install new tools with dpkg -i ABSCTL_DEB.

RPM

1. Download the RPM package from the absctl release page.
2. Remove old tools by running rpm -e aerospike-tools. Removing the old tools package also removes asbench, aql, and asadm.
3. Install new tools with rpm -i ABSCTL_RPM.

Windows

1. Download the .zip package from the absctl release page.
2. Unzip it.
3. Run the binary.

macOS

1. Download the .tar.gz package from the absctl GitHub release page.

2. Unzip it.

3. Remove the old backup tools.

   rm -rf /usr/local/bin/asbackup
   rm -rf /usr/local/bin/asrestore

4. Copy new tools:

   cp absctl /usr/local/bin/absctl