Skip to main content
We are excited to be a part of AWS re:Invent 2024. Visit us at booth #1844 in Las Vegas.More info
Loading

Aerospike Tools Release Notes

Download all versions of Aerospike Tools here.

Tools 11.1.1​

Release date: November 11, 2024

Summary​

This version fixes minor bugs in some tools and removes support for macOS 12.

Platform Support​

This version removes support for macOS 12 for all Tools packages. [TOOLS-2981]

Bug Fixes​

  • asadm The manage truncate command was failing if a set did not exist on all cluster nodes. [TOOLS-2976]
  • asadm health -v was logging the Aerospike edition as "community," even though Federal Edition was in use. [TOOLS-2977]
  • asadm The Build column for info net did not display the FE tag before the version. [TOOLS-2978]
  • asconfig was not handling sindex-stage-size values correctly. [TOOLS-2979]
  • aql Running the help function for some commands was causing AQL to crash. [TOOLS-2982]

Individual Tools Versions​

Known Issues​

Tools 11.1.0​

Release date: October 1, 2024

Summary​

This version adds support for Aerospike Database 7.2, fixes minor bugs in some tools, and adds support for Ubuntu 24.04.

Bug Fixes​

  • asbackup State file is not uploaded to S3 when --state-file-dst is an S3 path. [TOOLS-2941]
  • asbench Default parameters cause batch * threads warning. [TOOLS-2961]
  • aql aql cannot store boolean type in MAP, LIST, or JSON elements. [TOOLS-2962]

New Features​

  • [all tools] Add support for Ubuntu 24.04 LTS. [TOOLS-2912]
  • [asconfig, asadm] Add support Aerospike Database 7.2. [TOOLS-2967][TOOLS-2964] [TOOLS-2965][TOOLS-2966]

Individual Tools Versions​

Known Issues​

Tools 11.0.2​

Release date: July 2, 2024

Summary​

This version fixes mixed Aerospike cluster version backups with asbackup, missing table output for asadm, and a security issue.

Bug Fixes​

  • asadm info namespace usage command is not reporting object stats when the storage engine is pmem. [TOOLS-2930]
  • asbackup 5.x/6.4 cluster scan fix (based on C client 6.6.3). [TOOLS-2942]

Security​

  • asadm Upgrade dependency cryptography to address CVE-2024-2511. [TOOLS-2945]

Known Issues​

Individual Tools Versions​

Tools 11.0.1​

Release date: May 29, 2024

Summary​

This version fixes a bug with asbackup/asrestore that was causing write errors on restore.

Bug Fixes​

  • asrestore Restore fails with intermittent TLS write errors due to an underlying issue in the C Client. [TOOLS-2927]

Known Issues​

Individual Tools Versions​

Tools 11.0.0​

Release date: April 30, 2024

Summary​

This version implements a variety of feature requests and improvements to usability and reliability. Highlights include adding Aerospike Database 7.1 support, adding configuration file support to asconfig, and moving the generate command from asadm to asconfig.

Breaking Changes​

New Features​

  • asadm Support new index-memory configuration parameters and metrics in Aerospike Database 7.1. [TOOLS-2893]
  • asadm Use schemas from schemas repository for asadm autocomplete. [TOOLS-2873]
  • asconfig Support Aerospike 7.1 configurations including evict-indexes-memory-pct and indexes-memory-budget. [TOOLS-2894][TOOLS-2874]
  • asconfig Add config file support. [TOOLS-2752]
  • asconfig Add support for a YAML configuration file. [TOOLS-2846]
  • uda Add support for a YAML configuration file. [TOOLS-2750]

