Install Tools on macOS

This page describes how to install Aerospike Tools on macOS.

Prerequisites

• macOS 13 (Ventura) or newer
• Your system must meet the prerequisites described in Tools requirements.

Download the package

See Download Aerospike Tools for more details on manual or automated downloads of Tools packages.

In the example below, replace VERSION with the tools version you want to download, or browse for available downloads in the latest directory.

wget -O aerospike-tools.tgz https://download.aerospike.com/artifacts/aerospike-tools/VERSION/aerospike-tools_VERSION_macOS_x86_64.pkg

Forget the previously installed tools

If you have already installed the Tools, you might need to “forget” the previously installed version, to avoid potential conflicts with the new version.

To see what version of Tools is currently installed:

pkgutil --pkgs | grep 'aerospike.tools'

Run the following command to forget the previous installations (where x.y.z is the current version):

sudo pkgutil --forget com.aerospike.tools.x.y.z

Install Aerospike Tools

Install the downloaded package by double-clicking the package file and following the prompts.

Verify installation

Verify the package installation:

$ pkgutil --pkgs | grep 'aerospike.tools'

If security is enabled for your Aerospike cluster, provide the username and password each time you verify one of the tools.

Verify asadm

$ asadm --version

Aerospike Administration Shell
Version 3.1.0

Verify aql

$ aql --version

Aerospike Query Client
Version 9.1.1

Verify asinfo

$ asinfo --version
----
Aerospike Information Tool
Version 5.2.0

Verify asbackup

$ asbackup --version

Aerospike Backup
Version 4.4.3

Verify asrestore

$ asrestore --version

Aerospike Restore
Version 4.4.3