Loading
Aerospike Database Release Notes 6.4
Aerospike Database Release Notes 6.4, August 3, 2023
Aerospike Database software version 6.4 is now available.
New in this version
This version implements a variety of feature requests and improvements to enhance performance, usability and reliability.
Updates
- Support for Amazon Linux 2023
- Support for Debian 12
- Aerospike Tools 9.0
- See Platform support for all currently supported platforms
New features
- You can use Aerospike Secret Agent to fetch from AWS Secrets Manager
- Allows secondary indexes to be stored in Flash
- XDR partition affinity provides significantly higher shipping throughput, while using less service threads and socket connections
- See the detailed Complete list of all new features
- This version and subsequent Database 6.4.x Debian package software files (*.deb) and Red Hat Package Manager files (*.rpm) are now GPG Signed
Upgrade path from Database 5.x
A cluster of Aerospike Database 5 serving secondary index queries must pass through one of versions 6.0, 6.1, 6.2, or 6.3 before upgrading to 6.4 or higher. As always, consult the client matrix for the minimum version of clients supported by the server version you are targeting.
- See the Database 6.4 Special upgrade page for details.
- See the Minimum usable client version section of the Client Matrix to verify that the client you use is compatible with the database version you are targeting.
Configuration item changes
Configuration items added or enhanced
| Item | Action | Notes |
|---|---|---|
secrets-address-port | added | Configures AWS secrets port. |
secrets-tls-context | added | Subcontext of network to use for the Secret Agent TLS. |
secrets-uds-path | added | Configures a Unix Domain Socket (UDS) path. |
sindex-type | enhanced | Can be set to "flash". |
mount, mounts-size-limit, and mounts-high-water-pct | enhanced | Now apply to the "sindex-type flash" sub-context. |
Configuration items removed
| Item | Action | Notes |
|---|---|---|
batch-max-requests | removed | Unlimited batch size requires monitoring of resources |
scheduler-mode | removed | |
max-used-service-threads | removed | New XDR partition affinity uses less service threads and socket connections |
single-bin | removed | |
data-in-index | removed |
Info commands changes
| Item | Action | Notes |
|---|---|---|
latencies | enhanced | Add options to Parameters section: {ns}-batch-sub-read, {ns}-batch-sub-write, {ns}-batch-sub-udf. |
scan-abort | removed | Use query-abort. |
scan-abort-all | removed | Use query-abort-all. |
scan-show | removed | Use query-show. |
Metrics changes
| Item | Action | Notes |
|---|---|---|
sindex_flash_used_bytes | added | Total bytes in-use on All Flash for the secondary indexes. |
sindex_flash_used_pct | added | Percentage of All Flash in-use for the secondary indexes. |
sindex-type.mount[ix].age | added | Percentage of lifetime (total usage) claimed by OEM for underlying device. |
Server log changes
| Item | Action | Notes |
|---|---|---|
DETAIL (key-busy) | added | Describes the digest, transaction type and transaction source of a possibly hot key. |
sindex-flash-usage | added | Displayed every 10 seconds by default for each namespace configured with 'sindex-type flash'. |
Error code changes
- Error code 151 (BATCH_MAX_REQUESTS) is no longer returned starting with Database 6.4.
Complete list
| ID | Description |
|---|---|
| AER-6624 | (INFO) Removed support for deprecated commands scan-abort, scan-abort-all, and scan-show. |
| AER-6625 | (KVS) Removed support for single-bin namespaces. |
| AER-6629 | (STORAGE) Increased granularity of storage state to avoid superfluous defragmentation in certain cases. |
| AER-6631 | (QUERY) Share partition reservations among concurrent short queries, to improve performance. |
| AER-6633 | (XDR) Distribute ship requests across service threads using partition affinity, improving performance and reducing the number of connections to remote clusters. |
| AER-6635 | (KVS) For index-type flash namespaces, avoid unnecessarily rebuilding index free queues during warm restart, improving performance. |
| AER-6636 | (UDF) Improved Lua cache management so that a module can be re-registered while in use. |
| AER-6637 | (XDR) Removed DC namespace context configuration item 'max-used-service-threads'. |
| AER-6643 | (STORAGE) Cold start from local devices if they are present and their shadow devices indicate the previous shutdown was clean. |
| AER-6644 | (SINDEX) Added value flash for namespace context configuration item sindex-type to use flash for secondary indexes. |
| AER-6647 | (STORAGE) Removed storage context configuration item scheduler-mode. |
| AER-6648 | (BATCH) Removed service context configuration item batch-max-requests. |
| AER-6649 | (BATCH) Abandon a batch transaction at the client-specified timeout. |
| AER-6650 | (LOGGING) Added special detail logging context "key-busy" to help identify hot keys. |
| AER-6651 | (SINDEX) sindex-type pmem context configuration items mounts-size-limit and mounts-high-water-pct should be dynamic. |
| AER-6652 | (SECRETS) Added support for fetching secrets from external services using Aerospike Secret Agent. |
| AER-6653 | (TLS) Added support for SAN in TLS certificates. |
| AER-6654 | (STATS) Added latency histograms for batch sub-transactions. |
| AER-6657 | (CDT) When operating on a nested CDT, return the more appropriate "incompatible type" (error 12) on not finding the expected CDT type. |
| AER-6659 | (STORAGE) Updated storage compression submodules. |
Other changes
Changes in Tools 9.0
Prerequisites and notes
- For upgrade instructions, refer to Upgrade or Repair Server
- For special upgrade instructions, refer to Special Upgrades
Product lifecycle updates
Aerospike provides Maintenance and Support for 2 years (24 months) from it's generally available (GA) release. See Platform support for details.
Client/server feature compatiblity
For a complete list of client features and the server versions that support them, see the Client Matrix.
Ecosystem compatibility
Compatible client versions
- Java client 6.0 or later
- C client 5.2.3 or later
- C# client 4.2.2 or later
- Go client 5.4.0 or later
- Python client 6.1.0 or later
- Node.js client 4.0.0 or later
- Ruby client 2.25.0 or later
Compatible connector versions
- Trino connector 1.2.0 or later
- Spark connector 3.1.1 or later