Aerospike Database 7.2 Release Notes

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
AS_ERR_XDR_KEY_BUSY	added	Error code 32. Occurs when a write must wait on a previous version to ship and either the write times out or there are 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.