Improvements​

  • asadm Add build details to the version command output. [TOOLS-2840]
  • asbackup Update C client to 6.6.0. [TOOLS-2899]
  • asbackup Add build details to the version command output. [TOOLS-2842]
  • asbench Add build details to the version command output. [TOOLS-2843]
  • asconfig Add build details to the version command output. [TOOLS-2841]
  • asconfig The validate command should print the name of failing config sections. [TOOLS-2777]
  • aql Add build details to the version command output. [TOOLS-2844]
  • asloglatency Add build details to the version command output. [TOOLS-2839]
  • uda Add build details to the version command output. [TOOLS-2837]
  • Support relocation of the Tools rpm. [TOOLS-2897]

Bug Fixes​

  • asadm asadm healthcheck puts bin names header and text on system_free_mem_pct output. [TOOLS-2895]
  • asconfig No error is printed when the validate command fails with a non-zero exit code. [TOOLS-2857]
  • asconfig Generated configs may rarely contain invalid empty string fields. [TOOLS-2887]

Security​

  • asadm Fix NULL pointer dereference. [TOOLS-2860]
  • asadm Fix observable timing discrepancy. [TOOLS-2861]
  • asconfig Fix CVE-2023-45288 vulnerability. [TOOLS-2904]
  • uda Fix infinite loop. [TOOLS-2878]

Known Issues​

Individual Tools Versions​

Tools 10.2.1​

Release date: February 1, 2024

Summary​

Tools 10.2.1 adds Aerospike server log collection to asadm, the ability to generate a configuration file from a running Aerospike node to asconfig, and the prefer-racks flag to asbackup, along with other features, improvements, and fixes. The ability to generate a configuration file from a running node in asadm is now deprecated.

New Features​

  • asadm Add the ability to aggregate local and remote Aerospike server logs to send to support with one command. [TOOLS-2607]
  • asbackup Implement --prefer-rack flag. [TOOLS-2646]
  • asconfig Add a generate command to asconfig to generate a configuration file from a running node. [TOOLS-2790]

Improvements​

  • asadm The collectinfo command should only create sysinfo.log and copy the aerospike.conf if localhost is an aerospike node. [TOOLS-2653]
  • asadm Add -n option to netstat command in collectinfo to prevent hostname/port name resolution. [TOOLS-2809]
  • asadm Add a disclaimer with metadata to asadm's generate config command. [TOOLS-2810]
  • asadm Deprecate asadm's generate config command. [TOOLS-2831]
  • asinfo Support running asinfo in environments where asadm can not be found in the path. [TOOLS-2813]

Bug Fixes​

  • asadm Healthcheck incorrectly reports storage under configured for single-node failure. [TOOLS-2824]
  • asbackup Fix memory leaks caused by overwriting configuration defaults. [TOOLS-2804]
  • asbackup Performing more than 1 restore using the shared library leaks memory. [TOOLS-2802]
  • asbackup Backup estimation is inaccurate when record count is less than replication factor. Switch estimation to use effective replication factor. [TOOLS-2751]

Known Issues​

Individual Tools Versions​

Tools 10.1.0​

Release date: December 14, 2023

Summary​

This version implements a variety of improvements to enhance performance, usability, and reliability. Tools 10.1.0 also integrates Aerospike Secret Agent with asbackup and adds a validate command to asconfig.

Bug Fixes​

  • asadm The manage config namespace command cannot change index-type configuration parameters. [TOOLS-2768]
  • asadm The asadm with modifier is doing a wildcard match when '*' is not used. [TOOLS-2656]
  • asadm The generate config command does not correctly report shadow devices. [TOOLS-2782]
  • asadm The generate config command does not correctly report xdr.dc.namespace shipped/ignored sets and bins [TOOLS-2783]
  • asadm The generate config command does not correctly generate namespaces with data-in-memory true. [TOOLS-2797]
  • asconfig Support the drv-mem logging context. [TOOLS-2799]

New Features​

  • asadm Collect info should run generate config for all nodes. [TOOLS-2695]
  • asbackup Integrate asbackup and asrestore with the Aerospike secret-agent. [TOOLS-2539]
  • asconfig Support a database version header in config files. [TOOLS-2692]
  • asconfig Add a validate command. [TOOLS-2715]

