Aerospike tools
For the complete documentation index see: llms.txt
All documentation pages available in markdown.
This page describes the comprehensive suite of command-line utilities and services provided by Aerospike to manage, monitor, and optimize your database clusters.
To install CLI tools, see Install tools on Linux with a package manager. For other environments, see Install tools on macOS, Deploying Aerospike Tools with Docker, or Install tools on Linux from an archive for legacy tarball workflows.
CLI tools (individual packages)
The following tools are available as separate Linux packages on the Aerospike artifact repository and as per-tool macOS .pkg installers. Install only the tools you need.
| Tool | Linux package (DEB / RPM) | Description |
|---|---|---|
| Aerospike Admin (asadm) | aerospike-asadm | Monitor cluster health; manage ACLs, UDFs, and secondary indexes; change dynamic config; run tuning commands across nodes. |
| Aerospike Info (asinfo) | aerospike-asadm | Query nodes, collect stats, and set tuning parameters. Run cluster-wide with asadm. |
| Aerospike Quick Look (AQL) | aerospike-aql | Browse cluster data and manage user-defined functions (UDFs). See also Aerospike Voyager for a GUI alternative. |
| Aerospike Benchmark (asbench) | aerospike-asbench | Run highly configurable performance benchmarks with custom data formats and access patterns. |
| Aerospike Configuration (asconfig) | aerospike-asconfig | Configure the Aerospike Database or validate and view diffs for Aerospike configuration files. The same files can be used with IDE integration for Aerospike configuration files. |
Aerospike Backup Control (absctl) provides on-demand backup and restore from the command line. Its package is named absctl and is published separately from the tools above, so it requires its own repository configuration rather than the one described in Install tools on Linux with a package manager.
Deprecated tools
The monolithic aerospike-tools tarball and RPM/DEB bundle includes all the CLI tools listed above, plus asbackup and asrestore. Those two tools have no per-tool package; they ship only in the bundle. Both are deprecated in favor of absctl.
| Tool | Description |
|---|---|
| Backup (asbackup) | Legacy: back up a cluster to local directories or text files. |
| Restore (asrestore) | Legacy: restore backups to specific bins or sets. |
Non-packaged tools
The following tools are distributed or installed separately from the main tools package.
| Tool | Description |
|---|---|
| Aerospike Backup Service (ABS) | REST API service for automating backup and restore operations with VM or Docker. |
| Aerospike Certification Tool (ACT) | Test and certify Flash/SSD latency and I/O patterns for Aerospike storage. |
| Aerospike Shared-Memory Tool (ASMT) | Back up and restore shared memory segments for faster node restarts (Enterprise Edition). |
Aerospike Validation Tool (asvalidation) | Detects and repairs malformed collection data type (CDT) bins (Map and List). Install from GitHub releases. |
Aerospike Data Loader (asloader) | Ingest data from flat files (CSV, TSV, DSV) directly into a cluster. |
Aerospike Log Latency (asloglatency) | Analyzes Aerospike log files offline. |
Community-supported: AeroLab
Use AeroLab to quickly deploy dev and test clusters on Docker, AWS, or GCP. It is ideal for testing configuration changes, upgrades, and client applications.
Removed tools
- UDA: Removed in tools 12.0.0 with no replacement.