Skip to main content
Loading

Aerospike Tools Release Notes

Tools 10.2.1​

Release date: February 1, 2024

Aerospike Tools version 10.2.1 is now available.

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]

Individual Tools Versions​

Tools 10.1.0​

Release date: December 14, 2023

Aerospike Tools version 10.1.0 is now available.

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 server 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

Aerospike Tools version 10.0.1 is now available.

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 server 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

Aerospike Tools version 10.0.0 is now available.

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 Server 7.0.

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

Breaking Changes​

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

Bug Fixes​

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

Improvements​

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

Security​

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

Known Issues​

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

Individual Tools Versions​

Tools 9.2.1​

Release date: October 10, 2023

Aerospike Tools version 9.2.1 is now available.

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 via storage-engine device or storage-engine pmem metrics. [TOOLS-2679]
  • asadm Asadm's show config command displays incorrect values for the security.ldap context. [TOOLS-2697]

New features​

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

Upcoming changes​

Known Issues​

Individual Tools Versions​

Tools 9.1.0​

Release date: August 30, 2023

Aerospike Tools version 9.1.0 is now available.

Summary​

This version of Aerospike Tools adds asconfig schema support for Aerospike server 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 server 6.4 configuration. [TOOLS-2616]

Upcoming changes​

Known Issues​

Individual Tools Versions​

Tools 9.0.0​

Release date: July 26, 2023

Aerospike Tools version 9.0 is now available.

Summary​

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

Bug Fixes​

Improvements​

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

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

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

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

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

New features​

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

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

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

Breaking changes​

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

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

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

Upcoming changes​

Known Issues​

Individual Tools Versions​

Previous releases​

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

Last updated on