Skip to content
Inviting nominations for the Champions of Scale - Nominate a leader building internet-scale data infastructure today! Nominate someone
Database ( latest 8.1.0 )
/Tools/Release notes

Aerospike Tools Release Notes

You can download all versions of Aerospike Tools on the Downloads page.

Tools 12.0.0

Release date: August 1, 2025

Summary

This version fixes minor bugs in some tools, fixes security vulnerabilities in the Aerospike Configuration Tool, and adds support for Aerospike Database 8.1.

Tools Package Changes

  • asloglatency: Removed Aerospike Log Latency from the tools package and into its own repo in aerospike-examples. [TOOLS-3086]
  • uda: Removed Unique Data Agent from the tools package. [TOOLS-3089]
  • aql: The aql tool is deprecated and scheduled to be removed from the Aerospike tools package. No new features will be added to aql. Data browsing alternatives include the Aerospike JDBC driver.

New Features

  • All tools now support increased minimum data-size configuration, from 256M to 512M. [TOOLS-3073]
  • asadm: Added support for use of the admin port in Database 8.1 or later. asadm will automatically recognize that it is connected to an admin port. admin-clear-std and admin-tls-std return non-tls admin port and tls admin port, if configured. [TOOLS-3072]
  • asadm: Added support for creating secondary indexes based on an expression. [TOOLS-3065]
  • asadm: Updated asadm to support the user-agents info command for listing clients with an active connection to the server. [TOOLS-3060]
  • asadm: Added support for PKI authentication changes by extending show users to display new information about the authentication modes available to each user. [TOOLS-3054]

Improvements

  • asadm: Removed the UDA integration from asadm. [TOOLS-3095]
  • Increased the max socket pool size for nodes in asadm from 3 to 16 to better handle asynchronous workloads. [TOOLS-3093]
  • asadm: Added comprehensive transaction monitoring capabilities to asadm. Users can now view detailed metrics for both monitors and provisionals across live clusters and collectinfo analysis. [TOOLS-3076]
  • asadm: Replaced sindex with sindex-list for the deprecated info command for listing sindexes. [TOOLS-3070]
  • asadm: Updated the unique data calculation in the summary command to be the sum of namespace uncompressed data divided by its replication factor. [TOOLS-3064]

Bug Fixes

  • asadm: Issuing an invalid info <subcommand>, like info random, was falling back to info, which gave a false impression that info random worked. asadm now clearly throws an error for invalid info subcommands.
  • asadm: Updated ss command syntax and header counting in asadm collectinfo. [TOOLS-3091]
  • asadm: asadm was showing incorrect information for Primary Index Used% when the primary index was on flash. [TOOLS-3063]
  • asadm: Improved asadm to handle abrupt connection closures. [TOOLS-3061]
  • asconfig: asconfig validate was failing when context namespace info was added to the logging stanza in aerospike.conf. [TOOLS-3046]
  • asconfig: The minimum value check was missing for max-record-size in asconfig validate. [TOOLS-3080]
  • asconfig: Validation of max-record-size config was failing if its value used a units suffix. [TOOLS-3074]
  • asconfig: The asconfig generate command was crashing when run against Community Edition. [TOOLS-3056]
  • asconfig: In some environments, the asconfig generate command was failing with “Error converting shadow device to list.” [TOOLS-3052]
  • asbackup: Fixed an issue that was resulting in an assertion in some cases when running asbackup as root. [TOOLS-3050]
  • asbench: Batch writes were not applying WRITE policies causing replace workloads to do reads. [TOOLS-3051]

Security

Individual Tools Versions

Known Issues

Tools 11.2.2

Release date: April 1, 2025

Summary

This version fixes a security vulnerability in the tools package.

Bug Fixes

  • asadm: Fixed security vulnerability. [TOOLS-2987]
  • asconfig: Fixed security vulnerability. [TOOLS-2987]
  • uda: Fixed security vulnerability. [TOOLS-2987]
  • AQL: Fixed security vulnerability. [TOOLS-2987]
  • asbench: Fixed security vulnerability. [TOOLS-2987]
  • asbackup: Fixed security vulnerability. [TOOLS-2987]

Individual Tools Versions

Known Issues

Tools 11.2.1

Release date: March 4, 2025

Summary

This version upgrades the C client versions and fixes security vulnerabilities in some tools.

Bug Fixes

  • asbench: Upgraded C client to 7.0.1. [TOOLS-2993]
  • AQL: Upgraded C client to 7.0.1. [TOOLS-2994]
  • asbackup: Upgraded C client to 7.0.3. [TOOLS-2995]
  • asadm: The manage roster stage observed command could be run on AP namespaces. [TOOLS-2996]
  • asinfo: The output of asinfo -v 'sets/<NAMESPACE_NAME>/<SET_NAME>' was missing newline characters. [TOOLS-3003]
  • asadm: Fixed handling for manage roster command with the unstable-cluster and cluster-not-specified-size options. [TOOLS-3012]
  • asadm: Updated command help for manage acl quotas role. [TOOLS-3013]

Security

  • Fixed CVE-2024-9143 vulnerability. [TOOLS-2987]
  • asadm Fixed CVE-2024-12797 vulnerability. [TOOLS-3011]

Individual Tools Versions

Known Issues

Tools 11.2.0

Release date: January 16, 2025

Summary

This version fixes minor bugs and security vulnerabilities in some tools, and adds support for Aerospike Database 8.0.

New Features

  • All tools: Added support for the database schemas in Aerospike Database 8.0. [TOOLS-2989] [TOOLS-2992]

Bug Fixes

  • asadm Fixed show latencies -v to show fabric histogram if enabled via manage config. [TOOLS-2984]
  • asadm now relays Aerospike Database error messages for info commands rather than matching strings. [TOOLS-2986]
  • uda Fixed vulnerability citrusleaf/unique-data-agent(main):go.mod - Incorrect Implementation of Authentication Algorithm in golang.org/x/crypto. [TOOLS-2997]
  • uda Fixed vulnerability citrusleaf/unique-data-agent(main):go.mod - Denial of Service (DoS) in golang.org/x/net. [TOOLS-2998]

Individual Tools Versions

Known Issues

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]
  • asbackup Fails if replication factor is greater than 100. Raise max replication factor from 100 to 256. [TOOLS-2890]

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 a secondary index on blob bins (added in Database 7.0).
  • asbackup does not back up 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

  • The deprecated AQL truncate command will be removed in an upcoming release. Use asadm manage truncate instead.

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

  • The deprecated AQL truncate command will be removed in an upcoming release. Use asadm manage truncate instead.

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

Tools 8.5.1

Release date: July 6, 2023

  • This release greatly improves asadm help output, adds Aerospike .conf to .yaml conversion to asconfig, and many other changes listed below.
  • Truncate functionality in AQL has been deprecated and will be removed in an upcoming release.

New Features

  • (ASCONFIG) Support converting Aerospike format conf to YAML. [TOOLS-2456]
  • (ASCONFIG) Add diff command to compare configuration files. [TOOLS-2534]
  • (ASCONFIG) Support Aerospike server 6.3 schema validation. [TOOLS-2544]
  • (ASCONFIG) Support STDIN for the convert command. [TOOLS-2565]

