Aerospike Server Community Edition 7.2.0.1

Aerospike Database Release Notes 7.2

October 7, 2024

Aerospike Database software version 7.2 is now available.

New in this version

This version implements a variety of new features and improvements to enhance performance, usability, and reliability.

New features

XDR version shipping controls: Database 7.2 introduces a dynamically configurable mechanism to control how XDR ships versions of modified records, through two new configuration parameters: ship-versions-policy and ship-versions-interval
Active rack - with the active-rack namespace configuration parameter, you can designate a particular rack-id to hold all master partition copies. See Designate an active rack.
See the detailed complete list of all new features.

Updates

Aerospike Tools 11.1.0.
See Platform support and compatibility for all currently supported platforms.

Improvements and enhancements

The active-rack configuration allows one availability zone (AZ), represented by a distinct rack-id, to own all partition masters.
When quiescing nodes in AP namespaces,the effective replication factor (RF) is automatically decremented so that the quiesced node genuinely gives up partition ownership regardless of the configured RF.
New best practice checks at startup:
- rmem-max (which comes from /proc/sys/net/core/rmem_max) must be greater than 15MiB
- wmem-max (which comes from /proc/sys/net/core/wmem_max) must be greater than 5MiB
- The asd-systemd-helper script used to set rmem_max and wmem_max, and also potentially raised shmmax to 1GiB (less useful now that data may also use shmem). This script has been removed.

Breaking changes

Removed support for using yes or no for boolean parameters. All boolean parameters must use true or false.
- Affects the ignore-migrations field in the cluster-stable command.

Configuration item changes

Item	Action	Notes
`active-rack`	added	The rack that owns all of the masters in AP and SC namespaces.
`ship-versions-policy`	added	Stops XDR from skipping record versions.
`ship-versions-interval`	added	Relevant only if `ship-versions-policy` is true. With value 0, every version is shipped.

Metrics changes

Item	Action	Description
`early_tsvc_batch_sub_error`	removed
`early_tsvc_udf_sub_error`	removed
`early_tsvc_ops_sub_error`	removed
`effective_active_rack`	added	Roster’s current active-rack for SC namespaces.
`fail_xdr_key_busy`	added	Counts how many XDR key busy errors have occurred.
`nsup_xdr_key_busy`	added	Counts how many NSUP deletes (expirations and evictions) had to wait for a previous version to ship.

Info command updates

:::note

Make sure you are not passing invalid parameters as inputs are now checked more strictly. The reason for an info command failure is often articulated more clearly.
Most parameter check failures either result in error code 4 AS_ERR_PARAMETER or error code 20 AS_ERR_NAMESPACE - the latter only when parsing a namespace parameter.
:::

Item	Action	Description
`get-config`	modified	`id` parameter is now deprecated and `namespace` is accepted in its place.
`set-config`	modified	`id` parameter is now deprecated and `namespace` is accepted in its place.
`sindex-create`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`sindex-delete`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`sindex-exists`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`sindex-list`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`sindex-stat`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`xdr-dc-state`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`xdr-get-filter`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`get-config:context=xdr;dc=DC-NAME;`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.
`get-stats:context=xdr;dc=DC-NAME;`	modified	`ns` parameter is now deprecated and `namespace` is accepted in its place.

Error responses to info commands have been standardized to the format ERROR:<code>:<msg>

dump-cluster, dump-fabric, dump-hb, dump-hlc, dump-migrates, and dump-wb-summary used to return an error response format.
histogram used to return error-this-is-a-message.
recluster used to return ERROR when the clustering layer responded with anything other than success or ignored.
tip and tip-clear used to return an error response format.

The following minor changes were also made to the info command cleanup:

sindex-create and sindex-delete now return ok instead of OK on success.
Fixed various error codes and error messages to be more appropriate and clear.

Server log changes

Item	Action	Notes
`special-errors: key-busy` 123 ...	enhanced	Now reads `special-errors: key-busy` (123) (40) where the second number in the parentheses is the XDR key busy count.
`early-fail:`	modified	Now reads `early-fail: demarshal 0 tsvc-client 1 tsvc-from-proxy 0 tsvc-from-proxy-batch-sub 0`

Error code changes

Item	Action	Notes
XDR key busy	added	Occurs when a write must wait on a previous version to ship and either the write times out or there are already too many writes waiting.

Tools changes

Changes in Tools 11.1.0

See Tools 11.1.0 Release Notes.

Client/server feature compatibility

For a complete list of client features and the Aerospike Database versions that support them, see the Client Matrix.

Minimum compatible client versions

For full feature access in Database 7.2:

Java client 8.1
Python client 15.0
C# client 7.2
C client 6.6
Go client 7.2
Node.js client 5.12
PHP 1.0

Ecosystem compatibility

Compatible connector versions

Trino connector 1.7 or later
Spark connector 3.2.2 or later

Prerequisites and notes

For upgrade instructions, see Upgrade or Repair Server.

Complete list of changes

ID	Description
AER-6749	(BALANCE) For AP namespaces, exclude quiesced nodes when calculating effective replication factor.
AER-6753	(DEPLOYMENT) Added some new best practices and removed `asd-systemd-helper`.
AER-6754	(BALANCE) Added namespace context configuration item `active-rack` to specify a rack to own all partition masters.
AER-6762	(XDR) Added configuration to restrict or prevent skipping record versions when shipping.
AER-6763	(STATS) Removed some meaningless stats, and improved some cluster related logging.
AER-6764	(INFO) Standardized error responses to info commands.

Product lifecycle updates

Aerospike provides Maintenance and Support for 2 years (24 months) from its generally available (GA) release.
See Platform support for details.

Known issues

See Server Known Issues Reference.

aerospike/aerospike-server 7.2.0.1 on GitHub