Skip to main content

Overview

Aerospike includes many useful tools for managing your system. Most tools run on the server, but some are run from other nodes such as maintenance machines, which manage backups.

The Tools Package

The most frequently used Aerospike tools are conveniently contained in the Aerospike Tools Package.

Installing the Tools

When you install the Aerospike server the Tools Package is also installed. However, it is often desired to have tools installed locally as well. For details on installation, see Aerospike Tools Installation.

Tools configuration file

Tools can be configured by using tools configuration files.

For more details, see Aerospike Tools Configuration File.

Aerospike Admin: asadm

The asadm command-line tool gives an immediate view into the cluster: its size, and its health. It also allows you to administer and configure the cluster. This tool works in a variety of modes:

  • With a running cluster, or "live-cluster mode". In live-cluster mode, it provides functions to execute Aerospike commands across the entire cluster.
  • With collectinfo files, or collectinfo-analyzer mode.
  • With Aerospike log files, or log-analyzer mode.

For details on usage, see asadm.

Aerospike Info Protocol Tool: asinfo

The powerful, low-level asinfo tool can make requests to an individual server via Aerospike's info protocol. It is useful for gathering statistics and setting a variety of tuning parameters. It can be wrapped by higher level scripts for a variety of needs. These same asinfo commands can also be used within an asadm shell to issue commands to all nodes in a cluster.

For details on usage, see Aerospike Information Tool (asinfo).

Aerospike Data Browser and Lightweight Admin Tool: aql

This command-line tool can be used for basic validation and testing of most database functionality, as well as managing indexes and UDFs.

For details on usage, see AQL.

Back Up and Restore Data: asbackup and asrestore

Use a node outside the cluster and pull out all the cluster's data into a directory of text files or a single text file. You can also restore the data from one of these files. Source code is included.

Log Latency Tool: asloglatency

Aerospike contains a number of settings that allow latency issues in a server to be diagnosed. This tool analyzes a logfile and displays the different components of a transaction.

For details on usage, see Log Latency Tool (asloglatency).

For details on usage, see Backup and Restore -- asbackup and asrestore.

Other Tools (Not in the Tools Package)

Other tools not available in the tools package are available to download independently.

Aerospike Certification Tool: ACT

ACT is a pair of programs for testing and certifying Flash/SSD device performance for Aerospike Database data and index storage. ACT measures latency during a mixed load of read and write operations while modeling the Aerospike Database server's I/O pattern as closely as practical.

Aerospike Loader: asloader

Removed from Tools Package: 6.2.0

This tool can help in migrating data from any other database to Aerospike. You can dump data from different databases in .DSV format and use this tool to parse and load them in Aerospike server.

For details on usage, see Aerospike Loader (asloader).

Speeding up cold starts with asmt

Aerospike Shared-Memory Tool (asmt) lets you perform faster restarts of nodes in an Aerospike Database Enterprise Edition cluster after rebooting their host servers.

For details, see Aerospike Shared-Memory Tool (asmt)

Collection Data Type Validation: asvalidation

Removed from Tools Package: 6.0.3

Run this tool if you suspect problems with your collection data type bins. The tool looks for problems, such as duplicate keys or misordered lists, some of which can be automatically corrected.

For details on usage, see Aerospike Validation Tool.