Improvements

  • (ASADM) Improve asadm help output. [TOOLS-2543]
  • (ASADM) Allow the `collectinfo` command to handle a blocking proxy. [TOOLS-2050]
  • (UDA) Align —version output with asadm and asinfo. [TOOLS-2126]
  • (ASBACKUP) —records-per-second docs should state that the limit is divided by thread count. [TOOLS-2436]
  • (AQL) Add deprecation warning to Truncate command in AQL. [TOOLS-2457]
  • (TOOLS) Remove unused files under cl_py and distributed under /opt/aerospike/lib/*py. [TOOLS-2558]
  • (ASCONFIG) Rewrite readme to include only build and test information. [TOOLS-2546]

Bug Fixes

  • (ASADM) ‘show dist object_size’ bucket ordering not quite right [TOOLS-2046]
  • (ASADM) KeyboardInterrupt sometimes causes exceptions in asadm. [TOOLS-2325]
  • (ASADM) Asadm’s `manage config` command shows an incorrect error message instead of a helpful one when a nonexistent namespace or datacenter is supplied. [TOOLS-2481]
  • (ASADM) Collectinfos created with asadm 2.14.0 and before throwing exceptions when loaded with asadm 2.15.0. [TOOLS-2538]
  • (ASADM) The `watch` command does not support auto-completion. [TOOLS-2550]

Security

  • (UDA) Update dependencies. [TOOLS-2568]
  • (BUILD) Update go in build containers to 1.20.5. [TOOLS-2535]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.4.0

Release date: May 31, 2023

  • This release adds the show users statistics and show stop-writes asadm commands. See more changes below.

New Features

  • (ASADM) Add a show stop-writes command. [TOOLS-2459]
  • (ASADM) Create a show users statistics command. [TOOLS-2470]
  • (ASBACKUP) Add the —s3-connect-timeout option. [TOOLS-2514]

Improvements

  • (ASADM) Display node fqdn in collectinfo mode tables similar to live-cluster mode. [TOOLS-2509]
  • (ASADM) No longer print messages like The parameter "param" must also be set. in asadm. [TOOLS-2527]

Bug Fixes

  • (ASADM) The show latencies command shows ~~ when a node has no histogram results. [TOOLS-2510]
  • (ASADM) Setting a namespace’s compression-level incorrectly displays that enable-compression must be set. [TOOLS-2512]
  • (ASADM) Running asadm show latencies using docker aerospike-tools fails with ‘ascii’ codec error. [TOOLS-2515]
  • (ASADM) An exception is thrown when running info xdr and a node is unreachable. [TOOLS-2528]
  • (UDA) Uda does not verify server certificate when using tls. [TOOLS-2522]

Security

  • (UDA) Update the UDA dependencies to address vulnerabilities. [TOOLS-2521]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.3.0

Release date: April 24, 2023

  • This release is the first to contain a beta release of asconfig. A tool for converting yaml to aerospike.conf format.

New Features

  • (AQL) Add the ability to limit the number of records returned from the select command. [TOOLS-2245]
  • (AQL) Support a limited double-where clause in aql. [TOOLS-2505]
  • (ASCONFIG) Allow user to convert YAML to asconfig format. [TOOLS-2428]

Improvements

  • (ASADM) If asadm is already running as root, don’t use sudo in front of collectinfo system commands. [TOOLS-2372]
  • (TOOLS) Build go tools with go 1.20.3. [TOOLS-2482]
  • (UDA) Update aerospike go-client to 6.12.0. [TOOLS-2504]

Bug Fixes

  • (AQL) Aql crashes when provided an incomplete EXECUTE, AGGREGATE, or SELECT command. [TOOLS-2511]
  • (ASADM) summary command output is missing “Cluster name”. [TOOLS-2149]
  • (ASADM) If security is enabled, collectinfo’s summary should show it under Active Features. [TOOLS-2448]
  • (ASADM) info sindex command incorrectly displays Keys, Avg Per Rec, and Avg Per Bin Val for servers before 6.0. [TOOLS-2468]
  • (ASADM) show latencies latency bucket aggregation is wrong. [TOOLS-2484]
  • (ASBACKUP) Restore is too slow when triaging many backup files in an s3 bucket. [TOOLS-2450]
  • (ASBENCH) A space between -P and the password triggers a password prompt. [TOOLS-2324]
  • (ASBENCH) -L option incorrectly requires an argument. [TOOLS-2473]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.2.0

Release date: March 24, 2023

  • First version to support Aerospike server 6.3.
  • Added support for Red Hat Enterprise Linux 9 (RHEL-9).
  • Added support for Ubuntu 22.04 LTS.
  • Removed support for Debian 10 (ARM64 only).
  • Removed support for Ubuntu 18.04 LTS.
  • Aerospike Tools 8.2.0 is a special release that includes support for Debian 9 in order to maintain compatibility with a fix for the Aerospike Server Enterprise Edition for US Federal.
  • This version and subsequent server Debian package software files (.deb) and Red Hat Package Manager files (.rpm) are now GPG Signed.

New Features

  • (ASADM) Display XDR filter information with show xdr filter command. [TOOLS-2200]
  • (ASADM) Add namespace level stats to show statistics xdr in asadm. [TOOLS-1941]
  • (ASADM) Add the ability to view quota defined on a set in the info set command. [TOOLS-2350]
  • (ASADM) Have consistent quit commands across aql and asadm. [TOOLS-2353]
  • (ASBACKUP) Add —directory-list to restore from multiple directories or S3 buckets. [TOOLS-2327]
  • (ASBACKUP) Add the —parent-directory option to use as a common prefix for —directory-list paths. [TOOLS-2371]

Improvements

  • (TOOLS) Upgrade C tools to openssl3. [TOOLS-2298]
  • (AQL) Deprecate —tls-cert-blacklist in aql. [TOOLS-1960]
  • (ASADM) Add a Storage Type column to ‘info sindex’. [TOOLS-2319]
  • (ASADM) Bundle asadm with Python 3.10.10. [TOOLS-2376]
  • (ASADM) Add sindex-type and usage statistics to the info namespace command in asadm. [TOOLS-2434]
  • (ASADM) Add the new used_bytes stat to info sindex. [TOOLS-2438]
  • (ASADM) Rename summary Cluster table “Active” and “Total” columns to include “Namespaces”. [TOOLS-2447]
  • (ASADM) Support server 6.3 configuration auto-completion. [TOOLS-2453]
  • (ASBACKUP) Upgrade aws-sdk-cpp to version 1.10.55. [TOOLS-2297]
  • (ASBACKUP) Deprecate --tls-cert-blacklist. [TOOLS-1963]
  • (ASBENCH) Deprecate --tls-cert-blacklist. [TOOLS-1962]
  • (UDA) Build uda with Go 1.19.5. [TOOLS-2340]
  • (ASBACKUP) Document that running with —node-list results in 16 concurrent scans. [TOOLS-2417]

Bug Fixes

  • (AQL) Aql does not properly pass the durable delete policy when executing a UDF. [TOOLS-2238]
  • (ASADM) Commas separators are no longer parsed correctly. [TOOLS-2310]
  • (ASADM) Unable to connect to the cluster from macOS x86 when TLS is enabled. [TOOLS-2337]
  • (ASADM) Asadm aborts with FATAL FIPS SELFTEST FAILURE on FIPS-enabled OS. [TOOLS-2355]
  • (ASADM) License unique data usage does not take into account the replication factor on servers before 3.15.1.3. [TOOLS-2375]
  • (ASADM) Collectinfo-analyzer does not show batch-index latencies. [TOOLS-2416]
  • (ASADM) show jobs scans shows an erroneous error message. [TOOLS-2421]
  • (ASADM) info namespace Used% aggregation can be incorrect when Total varies significantly between nodes. [TOOLS-2424]
  • (ASADM) collectinfo and show latencies fail with error with mixed server versions and latency data is unpopulated. [TOOLS-2439]
  • (ASADM) collectinfo --ignore-errors flag is not acknowledged is some cases. [TOOLS-2441]
  • (ASADM) show user and show roles stops returning output after the like modifier is used. [TOOLS-2443]
  • (ASBACKUP) Restore stops after 1000 s3 objects. [TOOLS-2309]
  • (ASBACKUP) Backup to AWS S3 is failing with fatal error after backing up all the records. [TOOLS-2323]
  • (ASBACKUP) —node-list does not work with IPv6. [TOOLS-2377]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.1.0

Release date: December 21, 2022

  • First version to support MacOS arm64 M-Series chips.

New Features

  • (TOOLS) Support MacOS arm64 M-Series chips. [TOOLS-2271]

Improvements

  • (AQL) Statically link OpenSSL on macOS to match other tools. [TOOLS-2284]
  • (ASBENCH) Statically link OpenSSL on macOS to match other tools. [TOOLS-2291]

Bug Fixes

  • (ASADM) Asadm fails to load config file when using --config-file. [TOOLS-2302]
  • (ASINFO) Asinfo calls wrong asadm when multiple asadm/asinfo bundles are present on the system. [TOOLS-2277]
  • (ASINFO) Remove ability to inject command through asinfo. [TOOLS-2278]
  • (ASBACKUP) Usage goes to a mix of stdout and stderr. [TOOLS-1445]
  • (UDA) Arm builds of uda incorrectly encodes entries in store file. [TOOLS-2304]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.0.4

Release date: December 12, 2022

  • Aerospike Tools version 8.0.4 is a special release that includes support for Debian 9 in order to maintain compatibility with all server releases affected by “TOOLS-2263 Backup file format changed for sindexes starting in asbackup 3.12.0”.

Improvements

  • (ASADM) Bundle asadm with Python 3.10. [TOOLS-2286]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.0.3

Release date: December 1, 2022

  • Aerospike Tools version 8.0.3 is a special release that includes support for Debian 9 in order to maintain compatibility with all server releases affected by “TOOLS-2263 Backup file format changed for sindexes starting in asbackup 3.12.0”.

Known Issues

  • This version contains vulnerability CVE-2022-46908 and is not recommended for use. Users should upgrade to version 8.0.4.
  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Tools 8.0.2

Release date: November 22, 2022

  • First version to support linux/arm64.
  • Requires Aerospike Server version 4.9 or later.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • BREAKING CHANGES
    • (AQL) Remove the ability to manage jobs in aql. [TOOLS-1911]
    • (AQL) Remove SYSTEM and PRINT commands from aql. [TOOLS-1917]
    • (AQL) Remove the ability to manage users and roles in aql. [TOOLS-2233]
    • (AQL) Remove the ability to manage indexes in aql. [TOOLS-2234]
    • (AQL) Remove support for most INFO commands from aql. [TOOLS-2235]
  • Functions deprecated in AQL/Tools 7.0 have been removed in AQL/Tools 8. Use asadm instead.
  • Removed support for Debian 9 Stretch LTS

Bug Fixes

  • (ASBACKUP) Backup file format changed for sindexes starting in asbackup 3.12.0. [TOOLS-2263]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 8.0.1

Release date: November 17, 2022

  • Do not use this version. Known Issue TOOLS-2263. Please use Aerospike Tools 8.0.2(asbackup 3.13.1) or Newer.
  • First version to support linux/arm64.
  • Requires Aerospike Server version 4.9 or later.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • BREAKING CHANGES
    • (AQL) Remove the ability to manage jobs in aql. [TOOLS-1911]
    • (AQL) Remove SYSTEM and PRINT commands from aql. [TOOLS-1917]
    • (AQL) Remove the ability to manage users and roles in aql. [TOOLS-2233]
    • (AQL) Remove the ability to manage indexes in aql. [TOOLS-2234]
    • (AQL) Remove support for most INFO commands from aql. [TOOLS-2235]
  • Functions deprecated in AQL/Tools 7.0 have been removed in AQL/Tools 8. Use asadm instead.
  • Removed support for Debian 9 Stretch LTS

New Features

  • (AQL) Support boolean data types in aql. [TOOLS-2247]

Improvements

  • (PACKAGING) Remove support for Debian 9 [TOOLS-2182]
  • (AQL) Support ARM64 Linux. [TOOLS-2175]
  • (ASADM) Support ARM64 Linux. [TOOLS-2169]
  • (ASBACKUP) Support ARM64 Linux. [TOOLS-2172]
  • (ASLOGLATENCY) Support ARM64 Linux. [TOOLS-2170]
  • (ASBENCH) Support ARM64 Linux. [TOOLS-2173]

Bug Fixes

  • (AQL) Reject queries that have more than one predicate in their WHERE clause. [TOOLS-2012]
  • (ASADM) Unable to specify node by IP if more than one node IP starts with the same number in the last octet. [TOOLS-2220]
  • (ASBACKUP) Fix interpretation of EOF in backup file namespace names. [TOOLS-2222]
  • (UDA) UDA does not support tls-capath flag. [TOOLS-2189]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.3.1

Release date: September 30, 2022

  • Do not use this version. Known Issue TOOLS-2263. Please use Aerospike Tools 8.0.2(asbackup 3.13.1) or Newer.
  • Requires Aerospike Server version 4.9 or later.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • Deprecated features will be removed in a future aql update.
    • (AQL) Deprecate the ability to manage jobs in aql.
    • (AQL) Deprecate INFO commands in aql.
    • (AQL) Deprecate the ability to manage indexes in aql.
    • (AQL) Deprecate the ability to manage users and roles in aql.
    • (AQL) Deprecate the SYSTEM and PRINT commands in aql.
  • Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Tools 8.0 release.

New Features

  • (ASBACKUP) Support backing-up and restoring sindexes on CDTs in server 6.1. [TOOLS-2088]

Improvements

  • (ASADM) Add sudo ethtool -S command to collectinfo. [TOOLS-1950]
  • (ASBACKUP) Revise asrestore option —batch-size help text. [TOOLS-2134]
  • (ASBACKUP) Add —compression-level option to asbackup help. [TOOLS-2133]
  • (ASBENCH) Deprecate -v in favor of -V to match other tools. [TOOLS-2157]
  • (ASBENCH) Align —version output with asadm and asinfo. [TOOLS-2144]

Bug Fixes

  • (TOOLS) Tools RPM advertises that it provides libraries which it should not. [TOOLS-2147]
  • (ASADM) The summary command does not show F- to indicate federal edition. [TOOLS-2166]
  • (ASADM) Running the summary command multiple times breaks the “OS Version” field. [TOOLS-2148]
  • (ASADM) info sindex state reads “Read-Only” instead of “Read-Write`. [TOOLS-2146]
  • (ASBENCH) Fix -V expected argument error. [TOOLS-2158]
  • (ASBENCH) Running —version exits with return code 255. [TOOLS-2125]
  • (ASBENCH) Reported version is incorrect for asbench 1.5. [TOOLS-2122]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.2.1

Release date: September 6, 2022

  • Requires Aerospike Server version 4.9 or later.
  • Support for macOS Catalina 10.15 removed.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • The asbackup tool does not currently support secondary indexes (SI) with context (ctx). Instead, asbackup displays a warning and skips backing up any SIs that have “ctx”. The secondary indexes without “ctx” will backup and restore as usual.
  • Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Tools 8.0 release.

Bug Fixes

  • (ASBACKUP) Memory leak in asrestore record uploader. [TOOLS-2137]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.2.0

Release date: August 30, 2022

  • TOOLS-2137 (ASBACKUP) Memory leak in asrestore record uploader can cause Out of Memory (OOM) with large workloads.
  • Requires Aerospike Server version 4.9 or later.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • The asbackup tool does not currently support secondary indexes (SI) with context (ctx). Instead, asbackup displays a warning and skips backing up any SIs that have “ctx”. The SIs without “ctx” will backup and restore as usual.
  • Support for macOS Catalina 10.15 will be removed in the next release.
  • Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Tools 8.0 release.

New Features

  • (ASADM) Add the ability to create sindexs on CDTs (Collection Data Types) by providing a context to the manage sindex create command. [TOOLS-2063]

Improvements

  • (ASADM) Add sindex cardinality to show sindex and info sindex commands. [TOOLS-2066]
  • (ASADM) Support POSIX compatible input in interactive mode. [TOOLS-2061]

Bug Fixes

  • (ASBACKUP)- Warn and skip backing up secondary indexes with context. [TOOLS-2121]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.1.1

Release date: August 23, 2022

  • TOOLS-2137 (ASBACKUP) Memory leak in asrestore record uploader can cause Out of Memory (OOM) with large workloads.
  • Requires Aerospike Server version 4.9 or newer.
  • The asinfo tool is now bundled with asadm to remove its dependency on python. 
  • The asinfo version has changed to pair with the asadm version.
  • The asadm and asinfo binaries are now installed under /opt/aerospike/bin/asadm/.
  • All Tools macOS builds are now built using GitHub actions.
  • Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Tools 8.0 release.

New Features

  • (ASADM) Optionally include the UDA’s raw store in the collectinfo file using the --agent-store flag. [TOOLS-1976]
  • (ASBACKUP) Estimate should include the total backup file size (gives size if -o would be used for a real backup). [TOOLS-2027]
  • (ASBACKUP) Allow a user to specify the number of c-client event loops to use in asrestore. [TOOLS-2022]
  • (ASBACKUP) Allow a user to set the scale factor for the exponential backoff retry strategy in asrestore. [TOOLS-2021]
  • (ASBACKUP) Disable batch-writes in asrestore with --disable-batch-writes. [TOOLS-2005]
  • (ASBACKUP) Configure the S3 API log level with --s3-log-level. [TOOLS-2003]
  • (ASBACKUP) Allow the user to specify the zstd compression level when running with compression enabled. [TOOLS-2000]
  • (ASBACKUP) Allow a user to set the batch size to use for batch write calls in asrestore. [TOOLS-1990]
  • (ASBACKUP) Allow a user to set the max number of async batch write calls in asrestore. [TOOLS-1989]
  • (ASBENCH) Expanded client policy support in asbench. [TOOLS-2055]
  • (ASBENCH) Add a read-replace workload. [TOOLS-1904]
  • (ASBENCH) Port the sleep-between-retries option from the Java benchmark tool. [TOOLS-1892]
  • (ASBENCH) Add an option to send and read the key to asbench. [TOOLS-1891]
  • (ASBENCH) Add a prefer-rack replica policy to --replica. [TOOLS-1890]
  • (ASBENCH) Port the expiration time option from the Java benchmark tool. [TOOLS-1886]
  • (ASBENCH) Add version to asbench. [TOOLS-1883]
  • (UDA) Add an API for grabbing the data store. [TOOLS-1967]

Improvements

  • (TOOLS) Add the uda to the tools package. [TOOLS-2018]
  • (ASADM) Info command for Federal Edition displays the build version as ‘6.0.0.0’ it could prepend the value with an ‘F-’. [TOOLS-2011]
  • (ASADM) Display license usage data per-namespace in the summary. [TOOLS-1979]
  • (ASADM) Include the time of the latest UDA entry used in the license usage calculation. [TOOLS-1978]
  • (ASADM) Optionally include UDA data-points where the cluster was unstable when calculating license usage by using the --agent-unstable flag. [TOOLS-1977]
  • (ASINFO) Bundle asinfo with asadm to remove python dependency. [TOOLS-2014]
  • (ASBACKUP) Allow passing an explicit S3 bucket name to use for backup/restore to/from AWS S3. [TOOLS-2081]
  • (ASBACKUP) Disallow --parallel when running a backup estimate. [TOOLS-2075]
  • (ASBACKUP) Give better warning when transactions fail with AEROSPIKE_ERR_FAIL_FORBIDDEN. [TOOLS-2057]
  • (ASBACKUP) Restore retry logic should use an exponential backoff strategy. [TOOLS-2020]
  • (ASBACKUP) Remove the extra per-thread stats given by asrestore. [TOOLS-1985]
  • (ASBACKUP) Improve asrestore to use batch writes against server versions >= 6.0. [TOOLS-1984]
  • (ASBACKUP) Improve asrestore to use async aerospike record-write operations. [TOOLS-1983]
  • (ASBACKUP) Rename --retry-delay to --sleep-between-retries. [TOOLS-1894]
  • (ASBACKUP) Check server version when using options that use filter expressions. [TOOLS-1885]
  • (ASBENCH) RU workload accepts optional pct-read-all-bins and pct-write-all-bins values. [TOOLS-2028]
  • (ASBENCH) Add a read-update-delete workload to asbench. [TOOLS-1898]
  • (ASBENCH) Separate tps for operations hitting or missing records. [TOOLS-1897]
  • (ASBENCH) HDR histograms should only record transaction latencies of read hits. [TOOLS-1896]
  • (UDA) Allow the uda to run on macOS. [TOOLS-2016]
  • (UDA) Support the tools package common astools.conf. [TOOLS-1952]
  • (UDA) Collect unique data usage at the namespace level. [TOOLS-1949]
  • (UDA) Credentials should follow exporter/server standard. [TOOLS-1945]
  • (UDA) Flag unique data points taken during migration. [TOOLS-1944]

Bug Fixes

  • (ASADM) LogAnalyzer fails when trying to hash logfile before it is converted to bytes. [TOOLS-2097]
  • (ASADM) Asadm does not correctly discover the cluster when using a DNS load-balancer. [TOOLS-2079]
  • (ASADM) The manage sindex delete command warning will incorrectly say that zero keys are indexed when using Server 6.0. [TOOLS-2068]
  • (ASADM) The manage sindex delete warning only gives the key cardinality of the principal. [TOOLS-2067]
  • (ASADM) Running asinfo using Tools version 7.0.3+ is throwing error “‘NoneType’ is not iterable”. [TOOLS-2064]
  • (ASBACKUP) Uninitialized as_record key value causes restore to exit before restoring record. [TOOLS-2092]
  • (ASBACKUP) Backup state file fails to save if multiple threads fail simultaneously. [TOOLS-2085]
  • (ASBACKUP) Backup with --node-list option is not resumable. [TOOLS-2083]
  • (ASBACKUP) Backup-to-file is not interruptible. [TOOLS-2082]
  • (ASBACKUP) Backup estimate and backup-to-file causes broken pipe/connection timeout warning on server. [TOOLS-1986]
  • (ASBACKUP) Backup fails if a node is not in the roster but part of the cluster. [TOOLS-1584]
  • (ASBENCH) A password should be prompted if no password follows the -P short option. [TOOLS-1934]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.0.5

Release date: June 2, 2022

  • Requires Aerospike Server version 4.9 or newer.
  • The asadm binary is now installed under /opt/aerospike/bin/asadm/.

Bug Fixes

  • (AQL) Aql segfaults when a record is inserted with a set name. [TOOLS-2042]
  • (ASADM) Asadm is slow to startup on macOS. [TOOLS-2015]
  • (ASADM) Asadm fails to startup when the tmp/ directory is mounted with the noexec option. [TOOLS-2025]
  • (ASADM) Asadm should calculate unique-data for versions 6.0 and later with a 39 byte discount. [TOOLS-2026]
  • (ASBACKUP) SIGPIPE causes asbackup to exit when backing up to AWS S3. [TOOLS-2006]
  • (ASBACKUP) Fix accidental dynamic linkage with libssl and libcrypto on some linux distros. [TOOLS-2031]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.0.3

Release date: April 26, 2022

  • Requires Aerospike Server version 4.9 or newer.

Bug Fixes

  • (AQL) Aql version is listed as “dev”. [TOOLS-2004]
  • (ASADM) Asadm fails to connect to the cluster when multiple service addresses are configured. [TOOLS-2002]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.0.2

Release date: April 14, 2022

  • Requires Aerospike Server version 4.9 or newer.

Bug Fixes

  • (ASADM) The --no-color flag does not work on table column separators. [TOOLS-1981]
  • (ASADM) The watch command does not display table output. [TOOLS-1982]
  • (ASADM) The pager command does not work if the system less binary is not compatible with .so files in asadm bundle. [TOOLS-1987]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Tools 7.0.0

Release date: April 7, 2022

  • Requires Aerospike Server version 4.9 or newer.
  • First release to support 6.0 changes.
  • S3 upload is now included with asbackup.
  • The Python interpreter is now included with asadm.
  • Removal/Breaking changes:
    • (AQL) Remove SLAP mode from aql.
    • (AQL) Remove the OPERATE command from aql. Consider using a UDF or a client library instead of OPERATE.
    • (AQL) Remove USE_SMD, REPLICA_ANY and LINEARIZE_READ settings from aql.

New Features

  • (ASADM) Add a show config security sub-command and remove redundant configuration params from show config service. [TOOLS-1468]
  • (ASADM) Create manage jobs kill all queries command in asadm. [TOOLS-1930]
  • (ASBACKUP) Allow backing up and restoring from S3. [TOOLS-1872]
    • (ASBACKUP) Allow a user to specify which S3 region to use. [TOOLS-1873]
    • (ASBACKUP) Allow a user to specify an S3 compatible storage to use in place of the default S3 URI. [TOOLS-1874]
    • (ASBACKUP) Allow a user to specify an AWS profile. [TOOLS-1923]
    • (ASBACKUP) Allow a user to override the minimum part size to use for S3 Multipart Uploads. [TOOLS-1935]
    • (ASBACKUP) Allow a user to set a max number of simultaneous outstanding async S3 upload/download requests. [TOOLS-1948]
  • (ASBACKUP) Give an option to remove backup artifacts without performing a backup. [TOOLS-1927]

Improvements

  • (PACKAGING) Remove support for Debian 8 and add support for Debian 11. [TOOLS-1865]
  • (AQL) Change the default setting of KEY_SEND to true in aql. [TOOLS-1915]
  • (AQL) Support new 6.0 truncate, udf-admin, and sindex-admin privileges in aql. [TOOLS-1921]
  • (ASADM) The default timeout should be changed to 1 second. [TOOLS-1794]
  • (ASADM) Bundle asadm with python to remove python dependency. [TOOLS-1861]
  • (ASADM) Have asadm use async/await co-routines instead of threads for concurrent requests. [TOOLS-1877]
  • (ASADM) Allow show users to query for a single user. [TOOLS-1905]
  • (ASADM) Allow asadm to work with mixed security modes. [TOOLS-1925]
  • (ASADM) Support new server 6.0 stats, configs, info commands, and histograms. [TOOLS-1928]
  • (ASADM) Add higher precision to the Disk, Memory, and PIndex Used% reported by info namespace usage. [TOOLS-1938]
  • (ASADM) Add 6.0 configuration schema to asadm. [TOOLS-1958]
  • (ASBACKUP) Allow the user to specify the number of backup samples to take. [TOOLS-1942]

Bug Fixes

  • (AQL) Filter illegal bin names to stop aql from crashing. [TOOLS-1491]
  • (ASADM) Asadm makes an invalid info call when there are no DC’s configured on server >= 5.7. [TOOLS-1727]
  • (ASADM) manage config auto-complete prints same parameter twice in some cases. [TOOLS-1922]
  • (ASADM) Help output does not show new manage jobs commands. [TOOLS-1924]
  • (ASADM) —no-color flag raises exception. [TOOLS-1936]
  • (ASADM) Asadm does not reliably discover the cluster if security is enabled and the seed node is a load-balancer. [TOOLS-1939]
  • (ASADM) Summary command does not report compression-ratio for namespaces in table view. [TOOLS-1940]
  • (ASADM) The summary command reports flash-index as 0 when in use. [TOOLS-1943]

Known Issues

  • (ASRESTORE) Using —s3-bucket causes malformed url in s3 requests. This flag will be removed in a future version. [TOOLS-2569]
  • Known Issues: Tools

Individual Tools Versions

Updates

  • Aerospike C Client 6.0.0

Tools 6.3.1

Release date: April 1, 2022

  • Requires Aerospike Server version 4.9 or newer.

Bug Fixes

  • (ASBACKUP) Segmentation fault caused by running a backup estimate with at least 10,000 records. [TOOLS-1973]

Known Issues

Individual Tools Versions

Tools 6.3.0

Release date: December 23, 2021

  • Requires Aerospike Server version 4.9 or newer.

New Features

  • (ASADM) Add an --enable flag to be used in conjunction with the -execute option. [TOOLS-1902]

Improvements

  • (ASADM) Support new 5.8 truncate, udf-admin, and sindex-admin privileges in asadm. [TOOLS-1881]

Bug Fixes

  • (ASLOGLATENCY) asloglatency displays average rounded down. [TOOLS-1893]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 5.2.6

Tools 6.2.0

Release date: December 9, 2021

  • Requires Aerospike Server version 4.9 or newer.
  • The Aerospike Backup (asbackup) Tools now supports only the new Aerospike Filter Expressions API, when using multi-set backup or the parameters --modified-before, --modified-after, or --no-ttl-only Aerospike Server version 5.2 or newer is required.
  • The Aerospike Loader (asloader) Tool has been removed from the Aerospike Tools package.

New Features

  • (ASADM) Add a manage roster command to asadm. [TOOLS-1801]
  • (ASADM) Add a show roster command to asadm. [TOOLS-1811]
  • (ASADM) Add a manage revive command to asadm. [TOOLS-1812]
  • (ASADM) Create a manage jobs command in asadm. [TOOLS-1815]
    • Refer to the manage jobs usage documentation due to “[TOOLS-1924] - (ASADM) Help output does not show new manage jobs commands.”
  • (ASADM) Create a show jobs command in asadm. [TOOLS-1817]
  • (ASADM) Create a show racks command in asadm. [TOOLS-1844]
  • (ASADM-COLLECTINFO) Collectinfo should defer to unique-data-agent to get license data usage when available. [TOOLS-1735]
  • (ASBACKUP) Support backup resumption in asbackup. [TOOLS-1803]
  • (ASBACKUP) Allow the user to specify where backup states are written. [TOOLS-1827]
  • (ASBACKUP) Allow the user to specify socket timeout/retries. [TOOLS-1876]

Improvements

  • (PACKAGING) The new tools package should not remove the asvalidation tool if previously installed. [TOOLS-1859]
  • (ASADM) Add pmem to summary command. [TOOLS-1434]
  • (ASADM) Add effective roster rack-id to asadm info namespace output. [TOOLS-1790]
  • (ASADM) Should not fail to run when user and password are provided when security is disabled. [TOOLS-1858]
  • (ASADM) Add set index information to the asadm info set call. [TOOLS-1860]
  • (ASADM) Have asadm print error logs to stderr instead of stdout. [TOOLS-1880]
  • (ASADM) Require user input if a node is being added without a rack-id and a rack-id is configured. [TOOLS-1906]
  • (ASADM-COLLECTINFO) Fail to generate collectinfo.tgz if an exception occurs while creating JSON file. [TOOLS-1848]
  • (ASADM-COLLECTINFO) Store the collectinfo command’s stdout/stderr in the collectinfo archive. [TOOLS-1855]

Bug Fixes

  • (ASADM-COLLECTINFO) Collectinfo may fail during interactive session if cluster status changes. [TOOLS-1500]
  • (ASADM-HEALTHCHECK) The health-check incorrectly identifies secondary indexes that are not in sync. [TOOLS-1875]
  • (ASBACKUP) Update —mod-before/—mod-after and —no-ttl-only which currently use the now removed predicate expressions. [TOOLS-1843]

Known Issues

Individual Tools Versions

Tools 6.1.2

Release date: October 12, 2021

  • Requires Aerospike Server version 4.9 or newer.
  • The Aerospike Loader (asloader) Tool is scheduled for removal from the Aerospike Tools package with our next major Aerospike Tools release.

Improvements

  • (ASBACKUP) Asbackup 3.7 node backup is considerably slower without parallelization. [TOOLS-1814]

Bug Fixes

  • (ASADM) show best-practices does not display correct data in collectinfo mode. [TOOLS-1824]
  • (ASBACKUP) Scans can fail if a socket timeout occurs. [TOOLS-1818]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 5.2.5

Tools 6.1.0

Release date: September 24, 2021

  • Requires Aerospike Server version 4.9 or newer.
  • This release of Tools is the first to support changes included in server 5.7.
  • Aerospike Admin (asadm) removed support for Aerospike Server prior to version 4.0.

New Features

  • (ASADM) Add show best-practices check to asadm. [TOOLS-1786]

Improvements

  • (AQL) Support PKI authentication in aql. [TOOLS-1805]
  • (ASADM) Make errors return with non-zero exit code when using the -e flag. [TOOLS-1508]
  • (ASADM) Support PKI authentication in asadm. [TOOLS-1739]
  • (ASADM) Remove support for Aerospike Server prior to version 4.0. [TOOLS-1757]
  • (ASADM) Support auto-completion for server 5.7 dynamic configuration. [TOOLS-1763]
  • (ASADM) Add support for new secondary index metrics coming in server 5.7. [TOOLS-1764]
  • (ASADM) Add effective roster rack-id to asadm show config namespace output. [TOOLS-1790]
  • (ASBACKUP) Support PKI authentication in asbackup. [TOOLS-1753]
  • (ASBENCH) Support PKI authentication in asbench. [TOOLS-1787]

Bug Fixes

  • (AQL) Aql does not check for invalid primary key insert. [TOOLS-1728]
  • (ASBACKUP) Should be compatible with sindex-list response from server version 5.7. [TOOLS-1791]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 5.2.3

Tools 6.0.4

Release date: September 17, 2021

  • In the next release Aerospike Admin (asadm) will remove support for versions older than Aerospike Server 4.0.

Bug Fixes

  • (ASBACKUP) The asbackup -o / --output-file command-line option fails when writing to stdout. [TOOLS-1799]

Known Issues

Individual Tools Versions

Tools 6.0.3

Release date: September 3, 2021

  • BREAKING CHANGE: The -f parameter now is associated with -f, --filter-exp <b64 encoded expression>.
  • Aerospike Admin (asadm) now supports dynamic configuration with tab completion for Aerospike Server versions 4.0 - 5.6 through the new manage config command.
  • A new Aerospike Benchmark Tool (asbench) written in the C language replaces the Aerospike Benchmark Tool (asbenchmark) written in the Java language.
  • Aerospike Tools currently supports Python3.6 to Python3.9.
  • We have removed the Aerospike CDT Validation Tool from the Aerospike Tools package.
  • We have removed support for legacy macOS versions earlier than Catalina 10.15.

New Features

  • (ASADM) Add the ability to manage dynamic configuration with asadm. [TOOLS-1577]
  • (ASADM) Add the ability to truncate namespaces and sets to asadm. [TOOLS-1579]
  • (ASADM) Add the ability to recluster to asadm. [TOOLS-1688]
  • (ASADM) Add the ability to quiesce a node to asadm. [TOOLS-1691]
  • (ASBACKUP) Allow automated scan parallelization when backing up a single partition range. [TOOLS-1745]
  • (ASBACKUP) Allow asbackup to use expressions to do partial backup. [TOOLS-1774]
  • (ASBACKUP) Reintroduced the --parallel option for asbackup. [TOOLS-1776]
  • (ASBACKUP) Added missing --tls-name command-line option. [TOOLS-1782]
  • (ASBENCH) Allow a user to specify compression for asbenchmark. [TOOLS-1593]
  • (ASBENCH) Allow a user to define the desired compression ratio for binary data in asbenchmark. [TOOLS-1594]
  • (ASBENCH) Allow a user to define an output file for raw latency data in asbenchmark. [TOOLS-1598]
  • (ASBENCH) Modify the periodic summary output for asbenchmark. [TOOLS-1616]
  • (ASBENCH) Allow a user to define an output file for HDRHistogram data in asbenchmark. [TOOLS-1624]
  • (ASBENCH) Extend the obj_spec in asbenchmark to support booleans, constant values, and multiple map entries. [TOOLS-1711]
  • (ASBENCH) Replace the java benchmark in aerospike-tools with the C benchmark. [TOOLS-1722]
  • (ASBENCH) Support boolean data types in asbenchmark. [TOOLS-1765]
  • (ASBENCH) Add missing UDF functionality to asbenchmark. [TOOLS-1766]
  • (ASBENCH) Only print out period summary transaction data in categories with data. [TOOLS-1767]
  • (ASBENCH) Add missing --tls-keyfile-password command-line option. [TOOLS-1770]

Improvements

  • (ASADM) The with modifier should explicitly match addresses. [TOOLS-1676]
  • (ASADM) Add netstat output to collectinfo file. [TOOLS-1718]
  • (ASADM) Asadm should use a simplified unique data calculation. [TOOLS-1719]
  • (ASBACKUP) Bring back the node-list option. [TOOLS-1747]
  • (ASBACKUP) Queue backup files that were not filled to --file-limit for reuse when running in directory mode. [TOOLS-1754]
  • (ASBACKUP) Reverted --partition-filter back to --partition-list for asbackup, allowing the backing up of multiple partition filters. [TOOLS-1777]
  • (ASBACKUP) Warn when doing a backup estimate with --filter-exp, --node-list, --modified-after, --modified-before, --no-ttl-only, --after-digest, or --partition-list. [TOOLS-1783]
  • (ASBENCH) Allow a user to define stages of different workloads for an asbenchmark run. [TOOLS-1634]
  • (ASBENCH) Add a services-alternate option to asbenchmark. [TOOLS-1662]
  • (ASBENCH) Allow RU,0 workload for a random key read-only workload. [TOOLS-1768]
  • (ASBENCH) Command line arguments are now dash-delimited, camelcase argument names are deprecated. [TOOLS-1771]
  • (ASBENCH) Added the option to static link against all non-system library dependencies. [TOOLS-1772]
  • (ASVALIDATION) Remove asvalidation from the Aerospike Tools package. [TOOLS-1748]

Bug Fixes

  • (TOOLS) Invalid tls-protocols example in astools.conf template. [TOOLS-1760]
  • (AQL) Aql segmentation faults when config file contains “user” before “port”. [TOOLS-1426]
  • (ASADM) Summary command memory use is inaccurate. [TOOLS-1411]
  • (ASADM) An exception is thrown from show latencies when batch-index metric is populated. [TOOLS-1708]
  • (ASADM) Asadm summary fails to report XDR Source as a feature. [TOOLS-1713]
  • (ASADM) Asadm makes an invalid info call when there are no DC’s configured on server >= 5.7. [TOOLS-1727]
  • (ASADM) Exception thrown by summary command. [TOOLS-1729]
  • (ASADM) Summary command does not properly display all-pmem/all-flash usage. [TOOLS-1736]
  • (ASADM) Asadm does not tolerate seed-nodes that are load-balancers. [TOOLS-1773]
  • (ASBACKUP) asrestore help message description of --namespace option was fixed. [TOOLS-1775]
  • (ASBACKUP) Fix --estimate to work with compression. [TOOLS-1778]
  • (ASBACKUP) Fix percentage complete when running asrestore with compression. [TOOLS-1779]
  • (ASBACKUP) Fix asbackup --file-limit and --nice when running with compression. [TOOLS-1780]
  • (ASBACKUP) Fix disk space check when running asbackup with compression. [TOOLS-1781]
  • (ASBENCH) libyaml-devel an aerospike-benchmark dependency is not available for download on the official RHEL 7. [TOOLS-1731]
  • (ASBENCH) Write pthread_barrier_t for OSX compatibility. [TOOLS-1769]

Known Issues

Individual Tools Versions

Tools 5.2.0

Release date: May 10, 2021

  • As of Aerospike Server 4.9 scans are correct. The scan priority, fail_on_cluster_change, and scan percent options, that were deprecated in Aerospike Server 4.9 and are removed in Aerospike Server 5.6, have also been removed from aql, asvalidation, and asbackup.
    • In asbackup, the alternative to the removed scan priority is to use the --records-per-second flag.
      • -f, --priority <priority> has been removed
    • In asbackup, the -c or --no-cluster-change flag is not necessary and has been removed.
    • In asbackup, the alternative to the removed scan percent is to use the --max-records flag.
  • The ASADM output format has been revised as of Aerospike Tools version 5.0.1 and could break user’s scripts.
  • openssl-1.1.1.k is now statically linked into asbackup, aql, and asvalidation.
  • Aerospike Tools currently supports Python3.6 to Python3.9.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We have removed support for Ubuntu 16.04.

New Features

  • (ASADM) User and role management commands should support rate limits. [TOOLS-1668]
  • (ASBACKUP) Zstandard compression for asbackup/asrestore. [TOOLS-1702]
  • (ASBACKUP) A user should be able to backup multiple sets at once. [TOOLS-1703]
  • (ASBACKUP) Support backup encryption. [TOOLS-1704]

Improvements

  • (TOOLS) Remove Python 3.5 support. [TOOLS-1677]
  • (TOOLS) Add Python 3.9 support. [TOOLS-1683]
  • (TOOLS) Remove scan priority, fail_on_cluster_change, and percent options from aql, asvalidation, and asbackup. [TOOLS-1693]
  • (ASADM) Inspect and revise the asadm help (asadm —help & Admin> help). [TOOLS-1663]
  • (ASADM) Update asadm cryptography dependency to 3.4.7. [TOOLS-1665]
  • (ASADM) The manage acl create user command should accept roles or role as a valid keyword argument. [TOOLS-1675]
  • (ASADM) Remove the ability to use a hashed password in asadm. [TOOLS-1689]
  • (ASBACKUP) Support for max records option in asbackup. [TOOLS-1467]
  • (ASBACKUP) Support Boolean particle type. [TOOLS-1660]
  • (ASBACKUP) Change partition-filter to partition-list. [TOOLS-1705]
  • (ASBACKUP) Remove node-list option. [TOOLS-1706]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 5.2.0

Tools 5.1.1

Release date: March 1, 2021

  • The ASADM output format has been revised as of Aerospike Tools version 5.0.1 and could break user’s scripts.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Bug Fixes

  • (ASADM) The show users and show roles command returns an error when TLS is enabled. [TOOLS-1661]

Known Issues

Individual Tools Versions

Tools 5.1.0

Release date: February 19, 2021

  • The ASADM output format has been revised as of Aerospike Tools version 5.0.1 and could break user’s scripts.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

New Features

  • (PACKAGING) Remove support for CentOS Linux 6. [TOOLS-1645]
  • (ASADM) Remove support for CentOS Linux 6. [TOOLS-1648]
  • (ASADM) Add the ability to manage users, roles, udfs, and secondary indexes. [TOOLS-1564]

Improvements

  • (ASADM) Exception is thrown by info xdr when running Aerospike Server < 5.0. [TOOLS-1638]
  • (ASADM) Traceback when trying to run show config xdr or show config dc for Aerospike Server > 5.0 and Aerospike Tools < 3.26.2. [TOOLS-1643]

Bug Fixes

  • (ASADM) Partition rule to check if sprigs per partition is higher than index mounted space should only run for All Flash. [TOOLS-1632]
  • (ASADM) The show distribution command shows incorrect distribution. [TOOLS-1636]
  • (ASADM) The info xdr command shows “src-id” in the last table title for Aerospike Database >= 5.4. [TOOLS-1652]
  • (ASADM-LOG-ANALYZER) Log-Analyzer histogram command incorrectly displays average latency of latency buckets and ops/sec. [TOOLS-1649]

Known Issues

Individual Tools Versions

Tools 5.0.1

Release date: January 19, 2021

  • The ASADM output format has been revised and could break user’s scripts.
  • openssl-1.1.1.g is now statically linked into asbackup, aql, and asvalidation.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

New Features

  • (ASADM) Create new and improved output format that is more compact, more configurable, and allows for json output. [TOOLS-1621]

Improvements

  • (ASADM-HEALTHCHECK) Add check to see if Transparent Huge Pages (THP) is enabled. [TOOLS-1557]
  • (ASADM-HEALTHCHECK) Remove check rule for “non-recommended-sprigs” for Aerospike Database Enterprise Edition. [TOOLS-1560]

Bug Fixes

  • (ASADM) Exception is thrown by ‘info xdr’ after removing a DC. [TOOLS-1587]
  • (ASADM) CollectInfo-Analyzer displays show config xdr table too many times. [TOOLS-1619]
  • (ASADM) The “for” modifier does not work on some commands. [TOOLS-1622]
  • (ASADM-HEALTHCHECK) Most health checks are not running. [TOOLS-1586]
  • (ASADM-LOG-ANALYZER) Histogram command -f option returns silently without parsing. [TOOLS-1627]

Known Issues

Individual Tools Versions

Tools 4.0.4

Release date: December 10, 2020

  • openssl-1.1.1.g is now statically linked into asbackup, aql, and asvalidation.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Improvements

  • (ASADM) Expose device_data_bytes in ‘info sets’ as ‘disk used’. [TOOLS-1558]

Bug Fixes

  • (ASADM) Primary Index total is now computed and displayed properly. [TOOLS-1514]
  • (ASADM) Prevent partition map info from being stored in ascollectinfo.log without —pmap option. [TOOLS-1611]
  • (AQL) Touch operation in AQL will now honor ttl. [TOOLS-1561]

Known Issues

Individual Tools Versions

Tools 4.0.3

Release date: November 4, 2020

  • openssl-1.1.1.g is now statically linked into asbackup, aql, and asvalidation.
  • Support for Python2.7 and Python3.4 have been removed.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Bug Fixes

  • (PACKAGING) postinstall script fails on the legacy Mac Operating System installation. [TOOLS-1582]

Known Issues

Tools 4.0.2

Release date: November 2, 2020

  • openssl-1.1.1.g is now statically linked into asbackup, aql, and asvalidation.
  • Support for Python2.7 and Python3.4 have been removed.
  • Aerospike Tools currently supports Python3.5 to Python3.8.
  • The “python3” binary path must now resolve. For example: /usr/bin/env python3. The “python” binary path is no longer used.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

New Features

  • (PACKAGING) Remove python 2.7 because it is deprecated. [TOOLS-1389]
  • (ASADM) Support ‘for’ modifier for Aerospike 5 XDR show config command. [TOOLS-1523]
  • (ASBACKUP) Support for new partition-based scans in asbackup. [TOOLS-1446]

Improvements

  • (PACKAGING) Static link openssl-1.1.1.g for asbackup, aql, and asvalidation. [TOOLS-1522]
  • (ASADM) Update tools for the new Aerospike 5 XDR. [TOOLS-1463]
  • (ASADM) Port asadm to Python 3 only. [TOOLS-1510]
  • (ASADM) Use disk storage formula for unique data calculation. [TOOLS-1520]
  • [ASADM] Update cryptography to 3.2 (OpenSSL 1.1.1h). [TOOLS-1524]
  • (ASADM) Add ‘lag’ and replace ‘recoveries’ with ‘recoveries_pending’ in ‘info xdr’ output. [TOOLS-1554]
  • (ASADM) Change collectinfo cloud discovery output, change GCE magic IP, and add additional system commands. [TOOLS-1556]
  • (ASINFO) Port asinfo to Python 3 only. [TOOLS-1512]
  • (ASLOGLATENCY) Port asloglatency to Python 3 only. [TOOLS-1511]

Bug Fixes

  • (ASADM) Enhance collectinfo to collect Aerospike 5 XDR configurations. [TOOLS-1521]
  • (ASADM/ASLOGLATENCY) Log Analyzer columns are out of order. Microseconds are incorrectly displayed in both Log Analyzer and Log Latency. [TOOLS-1536]

Known Issues

Individual Tools Versions

Tools 3.31.1

Release date: October 19, 2020

  • On Linux Operating Systems, Aerospike Tools currently supports Python3.4 to Python3.8. Concurrent support for Python2.7 is also maintained. Support for Python3.4 will be removed in the next major release.
  • On the Mac Operating System, Aerospike Tools supports Python3.5 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • Aerospike Tools support for Python2.7 will be removed in the next major release.
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Improvements

  • Remove python as a dpkg requirement. [TOOLS-1540]

Known Issues

Tools 3.31.0

Release date: September 30, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • On Linux Operating Systems, Aerospike Tools currently supports Python3.4 to Python3.8. Concurrent support for Python2.7 is also maintained. Support for Python3.4 will be removed in the next major release.
  • On the Mac Operating System, Aerospike Tools supports Python3.5 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • Aerospike Tools support for Python2.7 will be removed in the next major release.
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

New Features

  • (ASADM) Added new show latencies command, replacing show latency, to support Aerospike Server 5.1 or newer latencies info command. [TOOLS-1516]

Known Issues

Individual Tools Versions

Tools 3.30.0

Release date: August 14, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • On Linux Operating Systems, Aerospike Tools currently supports Python3.4 to Python3.8. Concurrent support for Python2.7 is also maintained. Support for Python3.4 will be removed in the next major release.
  • On the Mac Operating System, Aerospike Tools supports Python3.5 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • Aerospike Tools support for Python2.7 will be removed in the next major release.
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Bug Fixes

  • (ASADM) Removed partition map analysis from collectinfo by default. Use new —pmap option to include it. [TOOLS-1530]

Known Issues

Individual Tools Versions

Tools 3.29.0

Release date: July 31, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • On Linux Operating Systems, Aerospike Tools supports Python3.4 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • On the Mac Operating System, Aerospike Tools supports Python3.5 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We have deprecated support for Ubuntu 14.04.

Improvements

  • (TOOLS) Added support for ubuntu 20. [TOOLS-1525]

Bug Fixes

  • (AQL) Increase max role name length to 64 characters including null byte. [TOOLS-1502]

Known Issues

Individual Tools Versions

Updates

Tools 3.28.0

Release date: July 1, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • Support for macOS Catalina has been added conforming to Apple’s recent security enhancement requirements.
  • On Linux Operating Systems, Aerospike Tools supports Python3.4 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • On the Mac Operating System, Aerospike Tools supports Python3.5 to Python3.8. Concurrent support for Python2.7 is also maintained.
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.

Bug Fixes

  • Update Mac notarization for new strict requirements. [TOOLS-1457]
  • (ASADM) Fix unique data on disk calculation when data in memory is false on Python 2. [TOOLS-1515]

Known Issues

Individual Tools Versions

Tools 3.27.2

Release date: June 10, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We are aware that Apple’s recent security enhancements have caused issues installing Aerospike Tools 3.24.1 and newer on macOS Catalina. We are currently working on conforming to the new requirements.

Bug Fixes

  • (ASADM) Info command crashes with Python3 and server 4.9 or earlier. [TOOLS-1507]

Known Issues

Individual Tools Versions

Tools 3.27.1

Release date: June 8, 2020

  • ATTENTION: Debian/Ubuntu users - if python2 is not installed, the debian and ubuntu aerospike-tools installers bundled with server release versions 5.1.0.X and 5.2.0.X still include a dependency on the “python” package (python2). This should have been removed with the release of python3 support.
    • Aerospike Tools releases in between 3.27.1 and 3.31.0 support both python2 and python3.
    • To fix a standalone tools install, upgrade to aerospike-tools-3.31.1 or later.
    • To workaround an aerospike server bundle install, use one of the following 2 options:
      • Option A
        • Install the “python” package (python2).
        • Example for ubuntu 20.04:
          • $ apt install python
        • Recommendation is for tools to use python2 at this point.
          • If python3 usage is desired, the “python” bin path will need to resolve to python3 since it is checked first.
      • Option B
        • Instead of running the ./asinstall script, install aerospike-tools-3.31.1 and the server separately.
          • $ dpkg -i aerospike-tools-3.31.1*.deb
          • $ dpkg -i aerospike-server-*.deb
  • The installation of the future module is required by asloglatency.
    • The warning “ImportError: No module named builtins” is resolved by installing the ‘future’ module. For example: pip install future.
  • We rely on code generation to add Python3 support, while maintaining Python2.7 support.
  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We are aware that Apple’s recent security enhancements have caused issues installing Aerospike Tools 3.24.1 and newer on macOS Catalina. We are currently working on conforming to the new requirements.

New Features

  • (ASBACKUP) Add —extra-ttl option. [TOOLS-1503]

Improvements

  • (ASADM) Add Python 3 support. [TOOLS-1427]
  • (ASINFO) Add Python 3 support. [TOOLS-1450]
  • (ASLOGLATENCY) Add Python 3 support. [TOOLS-1451]

Known Issues

Individual Tools Versions

Tools 3.26.2

Release date: May 14, 2020

  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We are aware that Apple’s recent security enhancements have caused issues installing Aerospike Tools 3.24.1 and newer on macOS Catalina. We are currently working on conforming to the new requirements.

New Features

  • (ASADM) Support ‘for’ modifier for Aerospike 5 XDR statistics and info commands. [TOOLS-1490]

Improvements

  • (AQL) Increase the character limit for ‘privileges’ in “show roles” output. [TOOLS-1498]
  • (ASADM) Display new Aerospike 5 XDR statistics with the ‘show statistics xdr’ and ‘info xdr’ commands. [TOOLS-1495]

Bug Fixes

  • (AQL) Add help text for PRINT command. [TOOLS-1458]
  • (ASADM) Fix summary command’s unique data in memory calculation when shadow device is used. [TOOLS-1480]
  • (ASADM) Consider compression ratio when calculating overhead costs. [TOOLS-1496]

Known Issues

Individual Tools Versions

Updates

Tools 3.25.1

Release date: April 7, 2020

  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We are aware that Apple’s recent security enhancements have caused issues installing Aerospike Tools 3.24.1 and 3.25.1 on macOS Catalina. We are currently working on conforming to the new requirements.

Improvements

  • (AQL) Handle HyperLogLog data as BLOBs. [TOOLS-1483]
  • (ASBACKUP) Support HyperLogLog data type. [TOOLS-1482]

Known Issues

Individual Tools Versions

Updates

Tools 3.24.1

Release date: February 10, 2020

  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • We are aware that Apple’s recent security enhancements have caused issues installing Aerospike Tools 3.24.1 on macOS Catalina. We are currently working on conforming to the new requirements.

Bug Fixes

  • (ASVALIDATION) Fix progress output. [TOOLS-1454]
  • (ASVALIDATION) Correctly repair ‘fixable’ records. [TOOLS-1455]

Known Issues

Individual Tools Versions

Tools 3.24.0

Release date: January 21, 2020

  • The Aerospike CDT Validation Tool addresses the following types of CDT issues, which require certain Aerospike Server versions to detect or correct.
    • Order: The CDT bin has elements out of order. Performing operations on Ordered Lists under Aerospike 3.16.0.1 to 3.16.0.5 may have corrupted records. Fixing this problem requires Aerospike Server version 4.5.3 or newer. If also using XDR, before upgrading to Aerospike 4.6.0 or newer, you must run asvalidation.
    • Padding: The bin has garbage bytes after the valid list or map. This issue is resolved in Aerospike Server version 4.6.0 or newer. For Aerospike Server version 4.5.3 or earlier this issue can be fixed by running the asvalidation tool.
  • (ASVALIDATION) Tool to validate and optionally correct malformed collection data types (CDT) bins. [AER-6162]

New Features

  • (ASBACKUP) Added —output-file-prefix, prepends desired prefix for files generated using the —directory option. [TOOLS-1447]
  • (ASBACKUP) Added —no-ttl-only, to only process records that have no Time To Live (TTL). [TOOLS-1448]
  • (ASBACKUP) Added —record-num, an approximate limit for the number of records to process. [TOOLS-1449]

Improvements

  • (AQL) Modify help to send —services-alternate information to stdout. [TOOLS-1443]

Known Issues

Individual Tools Versions

Tools 3.23.0

Release date: December 11, 2019

New Features

  • (TOOLS) Added support for CentOS 8. [TOOLS-1417]
  • (AQL) Support for new ‘write’ (write only) permission in custom security roles. [TOOLS-1342]
  • (AQL) Add -t —tls-name=name to AQL. [TOOLS-1421]

Bug Fixes

  • (ASADM) “asadm —tls-protocol=all” or “asinfo —tls-protocol=all” fails with python error. [TOOLS-1435]
  • (ASBACKUP) —node-list fails if tls name has 45 characters. [TOOLS-1428]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.6.9

Tools 3.22.0

Release date: October 8, 2019

New Features

  • (TOOLS) Support record delete operation. [TOOLS-1387]
  • (TOOLS) Support for scan changes in server 4.7. [TOOLS-1394]

Improvements

  • (ASADM-HEALTHCHECK) Add rule to check if we do not have too many sprigs per partition for all flash. [TOOLS-1397]
  • (ASADM-HEALTHCHECK) Add rule to report excessive heartbeat interval/timeout. [TOOLS-1401]

Bug Fixes

  • (AQL) Fix to handle exception if TLS input files do not exist. [TOOLS-1395]
  • (AQL) Fix socket-timeout segmentation fault. [TOOLS-1408]
  • (ASADM) Fix unique data usage computation to support post 4.2 changes for tombstone size. [TOOLS-1400]
  • (ASADM-HEALTHCHECK) Fix physical memory check to handle different units. [TOOLS-1392]
  • (ASADM-HEALTHCHECK) Fix rack membership check. [TOOLS-1396]
  • (ASLOADER) Fix column position error for data file without header. [TOOLS-1385]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.6.8

Tools 3.21.1

Release date: August 9, 2019

New Features

  • (TOOLS) Add support for Debian 10. [TOOLS-1362]
  • (AQL) Support for new ‘write’ (write only) permission in custom security roles. [TOOLS-1342]
  • (AQL) Support for whitelist functionality. [TOOLS-1343]
  • (ASADM) Support separate history files for each mode. [TOOLS-1380]

Improvements

  • (TOOLS) Remove support for deprecated Debian 7. [TOOLS-1364]
  • (ASADM-HEALTHCHECK) Add rule to check clock_skew_stop_writes. [TOOLS-1358]
  • (ASADM-HEALTHCHECK) Add rule to check XDR overflow statistics. [TOOLS-1374]

Bug Fixes

  • (AQL) Fix to handle segmentation fault for invalid operate command. [TOOLS-1341]
  • (ASADM) Fix ‘with’ modifier for info command default execution. [TOOLS-1360]
  • (ASADM) Fix collectinfo json dump error. [TOOLS-1381]
  • (ASADM-HEALTHCHECK) Fix dynamic configuration check to handle configurations with time unit. [TOOLS-1377]
  • (ASADM-COLLECTINFO-ANALYZER) Fix configuration parser to handle xdr-max-ship-bandwidth. [TOOLS-1346]
  • (ASADM-COLLECTINFO-ANALYZER) Fix to read all internal files from compressed collectinfo file. [TOOLS-1379]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.6.5

Tools 3.20.0

Release date: May 21, 2019

New Features

  • (ASBACKUP) Support TLS name and IPv6 address in node-list option. [TOOLS-1327]
  • (ASINFO) Allow timeout parameter to be configurable. [TOOLS-1335]

Improvements

  • (TOOLS) Remove SSLv3 support. [TOOLS-1334]
  • (ASADM) Show the ‘show config’ output for specific namespaces matching pattern listed after ‘for’. [TOOLS-1323]
  • (ASADM) Add all the peers and alumni list details to collectinfo. [TOOLS-1324]
  • (ASADM-HEALTHCHECK) Add new rules to check server health stats. [TOOLS-1224]
  • (TOOLS) Add support for new thread-traces info command. [TOOLS-1329]

Bug Fixes

  • (ASADM) Fix to not show online access addresses in offline alumni node list. [TOOLS-1325]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.6.3

Tools 3.19.0

Release date: April 17, 2019

New Features

  • (ASADM) Add support for python ucs2. [TOOLS-1309]
  • (ASADM) Add option to provide aerospike configuration file path for collectinfo. [TOOLS-1322]

Improvements

  • (ASADM) Add index usage output in summary. [TOOLS-1316]
  • (AQL) Support for additional job info output in server 4.5.2. [TOOLS-1313]

Bug Fixes

  • (ASADM) Fix feature command to use new metric xdr_client_write_success. [TOOLS-1312]
  • (ASLOGLATENCY) Fix relative-stats column. [TOOLS-1315]

Known Issues

Individual Tools Versions

Tools 3.18.1

Release date: February 21, 2019

  • Aerospike Tools now requires Python version 2.7.
  • Aerospike Tools now requires Java version 1.8 or newer.

New Features

  • (ASADM-HEALTHCHECK) Add rule to check if roster is not set. [TOOLS-1280]

Improvements

  • (TOOLS) Support for new server SMD system. [TOOLS-1283]
  • (TOOLS) Remove support for max-ttl and cold-start-evict-ttl server config items. [TOOLS-1287]
  • (TOOLS) Support new truncate-namespace and truncate-namespace-undo commands, and alterations to truncate and truncate-undo commands. [TOOLS-1288]
  • (TOOLS) Support for new namespace supervisor (nsup) system. [TOOLS-1289]
  • (AQL) Show replica node in output of explain command. [TOOLS-1286]
  • (AQL) Modify help for the Map Policy in the Operate command. [TOOLS-1269]
  • (ASADM) Add support for compression feature. [TOOLS-1254]
  • (ASADM) Review the option to capture ‘all’ in collectinfo. [TOOLS-1275]
  • (ASADM) Update help as ‘show distribution evictions’ was removed as of 3.8.0. [TOOLS-1291]
  • (ASADM) Ignore sensitive AWS data while collecting info. [TOOLS-1297]
  • (ASADM-COLLECTINFO) Collect details about virtual environment and system product name. [TOOLS-1277]
  • (ASADM-HEALTHCHECK) Add check for paxos-single-replica-limit set higher than Cluster Size. [TOOLS-1285]
  • (ASBENCHMARK) Support PREFER_RACK replica policy. [TOOLS-1270]
  • (ASLOADER) Update to use latest Java client. [TOOLS-1284]

Bug Fixes

  • (TOOLS) Update documentation for libreadline.so.6 requirement on Ubuntu 18.04. [TOOLS-1278]
  • (ASADM) Fix summary ZeroDivisionError and improve cinfolog. [TOOLS-1273]
  • (ASINFO) Fix higher latency issue in tools version 3.16.0 compare to 3.15.3.14. [TOOLS-1268]
  • (ASINFO) Fix to find local asadm. [TOOLS-1282]
  • (ASBACKUP) Fix formula for size estimation. [TOOLS-1276]
  • (ASBACKUP) Fix implementation to increment skip stat properly for asrestore. [TOOLS-1300]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.5.0

Tools 3.17.0

Release date: December 14, 2018

New Features

  • (AQL) Allow socket_timeout to be configurable. [TOOLS-1215]

Improvements

  • (TOOLS) Add support for pmem index feature. [TOOLS-1266]
  • (ASADM-HEALTHCHECK) Add rule to check for limits. [TOOLS-1221]
  • (ASADM-HEALTHCHECK) Add rule to report commit-to-device. [TOOLS-1238]
  • (ASADM-HEALTHCHECK) Add rule to check stop writes situation. [TOOLS-1260]
  • (ASADM-LOG-ANALYZER) Add batch-sub information to the batch-index histogram. [TOOLS-1262]
  • (ASLOGLATENCY) Add batch-sub information to batch-index histogram. [TOOLS-1261]

Bug Fixes

  • (AQL) Fix to avoid crash for set password on non-secure cluster. [TOOLS-1265]
  • (ASADM) Fix security vulnerability issue for cryptography dependency. [TOOLS-1222]
  • (ASADM) Fix hist-dump commands in collectinfo. [TOOLS-1264]
  • (ASADM-COLLECTINFO-ANALYZER) Fix collectinfo analyzer to parse config file with memory size configs. [TOOLS-1255]
  • (ASADM-HEALTHCHECK) Fix clock_skew breached check to treat clock skew as seconds. [TOOLS-1257]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.4.0

Tools 3.16.0

Release date: November 16, 2018

Improvements

  • (TOOLS) Remove nagios from the Tools build. [TOOLS-1141]
  • (TOOLS) Remove asgraphite from the Tools build. [TOOLS-1142]
  • (TOOLS) Fix to support logs with milliseconds. [TOOLS-1242]
  • (AQL) Update truncate command to support lut-now feature. [TOOLS-1236]
  • (ASADM) Add support for XDR Publication framework. [TOOLS-1240]

Bug Fixes

  • (ASINFO) Fix to correctly resolve the asadm path. [TOOLS-1249]

Known Issues

Individual Tools Versions

Updates

Tools 3.15.3.18

Release date: October 17, 2018

Bug Fixes

  • (PACKAGING) Clean state installation for Mac fails. [TOOLS-1229]
  • (AQL) Fix aggregate on scan. [TOOLS-1231]

Known Issues

Tools 3.15.3.17

Release date: September 26, 2018

New Features

  • (TOOLS) Add support for password-protected TLS keys. [TOOLS-1206]

Improvements

  • (TOOLS) Tolerate load balancer IPs in the client and admin tools. [TOOLS-1174]
  • (TOOLS) Modify to support server config changes for ‘transaction-pending-limit’. [TOOLS-1196]
  • (TOOLS) Modify to support mod-lua config changes for ‘system-path’ deprecation in server 4.3.1 release. [TOOLS-1203]
  • (PACKAGING) Add dependency check logic in server/tools installation package. [TOOLS-1192]
  • (ASADM) Modify collectinfo to collect namespace latency in json file. [TOOLS-1051]
  • (ASADM) Modify to support ‘partition-tree-sprigs’ changes. [TOOLS-1166]
  • (ASADM) Modify collectinfo to gather information about THP, min_free_kbytes, process rss/vsz. [TOOLS-1184]
  • (ASADM) Add Index on Device in features list. [TOOLS-1189]
  • (ASADM) Modify to support device statistics changes in server 4.3. [TOOLS-1208]
  • (ASADM) Modify collectinfo to collect output of lsblk. [TOOLS-1209]
  • (ASADM) Add cluster-name to summary output. [TOOLS-1211]
  • (ASADM-HEALTHCHECK) Add rules to check rack configurations. [TOOLS-922]
  • (ASADM-HEALTHCHECK) Add rule to check rack distribution for namespace. [TOOLS-1059]
  • (ASADM-HEALTHCHECK) Add rule to catch multiple device/files with the same name. [TOOLS-1092]
  • (ASADM-HEALTHCHECK) Fix to have non-zero threshold check for error count. [TOOLS-1094]
  • (ASADM-HEALTHCHECK) Add rule to check roster setting. [TOOLS-1159]
  • (ASBACKUP) Review asrestore policy in terms of retries based on error type. [TOOLS-1138]
  • (ASBACKUP) Improve thread working. [TOOLS-1212]

Bug Fixes

  • (PACKAGING) Fix security vulnerability issue for log4j dependency. [TOOLS-1202]
  • (PACKAGING) Fix Tool Mac package to remove old asloader and asbenchmark jars. [TOOLS-1205]
  • (AQL) Fix unknown query data type error. [TOOLS-1197]
  • (ASADM) Check and fix collectinfo commands on all platforms. [TOOLS-1190]
  • (ASADM) Fix to handle nodes with same fully qualified domain name. [TOOLS-1210]
  • (ASINFO) Fix option parsing with optparse to handle password. [TOOLS-1193]

Known Issues

Individual Tools Versions

Updates

Tools 3.15.3.14

Release date: July 23, 2018

Bug Fixes

  • (ASADM) Fix to work with Aerospike security credentials from astools.conf. [TOOLS-1191]
  • (AQL) Credentials in astools.conf are not read properly. [TOOLS-1181]

Known Issues

Individual Tools Versions

Tools 3.15.3.12

Release date: July 17, 2018

New Features

  • (ASBACKUP) Support alternate-address for asbackup. [TOOLS-657]

Improvements

  • (ASADM) Modify collectinfo to collect multiple reports for ‘ip -s link’. [TOOLS-1089]
  • (ASADM) Add TLS and Security to Features list. [TOOLS-1147]
  • (ASADM) Modify to dump service and services in JSON file. [TOOLS-1150]
  • (ASADM) Update to consider new record storage overhead. [TOOLS-1168]
  • (ASADM) Update collectinfo to dump environment variables. [TOOLS-1185]
  • (ASADM) Update asadm help to caution against the use of health. [TOOLS-1187]
  • (ASADM) Add Strong Consistency(SC) in features list. [TOOLS-1188]
  • (ASADM-HEALTHCHECK) Add check for IO scheduler. [TOOLS-1108]

Bug Fixes

  • (ASADM) Modify collectinfo to ignore first report from iostat output. [TOOLS-1137]
  • (ASADM) Fix collectinfo to handle JSON dump error. [TOOLS-1175]
  • (ASADM-HEALTHCHECK) Fix Health Check to catch high Disk Utilization. [TOOLS-1130]
  • (ASBACKUP) Incremental backup percent progress and estimate time is not correct. [TOOLS-1054]

Known Issues

Individual Tools Versions

Tools 3.15.3.11

Release date: June 27, 2018

Bug Fixes

  • (ASBACKUP) Fix segmentation fault when running on macOS. [TOOLS-1171]

Known Issues

Individual Tools Versions

Tools 3.15.3.10

Release date: June 22, 2018

Bug Fixes

  • (ASADM) PEX built asadm fails when using TLS on Oracle Linux 7.1. [TOOLS-1179]

Known Issues

Tools 3.15.3.8

Release date: May 31, 2018

  • Aerospike Tools now supports object size and time to live histogram changes done in server 4.2.
  • The asadm tool is now built using PEX which means all dependencies are included with the tool.
    • It is no longer necessary to install additional dependencies to run the asadm tool.
  • We have deprecated support for Ubuntu 12.04.

New Features

  • (ASADM) Use PEX to build asadm that includes all dependencies. [TOOLS-1154]

Improvements

  • (TOOLS) Add support for ubuntu 18. [TOOLS-1131]

Bug Fixes

  • (ASBACKUP) Not respecting —node-list command line argument. [TOOLS-1121]
  • (ASBACKUP) Correct the usage message. [TOOLS-1126]
  • (ASBACKUP) Fix file-limit long command line option. [TOOLS-1140]
  • (ASLOGLATENCY) Make command line options backward compatible. [TOOLS-1155]

Known Issues

Individual Tools Versions

Updates

Tools 3.15.3.6

Release date: April 27, 2018

New Features

  • (TOOLS) Add support for LDAP. [TOOLS-1116]
  • (TOOLS) Add support for server authentication modes. [TOOLS-1145]

Improvements

  • (ASADM) Fix confusing ‘Missing partitions’ column in pmap command. [TOOLS-1086]
  • (ASADM) Modify for SC changes. [TOOLS-1087]
  • (ASADM) Remove mandatory dependencies. [TOOLS-1124]
  • (ASADM-COLLECTINFO) Modify to work with local languages. [TOOLS-1106]
  • (ASADM-HEALTHCHECK) Add new rules for SC stats. [TOOLS-1070]
  • (ASADM-HEALTHCHECK) Update rules for renamed ‘cluster_clock_skew’ statistic to ‘cluster_clock_skew_ms’. [TOOLS-1143]
  • (ASINFO) Remove mandatory dependencies. [TOOLS-1125]
  • (TOOLS) Add support for Debian 9. [TOOLS-1096]
  • (TOOLS) Add support for Oracle Linux. [TOOLS-1132]
  • (TOOLS) Do not have any implicit default values in configuration file. [TOOLS-1135]

Bug Fixes

  • (AQL) OpenSSL library error when launching on macOS. [TOOLS-1098]
  • (AQL) Fix crash in operate call. [TOOLS-1102]
  • (AQL) Missing instance error when missing host configuration. [TOOLS-1104]
  • (AQL) Fix json output support with configuration file. [TOOLS-1105]
  • (AQL) AQL crashes after set password command. [TOOLS-1110]
  • (ASADM) Fix configuration file read to avoid instance to inherit options from global configuration. [TOOLS-1103]
  • (ASADM-COLLECTINFO-ANALYZER) Fix to pick correct files. [TOOLS-1122]
  • (ASADM-COLLECTINFO-ANALYZER) Fix to pick OOMs from dmesg if not dumped in json. [TOOLS-1128]
  • (ASBACKUP) Asrestore usage needs to be updated. [TOOLS-1127]

Known Issues

Individual Tools Versions

Updates

Tools 3.15.3.2

Release date: March 2, 2018

  • Linux installation scripts have been updated to include a separate installation script for optional dependencies.
  • Added Aerospike Tools Configuration File support.
  • Added Aerospike Benchmark(asbenchmark) to the Tools package.
  • Added Aerospike Loader(asloader) to the Tools package.

New Features

  • (TOOLS) Add support for input configuration file. [TOOLS-913]
  • (ASADM-COLLECTINFO) Collect Google Cloud metadata. [TOOLS-958]
  • (ASADM-COLLECTINFO) Collect Microsoft Azure metadata. [TOOLS-1065]

Improvements

  • (ASADM) Modify to display version in downloaded code (without git). [TOOLS-1038]
  • (ASADM) Add timestamp in output. [TOOLS-1040]
  • (ASADM) Modify to work with removal of retransmit_nsup_repl_write from server statistics. [TOOLS-1076]
  • (ASINFO) Display proper error message when bcrypt is not installed. [TOOLS-1053]
  • (ASINFO) Modify to print detailed error/warning messages. [TOOLS-1079]
  • (ASADM-HEALTHCHECK) Update to use effective replication factor. [TOOLS-1074]
  • (ASADM-HEALTHCHECK) Add rule to check AMI version and if Elastic Network Adapter (ENA) is enabled. [TOOLS-887]
  • (ASADM-COLLECTINFO-ANALYZER) Fix info invalid literal errors. [TOOLS-1080]
  • (PACKAGING) Reduce the amount of copies of tools installation files. [TOOLS-1072]
  • (PACKAGING) Improve install script to make easy to use. [TOOLS-1078]

Bug Fixes

  • (AQL) Indexed geo query may return invalid JSON for multiple results. [TOOLS-1071]
  • (AQL) Setting aql user passwords to more than 62 characters says ‘ok’ but fails to login. [TOOLS-1085]
  • (AQL) Properly process truncate command without LUT. [TOOLS-1097]
  • (ASADM) Fix TLS connection timeout issue. [TOOLS-1082]
  • (ASADM) TLS took a long time to return when using tls-alternate-service-address. [TOOLS-1083]
  • (ASADM-COLLECTINFO-ANALYZER) Fix missing DC information on collectinfo analyzer. [TOOLS-1066]
  • (ASADM-COLLECTINFO-ANALYZER) Modfiy to ignore N/E from config and statistics tables. [TOOLS-1075]
  • (PACKAGING) Incorrect version of bcrypt picked when installing aerospike-tools on amazon linux. [TOOLS-821]
  • (PACKAGING) Mac Installation could provide messaging on required tools dependencies. [TOOLS-1073]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.3.5

Tools 3.15.2.1

Release date: January 25, 2018

  • Linux installation scripts have been updated to include a separate installation script for optional dependencies. See installation script output for more details.
  • AQL truncate command has been modified to expect [.] argument instead of []. Refer to AQL help command for more details.

New Features

  • (ASADM) Provide sindex and set filter for ‘show statistics’ command. [TOOLS-975]
  • (ASADM) Modify to collect system stats for offline node. [TOOLS-1057]

Improvements

  • (AQL) Add LUT option for Truncate command in aql. [TOOLS-1031]
  • (AQL) Truncate command now expects [.] format. [TOOLS-1063]
  • (ASADM) Modify show latency columns to display % sign. [TOOLS-1049]
  • (ASADM) Use optimal lsof command line option, when running it for collectinfo. [TOOLS-1060]
  • (ASADM) Modify collectinfo to collect nvme* drive info. [TOOLS-1061]
  • (ASADM) Improve to show stack trace for exceptions. [TOOLS-1064]
  • (ASADM-HEALTHCHECK) Add more configurations in ignore list. [TOOLS-1052]

Bug Fixes

  • (AQL) Create index fails when using TLS. [TOOLS-1056]
  • (AQL) Fix incorrect results returned from geo query. [TOOLS-1067]
  • (ASADM) Fix collectinfo JSON dump error. [TOOLS-1026]
  • (ASFIXOWNERSHIP) Fix asfixownership to change /opt/aerospike/usr permissions recursively. [TOOLS-982]
  • (PACKAGING) Add scripts to install TLS dependencies for python tools. [TOOLS-863]
  • (PACKAGING) Add script to install pyasn1 dependency. [TOOLS-992]
  • (PACKAGING) Build an RPM to support pyOpenSSL for TLSv1.2. [TOOLS-993]

Known Issues

Individual Tools Versions

Tools 3.15.1.2

Release date: December 21, 2017

New Features

  • (AQL) Support Strong Consistency Mode - Add regime to partition maps & linearizeRead policy. [TOOLS-1004]
  • (ASADM-HEALTHCHECK) Show numbers for failed tests in healthcheck. [TOOLS-945]
  • (ASADM-HEALTHCHECK) Add new operation to find out values in the minority. [TOOLS-1017]
  • (ASADM-HEALTHCHECK) Modify SELECT clause to ignore unwanted keys. [TOOLS-1025]
  • (ASADM-HEALTHCHECK) Add warning for device re-use on a node. [TOOLS-1039]
  • (ASADM-COLLECTINFO-ANALYZER) Add ‘show latency’ command. [TOOLS-1019]

Improvements

  • (AQL) Add “no_bins” option support for scans and secondary index query. [TOOLS-985]
  • (AQL) Add ‘explain’ in help and remove space from digest printed. [TOOLS-1001]
  • (ASADM-COLLECTINFO) Use optimal netstat and ss command line option, when running it for collectinfo. [TOOLS-741]
  • (ASADM) Modify Summary output. [TOOLS-953]
  • (ASADM) Modify Namespace modifier filtration to use regular expression strictly. [TOOLS-972]
  • (ASADM) Modify to deal with configuration name change from “repl-factor” to “replication-factor”. [TOOLS-986]
  • (ASADM) Make collectinfo error messages user-friendly. [TOOLS-999]
  • (ASADM) Modify to allow ssh with default credentials. [TOOLS-1003]
  • (ASADM) Reorganize info tables. [TOOLS-1015]
  • (ASADM) WARN at the top of Summary command if migrations are going on. [TOOLS-1022]
  • (ASADM) Modify ssh options and provide documentation. [TOOLS-1024]
  • (ASADM) Modify to display Summary namespace output in table and list view. [TOOLS-1029]
  • (ASADM) Include rack-aware as a part of the feature listing. [TOOLS-1032]
  • (ASADM) Modify summary to show edition prefix E or C with Aerospike Server Version. [TOOLS-1033]
  • (ASADM) Modify Summary output to show more details. [TOOLS-1034]
  • (ASADM) Add kernel version in OS field in summary. [TOOLS-1041]
  • (ASADM) Add ARP count as new command in collectinfo. [TOOLS-1044]
  • (ASADM-HEALTHCHECK) Add rule to check stop-writes. [TOOLS-1046]
  • (ASADM) Add option to allow user to define collectinfo name’s prefix. [TOOLS-1047]
  • (ASADM-COLLECTINFO) Add hdparm output in ACT and collectinfo. [TOOLS-811]
  • (ASADM-COLLECTINFO) Add cat /proc/pgreg asd/limits and health check. [TOOLS-997]
  • (ASADM-HEALTHCHECK) Parse dmesg and perform OS version, OOM, Process blocking health check. [TOOLS-851]
  • (ASADM-HEALTHCHECK) Collect and Compare sysctl and CPU configuration across nodes in cluster. [TOOLS-885]
  • (ASADM-HEALTHCHECK) Add health check rule to print INFO in case nodes in cluster are running with firewall rules. [TOOLS-957]
  • (ASADM-HEALTHCHECK) Check for OOM Kill and warn in sysinfo. [TOOLS-969]
  • (ASADM-HEALTHCHECK) Add query to check hwm breach. [TOOLS-970]
  • (ASADM-HEALTHCHECK) Add query to check non-default defrag-lwm-pct. [TOOLS-1002]
  • (ASADM-HEALTHCHECK) Add query that compares and highlights values found in aerospike.conf that differ in collectinfo/live cluster. [TOOLS-1014]
  • (ASADM-HEALTHCHECK) Remove difference warning for config items which should/could be different. [TOOLS-1020]
  • (ASADM-HEALTHCHECK) Show details for cluster remote dc_size difference check. [TOOLS-1021]
  • (ASADM-HEALTHCHECK) Remove the thousand delimiter for configuration parameters. [TOOLS-1023]
  • (ASADM-COLLECTINFO-ANALYZER) Fix to accept folder path with multiple collectinfo files/snapshots. [TOOLS-984]
  • (ASINFO) Modify error capturing to show proper description. [TOOLS-1027]

Bug Fixes

  • (AQL) Segmentation Fault when running explain command. [TOOLS-990]
  • (AQL) Segmentation Fault when using the set password command with disabled Security. [TOOLS-1006]
  • (AQL) index name > 20 characters displays different for ‘show indexes’ and new indexname cannot be referenced. [TOOLS-1007]
  • (AQL) Syntax error in executing ASINFO commands with semicolon through AQL. [TOOLS-1010]
  • (ASADM) Fix TLS error capturing to show proper description. [TOOLS-998]
  • (ASADM) Fix to display complete and correct configured IPv6 address. [TOOLS-1045]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.3.0

Tools 3.15.0.3

Release date: October 3, 2017

New Features

  • (AQL) Add support for raw output format, similar to MySQL.
  • (AQL) Add support for CDT operations. [TOOLS-8]
  • (AQL) Add support for ‘truncate’ command. [TOOLS-844]
  • (AQL) Add support for GeoJSON datatype. [TOOLS-584]
  • (AQL) Allow background UDFs to be executed over secondary index query. [TOOLS-955]
  • (ASADM) Add new command ‘info object’ to display summary with new statistics. [TOOLS-900]
  • (ASADM) Add option to get Row based output. [TOOLS-925]
  • (ASADM) Modify to run health/summary as part of collectinfo and add output of those as 2 different files. [TOOLS-944]
  • (ASBACKUP) Introduce retry option in asrestore in case of failure. [TOOLS-943]

Improvements

  • (AQL) Deprecate operation specific command line options. Improve SET and Introduce RESET command.
    • (AQL) Deprecate operation specific command line options. Improve SET and Introduce RESET command. [TOOLS-940]
  • (AQL) Allow arbitrary string as name (namespace / set / indexname / binname) when specified under quotes.
    • (AQL) Allow arbitrary numeric string as name (namespace / set / indexname / binname) when specified under quotes. [TOOLS-727]
    • (AQL) Allow arbitrary string with an underscore as a name (namespace / set / indexname / binname). [TOOLS-750]
  • (AQL) Enhance ‘desc module..’ output to print UDF code in plaintext. [TOOLS-747]
  • (AQL) Order the select bins (in tabular mode) by input order. [TOOLS-185]
  • (AQL) Show digest output in explain command without spaces. [TOOLS-749]
  • (AQL) Print node name along with output in case of multi node output. [TOOLS-663]
  • (AQL) Output error message in tabular / json form. [TOOLS-245]
  • (AQL) In JSON output mode, produce parsable JSON output. [TOOLS-933]
  • (AQL) Return error when there is a syntax error using grant. [TOOLS-954]
  • (AQL) Add support to allow empty string for bin names and password. [TOOLS-974]
  • (ASADM) Modify to work with large clusters. [TOOLS-804]
  • (ASADM) Modify ‘show pmap’ output. [TOOLS-874]
  • (ASADM) Capture storage device partition sizes in collectinfo. [TOOLS-918]
  • (ASADM) Support new partition-info format changes. [TOOLS-979]
  • (ASADM) Add new ‘asinfo’ mode to get faster response. [TOOLS-936]
  • (ASADM-HEALTHCHECK) Flag out ‘services’ discrepancy. [TOOLS-941]
  • (ASADM-LOG-ANALYZER] Display the color used for node identification in the “Selected Logs” output. [TOOLS-951]
  • (ASINFO) Fix to get faster response. [TOOLS-936]
  • (ASBACKUP) Removed LDT support. [TOOLS-967]

Bug Fixes

  • (AQL) Disallow bin names with leading/trailing quote. [TOOLS-138]
  • (AQL) Allow empty string as bin value or primary key. [TOOLS-52]
  • (AQL) Allow escaping of special character for ’.’. [TOOLS-16]
  • (AQL) Fix incorrect defaults of Help command. [TOOLS-748]
  • (AQL) Fix negative value of trid in ‘show scans’ output. [TOOLS-855]
  • (AQL) Fix show users segmentation fault exception. [TOOLS-865]
  • (ASADM) Fix empty aggregation columns to avoid error foreground. [TOOLS-666]
  • (ASADM) Fix command history to work after failed attempt to connect to cluster. [TOOLS-912]
  • (ASADM) Fix remote system statistics collection by using ssh key. [TOOLS-917]
  • (ASADM) Fix collectinfo AWS data collection. [INFO] Data collection for _get_awsdata in progress. [TOOLS-924]
  • (ASADM) Fix “collectinfo” command. [TOOLS-942]
  • (ASADM) Fix dependency scripts for Amazon Linux. [TOOLS-952]
  • (ASADM) Fix ‘show pmap’ error during migrations. [TOOLS-962]
  • (ASADM) Fix TLS connection to work with collectinfo. [TOOLS-973]
  • (ASADM-HEALTHCHECK) Fix anomaly function to handle strings. [TOOLS-923]
  • (ASADM-HEALTHCHECK) Fix memory size configuration check queries. [TOOLS-939]
  • (ASADM-LOG-ANALYZER) Fix to avoid negative values in latency output. [TOOLS-753]
  • (ASLOGLATENCY) Fix to avoid negative value in latency output. [TOOLS-753]
  • (ASBACKUP) Gracefully halt backup in case of node loss. Do not wait indefinitely. [TOOLS-932]

Known Issues

Individual Tools Versions

Updates

  • Aerospike C Client 4.2.0

Tools 3.13.0.1

Release date: May 30, 2017

New Features

  • (ASADM) Add support for ssh key logins. [TOOLS-871]

Improvements

  • (ASADM) Handle displaying multiple nodes with disparate namespaces. [TOOLS-888]
  • (ASADM) Modify asadm to support non-tty input streams. [TOOLS-879]
  • (ASADM) Fix watch to timeout if some nodes are not reachable. [TOOLS-789]
  • (ASADM) Improve output for info summary. [TOOLS-816]
  • (ASADM) Add spaces after commas for tuple cells in info summary output. [TOOLS-858]
  • (ASADM) Fix to timeout fqdn search process. [TOOLS-911]
  • (ASINFO) asinfo not able to resolve the asadm path correctly. [TOOLS-904]
  • (ASADM-LOG-ANALYZER) Rename loglatency to indicate all type histogram analysis. [TOOLS-802]
  • (ASADM-LOG-ANALYZER) Modify diff to show warning message if filtered lines for input key are dumped from different file or code-line. [TOOLS-894]
  • (ADADM-HEALTHCHECK) Add Health Check query to check paxos-max-cluster-size. [TOOLS-878]

Bug Fixes

  • (ASADM) Fix asadm to work if $HOME is not set. [TOOLS-882]
  • (ASADM) Fix the error string returned while executing info commands. [TOOLS-903]
  • (ASADM) Rename feature XDR ENABLED to XDR SOURCE. This only shows up if XDR has attempted to ship any record rather than simply being enabled. [TOOLS-905]
  • (ASADM) Fix asadm show statistics -t so it works with multiple namespaces. [TOOLS-785]
  • (ASADM-HEALTHCHECK) Fix the top output parser to correctly translate memory size in bytes. [TOOLS-902]
  • (ASADM-HEALTHCHECK) Mark healthcheck of 256GB memory configuration upper bound only valid for version <3.12. [TOOLS-893]
  • (ASADM-HEALTHCHECK) Fix query to check xdr_ship_latency_avg with correct unit (ms). [TOOLS-896]
  • (ASADM-COLLECTINFO-ANALYZER) Fix to support tar file with zip file inside it. [TOOLS-910]
  • (ASBACKUP) Properly restore UDF files that have dependencies. [TOOLS-890]

Known Issues

Individual Tools Versions

Tools 3.12.1

Release date: April 4, 2017

New Features

  • (ASADM) Show cluster data usage. [TOOLS-783]
  • (ASADM) Add new ‘summary’ command to display cluster summary. [TOOLS-869]
  • (ASADM) Add pmap command to analyze partition map. [TOOLS-872]
  • (ASBACKUP) Extend backup socket-idle-timeout to be 10 minutes. [TOOLS-868]

Improvements

  • (ASADM) Modify “Pending Migrate” column in info namespace to show raw values instead of percentage. [TOOLS-644]
  • (ASADM) Modify to work with tar files. [TOOLS-668]
  • (ASADM) Modify to use alternate addresses of servers. [TOOLS-743]
  • (ASADM) Modify to collect AWS availability zone information in collectinfo. [TOOLS-823]
  • (ASADM) Add Health query to check Non-zero XDR transaction timeouts. [TOOLS-859]

Bug Fixes

  • (AQL) Creating user with role incorrectly fails. [TOOLS-856]
  • (AQL) Lua UDF C module examples not working. [TOOLS-853]
  • (AQL) Correctly display never-expire TTL as -1. [TOOLS-607]
  • (AQL) Skip printing digest when not available. [TOOLS-733]
  • (AQL) Role name being truncated to 31 chars in Table form. [TOOLS-854]
  • (ASADM) Fix readline shortcuts. [TOOLS-848]
  • (ASADM) Fix command history. [TOOLS-849]
  • (ASINFO) Need to differentiate connection error from server command error. [TOOLS-100]
  • (ASINFO) Does not return proper exit code on failures. [TOOLS-691]
  • (ASLOGLATENCY) Error printed trying to get log configuration. [TOOLS-842]

Known Issues

Individual Tools Versions

Tools 3.12.0

Release date: March 15, 2017

  • Nagios and Graphite now packaged with aerospike-tools
  • (ASBACKUP) Incremental backup based on last-update-time. Must have Server 3.12 and above.

New Features

  • (ASADM) Add new health command for general cluster health check, SMD sync check and statistics trend analysis. [TOOLS-259]
  • (ASADM) Add collectinfo capability to dump data in JSON format with multiple snapshot. [TOOLS-794]

Improvements

  • (ASADM) Log-analyzer change log-analyzer and collectinfo-analyzer as two separate mode of operation. [TOOLS-845]
  • (AQL) Better error reporting for erroneous password creation syntax. [TOOLS-824]
  • (PACKAGING) Aerospike Tools Package now signed for macOS. [TOOLS-826]

Bug Fixes

  • (ASADM) Log-analyzer fix to ignore log lines without timestamp. [TOOLS-846]

Known Issues

Individual Tools Versions

Tools 3.11.1

Release date: February 7, 2017

  • TLS support added for collectd, Graphite, Nagios, Zabbix.

Bug Fixes

  • (PACKAGING) asinstall failed on RHEL 7.2. [TOOLS-752]
  • (ASINFO) asinfo syntax changes (3.11.0). [TOOLS-796]
  • (ASINFO) asinfo not working for certain settings. [TOOLS-793]
  • (ASADM) asloglatency fails to open log when multiple log sinks are defined. [TOOLS-762]
  • (ASADM) asadm should not throw TLS related import errors for non-TLS connection. [TOOLS-807]

Known Issues

Individual Tools Versions

Tools 3.11.0

Release date: January 5, 2017

  • asinfo is now a shim over asadm.

New Features

  • (AQL) - Support TLS.
  • (ASBACKUP) - Support TLS.
  • (ASADM) - Support TLS.
  • (ASINFO) - Support TLS & IPV6.

Known Issues

Individual Tools Versions

Tools 3.10.2

Release date: October 7, 2016

New Features

  • (AQL) - Support for Durable Delete. [TOOLS-722]
  • (AQL) - Support for IPV6. [TOOLS-736]
  • (ASINFO) - Support for IPV6. [TOOLS-740]
  • (ASBACKUP) - Support for IPV6. [TOOLS-737]

Known Issues

Individual Tools Versions

Tools 3.9.1.2

Release date: August 29, 2016

  • Aerospike Tools 3.9.1.2 contains asbackup 3.1.7.

Known Issues

Tools 3.9.1

Release date: August 12, 2016

Regression - This version contains asbackup 3.1.5. For the latest version of asbackup, update Tools to version 3.9.1.2.

Bug Fixes

  • aerospike-graphite 1.5.4

Known Issues

Tools 3.9.0

Release date: July 11, 2016

Deprecated Tools some of our older generation tools.

  • asmonitor - replaced by asadm
  • cli - absorbed by aql
  • ascli - absorbed by aql
  • AscollectInfo - absorbed by asadm

New Features

  • Aerospike Tools now available on Ubuntu 16.04.

Improvements

  • (AQL) Ability to configure thread pool * Add -z <thread_pool_size> command-line option. [TOOLS-679]

Known Issues

Individual Tools Versions

Tools 3.8.3

Release date: June 2, 2016

Known Issues

Individual Tools Versions

Tools 3.8.2

Release date: May 2, 2016

New Features

  • (ASADM) Log-analyzer utility to work with collectinfo and aerospike server logs. [TOOLS-491]
  • (AQL) Add “LIST” and “MAP” Value Types to AQL. [TOOLS-614]

Improvements

  • (AQL) Support send-key option on write. [TOOLS-539]
  • (AQL) Provide support for GeoJSON in AQL. [TOOLS-585]

Bug Fixes

  • (AQL) Register UDF in AQL core dumps. [TOOLS-615]

Known Issues

Individual Tools Versions

Tools 3.8.0

Release date: April 15, 2016

Known Issues

Individual Tools Versions

Tools 3.7.5

Release date: March 23, 2016

Bug Fixes

  • (AQL) Accept double or single quotes for strings. [TOOLS-590]
  • (AQL) Invalid password string will incorrectly change logged-in user’s password. [TOOLS-594]

Known Issues

Individual Tools Versions

Tools 3.7.3

Release date: February 4, 2016

Known Issues

Individual Tools Versions

Tools 3.7.2

Release date: January 22, 2016

Known Issues

Individual Tools Versions

Tools 3.7.1

Release date: January 4, 2016

Compilation Build Fixes

Known Issues

Tools 3.7.0

Release date: December 10, 2015

New Features

  • (AQL) Support Creating Geo2DSphere Index on AQL. [TOOLS-236]
  • (ASADM) Updated collectinfo formatting. Changed timestamp to human readable format. [TOOLS-278]

Improvements

  • (ASADM) Improve command performance in presence of high latency node. [TOOLS-203]
  • (ASBACKUP) Increase disk i/o buffer to 15MiB. Add per thread stats. [TOOLS-507]
  • (ASBACKUP) Added per-thread stats (rec/s, disk read latency, record put latency) to the —verbose command line option. [TOOLS-509]

Bug Fixes

  • (PACKAGING) Aerospike Tools 3.6.2.2 & 3.6.3 fails to install on OS X El Capitan (10.11). [TOOLS-7]
  • (PACKAGING) Package removal does not clean up all files. [TOOLS-153]
  • (ASADM) Fix highlighting issue during watch command. [TOOLS-84]
  • (ASBACKUP) Issue #102 accept “TEXT” as string index for metadata backup. [TOOLS-490]

Known Issues

Individual Tools Versions

Tools 3.6.3

Release date: October 16, 2015

Maintenance Release.

  • Regression - Aerospike Tools 3.6.3 fails to install on OS X El Capitan (10.11). Fixed in version 3.7.0.

Known Issues

Tools 3.6.2.2

Release date: October 15, 2015

  • Regression - Aerospike Tools 3.6.2.2 fails to install on OS X El Capitan (10.11). Fixed in version 3.7.0.

New Features

  • (ASADM) Simplified show diff logic. [AER-4492]

Improvements

  • (ASADM) Prepare asadm to use new migration stats. [AER-3639]

Bug Fixes

  • (ASADM) Removed set comprehension for compatibility (fixes Python 2.6 compatibility). [TOOLS-292]
  • (ASADM) Fixed over highlighting in watch commands. [TOOLS-84]

Known Issues

Individual Tools Versions

Updates

Tools 3.6.2

Release date: October 9, 2015

  • Regression - asadm does not work with Python 2.6. Fixed in 3.6.2.2.

New Features

  • (ASADM) Cluster dun all command should be version aware. [AER-3587]
  • (ASADM) Add a “diff” modifier to show config [context]. [AER-4492]
  • (ASBACKUP) Added geospatial values and indices to asbackup and asrestore. [AER-4502]

Improvements

  • (ASADM) Prepare asadm to use new migration stats. [AER-3639]

Bug Fixes

  • (ASADM) Watch command over highlights. [TOOLS-84]

Known Issues

Individual Tools Versions

Tools 3.6.1

Release date: September 24, 2015

New Aerospike Backup/Restore Tool, Open-sourced at https://github.com/aerospike/aerospike-tools-backup.

Improvements

  • (AQL) Added “explain” for primary key functions. [AER-4438]
  • (AQL) Describe-index info call specify index type as NUMERIC/STRING (instead of TEXT and SIGNED INT). [AER-4439]
  • (ASBACKUP) Ability save system meta data - sindex and udf meta data. [AER-4440]
  • (ASBACKUP) Ability to backup/restore binary data w/o b64. [AER-4441]

Bug Fixes

  • (AQL) Fixed output so it is consistent with the client API. [TOOLS-49]

Known Issues

Individual Tools Versions

Tools 3.6.0

Release date: August 31, 2015

New Features

  • (ASADM) Introduce asadmin 0.0.1, alternative to asmonitor.

Bug Fixes

  • (AQL) Add meta data print to json format. [TOOLS-244]
  • (AQL) Add option of REPLICA_ANY.
  • (AQL) Fix SET RECORD_TTL override namespace default ttl. [TOOLS-130]
  • (AQL) Handle quote around bin name on an equality query. [TOOLS-194]
  • (AQL) Github#73 Fix double quote escape: Changed json output to use libjansson so all other escapes should be correct too. [TOOLS-85]
  • (AQL) Fix setting of LuaPath. [TOOLS-123]
  • (ASBACKUP) Honor ‘-s’ option for keys. [TOOLS-179]

Known Issues

Individual Tools Versions

Tools 3.5.11

Release date: May 22, 2015

Improvements

  • (AQL) Add EDIGEST and DIGEST as option of performing operation based on encoded and non-encoded digest string.

Bug Fixes

  • (AQL) Fix for authentication fail error message logging during cluster connect for security enabled server. [AER-3620]

Known Issues

Tools 3.5.9

Release date: April 21, 2015

  • Aerospike Tools are now available as standalone packages.

Bug Fixes

  • (AQL) Generate error if password keyword missing in create user command.
  • (ASCLI) Fixed - modified how bins are being iterated over. [TOOLS-26]

Known Issues

Feedback

Was this page helpful?

What type of feedback are you giving?

What would you like us to know?

+Capture screenshot

Can we reach out to you?