Improvements​

  • asadm Use the generated Aerospike Database 7.0 schema. [TOOLS-2771]
  • asadm Upgrade cryptography from 41.0.5 to 41.0.7. [TOOLS-2791]
  • asconfig Use the generated Aerospike Database 7.0 schema. [TOOLS-2772]

Known Issues​

Individual Tools Versions​

Tools 10.0.1​

Release date: November 28, 2023

Summary​

Tools 10.0.1 adds support for managing secondary indexes on blob bins.

Bug Fixes​

  • asadm The manage sindex create command does not support blob bin-type introduced in Database 7.0. [TOOLS-2766]
  • asbackup Support backup and restore of secondary indexes on blob bins. [TOOLS-2767]

Known Issues​

Individual Tools Versions​

Tools 10.0.0​

Release date: November 8, 2023

Summary​

Tools 10.0.0 adds Aerospike Database 7.0 support to all tools in the package and removes the truncate command from aql. We recommend updating your local tools before performing an upgrade. For more details, see Upgrade to Aerospike Database 7.0.

  • Tools 10.0.0 ends support for the following operating systems: [TOOLS-2769]
  • Debian 10 [TOOLS-2742]
  • Red Hat Enterprise Linux 7 [TOOLS-2743]
  • Oracle Linux 7 [TOOLS-2744]
  • Amazon Linux 2 [TOOLS-2745]
  • CentOS 7 [TOOLS-2746]

Breaking Changes​

  • aql Remove the truncate command from AQL. [TOOLS-2708]

Bug Fixes​

  • asadm List view does not display namespace device usage statistics. [TOOLS-2683]
  • aql AQL segmentation fault when running show sets and a set-name contains the invalid : character. [TOOLS-2699]
  • asadm The info set command does not show the correct Quota Used% when data-in-memory is true. [TOOLS-2705]
  • asadm manage truncate ns fails with Unrecognized input when --no-warn is used. [TOOLS-2714]
  • asadm The info namespace object command returns "ERROR: Unable to find any Aerospike nodes" when connecting to Aerospike CE. [TOOLS-2717]
  • asadm Asadm does not correctly parse server LDAP error codes. [TOOLS-2693]

Improvements​

  • aql Display warning when using show bins on Aerospike Database 7.0 or later. [TOOLS-2716]
  • asadm Add Record Quota to info set command to accompany the existing Quota (now Size Quota) column. [TOOLS-2706]
  • asadm Show error if show statistics bins is called with Aerospike Database 7.0 and later. [TOOLS-2700]
  • asadm Support Aerospike Database 7.0 Config Changes. [TOOLS-2669]
  • asconfig Support Aerospike Database 7.0 config changes. [TOOLS-2671]
  • asconfig Align --version output with asadm and asinfo. [TOOLS-2529]
  • asconfig Only display usage information for input validation errors. [TOOLS-2673]
  • uda Support Aerospike Database 7.0 metric changes. [TOOLS-2670]

Security​

  • uda Upgrade uda dependencies to address rapid-reset http2 and XSS vulnerability. [TOOLS-2704]

Known Issues​

  • Known Issues: Tools
  • asadm does not support creating an secondary index on blob bins (added in Database 7.0).
  • asbackup does not backup secondary indexes on blob bins.

Individual Tools Versions​

Tools 9.2.1​

Release date: October 10, 2023

Summary​

This version of Aerospike Tools adds the new, beta, generate config command to asadm which captures an Aerospike node's dynamic configuration as a usable configuration file.

Bug Fixes​

  • asconfig sindex-type with value shmem is not parsed correctly. [TOOLS-2674]
  • asadm show stop-writes does not report if stop-writes are triggered using storage-engine device or storage-engine pmem metrics. [TOOLS-2679]
  • asadm Asadm's show config command displays incorrect values for the security.ldap context. [TOOLS-2697]

