Skip to main content
Loading

Install Tools on macOS

These are instructions to install Aerospike Tools on macOS.

Prerequisites​

note

Support for M-series chips was added in Aerospike Tools version 8.1.0.

Support for macOS 10.15 (Catalina) was removed in Aerospike Tools version 7.2.1.

  • Requires macOS 11 (Big Sur) or newer
  • Verify that your system satisfies the prerequisites that are described in Tools Requirements

Download the package​

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

wget -O aerospike-tools.pkg https://download.aerospike.com/artifacts/aerospike-tools/latest/aerospike-tools__macOS_x86_64.pkg # replace x86_64 with arm64 for M-series

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​

Verify the package installation:

pkgutil --pkgs | grep 'aerospike.tools'
com.aerospike.tools.x.y.zzz

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

The output looks like this:

Aerospike Administration Shell
Version 2.2.0

Verify aql​

aql --version

The output looks like this:

Aerospike Query Client
Version 5.2.0
C Client Version 5.2.0
Copyright 2012-2020 Aerospike. All rights reserved.

Verify asinfo​

asinfo --version

The output looks like this:

Aerospike Information Tool
Version 5.2.0

Verify asbackup​

asbackup --version

The output looks like this:

Aerospike Backup Utility
Version 3.7.2
C Client Version 5.2.0
Copyright 2015-2021 Aerospike. All rights reserved.

Verify asrestore​

asrestore --version

The output looks like this:

Aerospike Restore Utility
Version 3.7.2
C Client Version 5.2.0
Copyright 2015-2021 Aerospike. All rights reserved.
Last updated on