New features​

  • asadm Asadm should generate dynamic configuration in the format of the configuration file. [TOOLS-2541]

Upcoming changes​

Known Issues​

Individual Tools Versions​

Tools 9.1.0​

Release date: August 30, 2023

Summary​

This version of Aerospike Tools adds asconfig schema support for Aerospike Database 6.4, and bug fixes and improvements to asadm and asbackup.

Bug Fixes​

  • asadm show pmap does not consistently return results for all nodes in specific tls scenarios. [TOOLS-2267]
  • asadm show statistics displays cluster_key as inf or a float in some cases. [TOOLS-2570]
  • asrestore Restore from S3 may hang after opening ---s3-max-async-downloads backup files. [TOOLS-2611]
  • asconfig stop-writes-count and stop-writes-size Aerospike configuration parameters are parsed incorrectly if they are greater than max int64. [TOOLS-2622]
  • asbackup Some bins are lost when using --parallel and --bin-list. [TOOLS-2624]
  • asbackup Unable to continue S3 backup when backup token expires. [TOOLS-2630]
  • asadm The asadm --timeout is not respected when a node is unreachable. [TOOLS-2644]
  • asconfig Parse sindex-type from Aerospike configuration files. [TOOLS-2648]

Improvements​

  • asadm Do not make requests to a node that was deemed unreachable during cluster discovery. [TOOLS-2645]

New features​

  • asconfig Support Aerospike Database 6.4 configuration. [TOOLS-2616]

Upcoming changes​

Known Issues​

Individual Tools Versions​

Tools 9.0.0​

Release date: July 26, 2023

Summary​

This version of Aerospike Tools supports changes in Aerospike Database 6.4.

Bug Fixes​

Improvements​

  • Aerospike Tools support for Amazon Linux 2023 and Debian 12. [TOOLS-2472][TOOLS-2594]

  • asadm Traceback shown in collectinfo mode when malformed or non-existent archive provided. [TOOLS-2599]

  • asadm upgrades bundled dependencies to cryptography 41.0.2 and pyOpenSSL 23.2.0. [TOOLS-2608]

  • When asadm displays values in microseconds, it labels the value with a u character instead of a 'mu' character (Unicode \u03bcs) to avoid an exception thrown by a machine with a locale not set in UTF-8, such as in Docker containers that default to the ASCII locale. [TOOLS-2609]

  • When asloglatency displays values in microseconds, it labels the value with a u character instead of a 'mu' character (Unicode \u03bcs) to avoid an exception thrown by a machine with a locale not set in UTF-8, such as in Docker containers that default to the ASCII locale. [TOOLS-2610]

New features​

  • asadm warns the user upon startup if a cluster, namespace, or set, is in a stop writes state. [TOOLS-2516]

  • The asadm commands info sindex and info namespace usage display relevant metrics for sindex-type flash. [TOOLS-2562]

  • asrestore now includes the flag --validate to parse specified backup files without restoring the data from them, and to return a non-zero exit code when encountering corrupted files. [TOOLS-2495]

Breaking changes​

  • asrestore has a known issue (TOOLS-2569): Using the --s3-bucket restore option with Amazon S3 causes a malformed URL in the request. The --s3-bucket option has been removed from asbackup and asrestore. [TOOLS-2559]

    Work-around: Specify the S3 bucket in the directory or file name, instead of with the --s3-bucket option in asrestore.

  • asbench workload options support batch reads, writes, and deletes. This changes the behavior of the --batch-size option, which now enables all batch mode operations for the SIZE number of records specified. Added are the --batch-read-size, --batch-write-size, and batch-delete-size options to specify an operation with a specific SIZE number of records for that operation. [TOOLS-2474][TOOLS-2560]

Upcoming changes​

Known Issues​

Individual Tools Versions​

Previous releases​

Release notes for previous versions of Aerospike Tools: Aerospike Tools Release Notes.

Last updated on