Aerospike Server EE Release Notes

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.3.0.4-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.3.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.3.0.3-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.3.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.3.0.2-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.3.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.3.0.1-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.2.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.3-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.2.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.11-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.10-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.9-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.8-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.7-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.6-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.3-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.1.0

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.2-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2.0.1-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.0.3

• Release Notes are now available here: https://docs.aerospike.com/reference/release_notes/6.2-server-release-notes

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 8.0.2

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6646] - (CDT) For data-in-memory namespaces, failing any but the first modify operation on a given bin within a transaction may leak memory.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6640] - (CDT) With result type EXISTS, a GET_BY_VALUE_LIST operation on an ordered list always returns false.
  • [AER-6639] - (KVS) The system_free_mem... statistics incorrectly exclude available, lazily freed pages.
• Enterprise & Federal Only
  • [AER-6641] - (STORAGE) For strong-consistency namespaces, removing a device fails to flag the node as untrusted when it restarts.
  • [AER-6638] - (XDR) Removing connector seed nodes while connecting to a DC may cause an assertion.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6627] - (AGGREGATION) A range query on a list or map secondary index can overflow a record's ref-count and assert.
• Enterprise & Federal Only
  • [AER-6628] - (KVS) For index-type flash namespaces, configuring index-stage-size 4G or larger will cause warm restart to be abnormally slow.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6621] - (LOGGING) CDT operations resulting in "normal" errors ELEMENT_NOT_FOUND & ELEMENT_EXISTS are logged as warnings instead of detail.
  • [AER-6623] - (QUERY) For AP namespaces, queries may miss records during certain migration scenarios.
• Enterprise & Federal Only
  • [AER-6620] - (KVS) For index-type flash namespaces, configuring index-stage-size 4G or larger may cause assertions or other bad symptoms on warm restart.
  • [AER-6622] - (SINDEX) When cool restarting data-in-memory namespaces, a secondary-indexed record which expires after startup but before being loaded into memory will assert.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6617] - (DEPLOYMENT) The Aerospike server may fail to start in containers with cgroup v1 when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6618] - (EXPRESSIONS) Deleting a bin via a write operation expression will cause a crash.
  • [AER-6615] - (SMD) A module that is continually retransmitting may block another module's 'set' operations.
• Enterprise & Federal Only
  • [AER-6619] - (BALANCE) For strong-consistency namespaces, a stale appeal acknowledgement may cause a crash.
  • [AER-6616] - (XDR) Removing connector seed nodes while a DC is disconnected may cause an assertion on reconnection.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6612] - (CDT) Writing an ordered map with a map index bigger than the content may corrupt the map.
  • [AER-6614] - (CDT) With result type EXISTS, a GET_ALL_BY_KEY_LIST operation on an ordered map always returns false.
  • [AER-6610] - (DEPLOYMENT) The Aerospike server may fail to start in some containers when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6613] - (KVS) For single-bin, data-in-memory namespaces, writes using the delete-record operation may free the bin data twice and cause a crash.
  • [AER-6611] - (SINDEX) Dropping a secondary index on which there are active queries may cause an assertion or other bad symptoms.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6601] - (CLUSTERING) When a node fails to cluster due to a cluster size limit, it leaks memory.
  • [AER-6597] - (QUERY) A secondary index query may return incorrect results if the bin type changes from CDT to non-CDT during the query.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Improvements

• Enterprise, Federal & Community
  • [TOOLS-2286] - (ASADM) Bundle asadm with Python 3.10.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6583] - (INFO) A sindex-exists command where the 'ns' parameter does not match a namespace on the node will cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.3

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Improvements

• Enterprise, Federal & Community
  • [AER-6581] - (LOGGING) Changed logging level for 'starting/finished aggregation query job...' messages from info to debug.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6580] - (SINDEX) Deleting an indexed list or map containing multiple elements with the same value may leave inaccessible keys in the secondary index.
• Enterprise & Federal Only
  • [AER-6582] - (XDR) Setting DC context configuration item tls-name after adding seed nodes which require it may cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.3

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6576] - (SINDEX) Race between garbage collection and update of a secondary index entry may result in the erroneous removal of the entry.
• Enterprise & Federal Only
  • [AER-6572] - (XDR) Not setting DC context configuration item auth-user when auth-mode requires it will cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.3.1

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Improvements

• Enterprise & Federal Only
  • [AER-6570] - (DEPLOYMENT) With index-type flash namespaces, allow the server to start as a non-root user if the flash-index-friendly '/proc/sys' values have been set.

Bug Fixes

• Enterprise & Federal Only
  • [AER-6569] - (INFO) A cluster-stable command without a 'namespace' parameter will not check for unavailable and dead partitions.
  • [AER-6571] - (UDF) The record.numbins() and record.bin_names() functions erroneously include bin tombstones.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.3.1

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6568] - (QUERY) For single-bin namespaces, primary index queries erroneously fail without starting.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.2.1

• For upgrading, or the unlikely event of downgrading, refer to Special Upgrades.
• Special upgrade instructions for Aerospike Server 6.1.
  • Before you upgrade, find any secondary index names that exceed the new 64-character limit (including a null terminator), delete them, then recreate the sindex with a shorter name after the upgrade.
  • When upgrading, the secondary index sindex-create applies to the entire namespace, if the set parameter is omitted.
• Downgrade from Aerospike Database 6.1 to 6.0.
  • If you have to downgrade from a deployment of server 6.1 that has a secondary index stored in shared memory, delete the following shared memory segments after stopping the server (asd), in order to reclaim this memory.
  • Downgrading from Server 6.1 will force a cold start.
• Server 6.1 removes num-partitions and adds the sindex-stage-size configuration parameter for secondary indexes in the namespace context. sindex-stage-size is similar to the existing primary index index-stage-size configuration parameter. If the sindex-stage-size value is changed across a restart, any secondary indexes for the namespace will be rebuilt.
• There is a possibility of partial de-duplicate (repeated records) in secondary index query (SI query) responses for SI queries that use list or map type secondary indexes. Any record that satisfies such a query at least once will be included, but it is possible and normal to see a record more than once.
• Attempting to create a secondary index which already exists now returns success/OK instead of an error.
• List Operation EXISTS return type has been added.
• Map Operation EXISTS return type has been added.
• Map indexing and List indexing can be created at any depth. For example, an index on a map inside of a bin that is inside of another map can be created.
• Server 6.1 includes a simple feature key file allowing only for a single-node cluster. The feature key will not be valid for versions after Server 6.1.
  • Please be aware of your package manager's handling of existing configuration files during installation. If the configuration file was updated we keep the existing *.deb or *.rpm respective configuration file. It is the uninstall of the package where these systems diverge.
    • Debian and Ubuntu (*.deb) will leave the modified configurations in place.
    • Redhat (*.rpm) will rename the configuration file with an *.rpmsave extension.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.
• Debian 9 Stretch LTS has reached its End of Life on June 30 2022. We will drop support for Debian 9 in the upcoming Server 6.2 release.

New Features

• Enterprise, Federal & Community
  • [AER-6545] - (SINDEX) Added ability to define secondary indexes on elements within CDTs (Collection Data Types), by using CDT contexts.
• Enterprise & Federal Only
  • [AER-6543] - (SINDEX) Added support for warm restart of secondary indexes.

Improvements

• Enterprise, Federal & Community
  • [AER-6530] - (BATCH) Added an option to ensure that a sub-transaction error that stops a response will be included in the response.
  • [AER-6532] - (CDT) Added EXISTS return type, which may be used to optimize certain 'GET' operations.
  • [AER-6535] - (INFO) Added 'sindex-name' field to query-show output.
  • [AER-6548] - (INFO) Added smd-show command to retrieve raw SMD module data.
  • [AER-6531] - (LOGGING) Added 'long-queries' to in-progress ticker line, and renamed queries_active to long_queries_active.
  • [AER-6537] - (QUERY) Partially de-duplicate responses to range queries on list or map secondary indexes.
  • [AER-6546] - (SINDEX) When indexing list or map keys or values, iterate in msgpack directly instead of converting to as_list or as_map.
  • [AER-6550] - (SINDEX) A secondary index without a set name now applies to the entire namespace.
  • [AER-6551] - (SINDEX) The size limit for a secondary index name has been reduced to 64.
  • [AER-6547] - (STATS) Added entries_per_bval and entries_per_rec secondary index cardinality statistics.
  • [AER-6534] - (UDF) New as_map implementation improves (de-)serialization of ordered maps when executing UDFs.
• Enterprise & Federal Only
  • [AER-6549] - (DEPLOYMENT) Automatically install an Enterprise evaluation feature key.
  • [AER-6538] - (SINDEX) For index-type flash namespaces, use smaller internal batch sizes for garbage collection and queries, to minimize time under lock.
  • [AER-6540] - (STATS) Added bytes_shipped namespace statistic in XDR.
  • [AER-6544] - (XDR) For connector destinations, use digest affinity (instead of round-robin) to ensure that a record always goes to the same node.
  • [AER-6565] - (XDR) Distribute recovery/rewind requests across service threads using partition affinity, avoiding lock contention and significantly improving performance.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.2.0

• This General Availability release 6.0.0.18 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6646] - (CDT) For data-in-memory namespaces, failing any but the first modify operation on a given bin within a transaction may leak memory.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.17 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6639] - (KVS) The system_free_mem... statistics incorrectly exclude available, lazily freed pages.
• Enterprise & Federal Only
  • [AER-6641] - (STORAGE) For strong-consistency namespaces, removing a device fails to flag the node as untrusted when it restarts.
  • [AER-6638] - (XDR) Removing connector seed nodes while connecting to a DC may cause an assertion.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.16 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6627] - (AGGREGATION) A range query on a list or map secondary index can overflow a record's ref-count and assert.
• Enterprise & Federal Only
  • [AER-6628] - (KVS) For index-type flash namespaces, configuring index-stage-size 4G or larger will cause warm restart to be abnormally slow.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.15 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6621] - (LOGGING) CDT operations resulting in "normal" errors ELEMENT_NOT_FOUND & ELEMENT_EXISTS are logged as warnings instead of detail.
  • [AER-6623] - (QUERY) For AP namespaces, queries may miss records during certain migration scenarios.
• Enterprise & Federal Only
  • [AER-6620] - (KVS) For index-type flash namespaces, configuring index-stage-size 4G or larger may cause assertions or other bad symptoms on warm restart.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.14 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6617] - (DEPLOYMENT) The Aerospike server may fail to start in containers with cgroup v1 when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6618] - (EXPRESSIONS) Deleting a bin via a write operation expression will cause a crash.
  • [AER-6615] - (SMD) A module that is continually retransmitting may block another module's 'set' operations.
• Enterprise & Federal Only
  • [AER-6619] - (BALANCE) For strong-consistency namespaces, a stale appeal acknowledgement may cause a crash.
  • [AER-6616] - (XDR) Removing connector seed nodes while a DC is disconnected may cause an assertion on reconnection.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.13 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6612] - (CDT) Writing an ordered map with a map index bigger than the content may corrupt the map.
  • [AER-6610] - (DEPLOYMENT) The Aerospike server may fail to start in some containers when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6613] - (KVS) For single-bin, data-in-memory namespaces, writes using the delete-record operation may free the bin data twice and cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.11 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6601] - (CLUSTERING) When a node fails to cluster due to a cluster size limit, it leaks memory.
  • [AER-6597] - (QUERY) A secondary index query may return incorrect results if the bin type changes from CDT to non-CDT during the query.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.10 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise, Federal & Community
  • [TOOLS-2286] - (ASADM) Bundle asadm with Python 3.10.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.4

• This General Availability release 6.0.0.9 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise, Federal & Community
  • [AER-6581] - (LOGGING) Changed logging level for 'starting/finished aggregation query job...' messages from info to debug.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6580] - (SINDEX) Deleting an indexed list or map containing multiple elements with the same value may leave inaccessible keys in the secondary index.
• Enterprise & Federal Only
  • [AER-6582] - (XDR) Setting DC context configuration item tls-name after adding seed nodes which require it may cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 8.0.3

• This General Availability release 6.0.0.8 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6576] - (SINDEX) Race between garbage collection and update of a secondary index entry may result in the erroneous removal of the entry.
• Enterprise & Federal Only
  • [AER-6572] - (XDR) Not setting DC context configuration item auth-user when auth-mode requires it will cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.3.1

• This General Availability release 6.0.0.7 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Federal Only
  • [AER-6570] - (DEPLOYMENT) With index-type flash namespaces, allow the server to start as a non-root user if the flash-index-friendly '/proc/sys' values have been set.

Bug Fixes

• Enterprise & Federal Only
  • [AER-6569] - (INFO) A cluster-stable command without a 'namespace' parameter will not check for unavailable and dead partitions.
  • [AER-6571] - (UDF) The record.numbins() and record.bin_names() functions erroneously include bin tombstones.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.3.1

• This General Availability release 6.0.0.6 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6568] - (QUERY) For single-bin namespaces, primary index queries erroneously fail without starting.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.2.1

• This General Availability release 6.0.0.5 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6566] - (SINDEX) When cold starting storage-backed data-in-memory namespaces, finding a later but expired version of a secondary-indexed record will assert.
• Enterprise & Federal Only
  • [AER-6567] - (SINDEX) For index-type flash, a client non-durably deleting a secondary-indexed record may cause an assertion.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.1.1

• This release is superseded by 6.0.0.5.
• This General Availability release 6.0.0.4 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Federal Only
  • [AER-6562] - (SINDEX) For index-type flash, adjust secondary index(es) directly on non-durable deletes, instead of relying on garbage collection. [Note: this introduced an issue fixed in AER-6567.]

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6564] - (CDT) A context operation on a CDT with top-level list which changes the CDT size such that it crosses a 256, 64K, or 1M byte boundary may cause a crash.
  • [AER-6563] - (EXPRESSIONS) For namespaces with data not in memory, a client-provided object used as a bin in a call may cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

• This General Availability release 6.0.0.3 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6555] - (UDF) For namespaces with data not in memory, a UDF that writes multiple bins and would exceed write-block-size may cause a crash.
• Enterprise & Federal Only
  • [AER-6553] - (XDR) A source node may never discover all destination nodes if it starts with partial visibility of the remote cluster.
  • [AER-6554] - (MIGRATION) For strong-consistency namespaces, a failed appeal may block a node from starting migrations.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.0.5

• This General Availability release 6.0.0.2 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6541] - (EXPRESSIONS) A cond in an expression fails to set the return type, which may allow an illegal expression to build and cause an assertion.
  • [AER-6533] - (LOGGING) Set index memory is not included in 'total-bytes' and 'used-pct' on the memory-usage ticker line.
• Enterprise & Federal Only
  • [AER-6536] - (LOGGING) TLS I/O error may log incorrect errno.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

• This General Availability release 6.0.0.1 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6529] - (SINDEX) Garbage collection does not decrement memory_used_sindex_bytes, which may cause erroneous stop-writes or eviction.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

• This General Availability release 6.0.0.0 contains all hotfixes deployed during the release candidate cycle.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

New Features

• Enterprise, Federal & Community
  • [AER-6511] - (PACKAGING) Added support for Debian 11.
  • [AER-6512] - (PACKAGING) Removed support for Debian 8.
  • [AER-6500] - (QUERY) Enhanced secondary index queries: query by partition, paginate, throttle, apply quotas.

Improvements

• Enterprise, Federal & Community
  • [AER-6488] - (BALANCE) For AP namespaces, made namespace context configuration item replication-factor dynamic.
  • [AER-6489] - (BALANCE) Removed service context configuration item paxos-single-replica-limit.
  • [AER-6499] - (BATCH) Added support for batch writes, deletes, and UDFs.
  • [AER-6509] - (DEPLOYMENT) With auto-pin numa, handle client interfaces with differing numbers of queues.
  • [AER-6492] - (EXPRESSIONS) Removed support for predicate expressions.
  • [AER-6485] - (KVS) Fail duplicate resolutions if they are overwhelming the write queue.
  • [AER-6504] - (KVS) Check 'rw-hash' and 'proxy-hash' for timed out transactions more frequently, to help the client recycle sockets more efficiently.
  • [AER-6510] - (MIGRATION) Do not retransmit updated or deleted records.
  • [AER-6515] - (PACKAGING) Ensure that the 'aerospike' user has a secure nologin shell.
  • [AER-6506] - (SCAN) Unified scans with new queries.
  • [AER-6491] - (STATS) Latency histograms now include time spent processing other service epoll events that precede the transaction request.
  • [AER-6507] - (STATS) Base heap_efficiency_pct on active rather than mapped memory.
  • [AER-6513] - (STORAGE) Detect and mitigate records which are only partially written during an unclean shutdown.
  • [AER-6514] - (STORAGE) Verify that a device not previously used as an Aerospike storage device was erased before use.
  • [AER-6503] - (UDF) Removed unused 'gen' field from udf-get response, and added sanity check of 'content-len' field in udf-put command.
• Enterprise & Federal Only
  • [AER-6495] - (ACL) Added a separate 'truncate' privilege (no longer under 'write'), 'udf-admin' privilege, and 'sindex-admin' privilege.
  • [AER-6487] - (BALANCE) To restore availability, revived nodes now require all nodes to be trusted (i.e. no e-flags).
  • [AER-6505] - (LOGGING) Separated relevant XDR per-DC ticker line items into per-namespace lines.
  • [AER-6501] - (SECURITY) Added support for a special Enterprise build which is FIPS 140-2 compliant.
  • [AER-6483] - (XDR) Added DC namespace context configuration item compression-threshold to specify a size threshold for compression.
  • [AER-6490] - (XDR) Added value 'no-bins' to DC namespace context configuration item bin-policy, to ship record metadata only, including keys, to connectors.
  • [AER-6497] - (XDR) Reapply set shipping filters, and other configured filters, during retries.
  • [AER-6498] - (XDR) Changed automatic throttling to reduce throughput more quickly, with a lower floor.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.0.3

• This is a Developer Preview Release.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6526] - (SINDEX) Truncating a namespace or set with a secondary index, and more than 2 billion records per node, may overflow a garbage collection queue and crash.
• Enterprise & Federal Only
  • [AER-6527] - (XDR) Dynamically removing seed nodes while trying to connect may cause connections to be skipped or cause a crash.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.0.2

• This is a Developer Preview Release.
• When upgrading to server version 6.0, you must either trim or wipe (zeroize) the Aerospike header on the devices. A modified record storage format was introduced by AER-6513, which adds protection against partially written records during an unclean shutdown.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• BREAKING CHANGE: The truncate privilege is now a separate privilege and is no longer under write.
• The batch operations capability has been made comprehensive. We now fully support batch reads, writes, deletes, and UDF commands.
• The previously deprecated Predicate Expression API has been removed. Use Aerospike Filter Expressions (added in version 5.2).
• Service context configuration paxos-single-replica-limit has been removed.
• Configurations, Metrics, and Server Logs related to Scans are now referred to as Primary Index Queries (pi queries). For example, scan_basic_complete is now referred to as pi_query_long_basic_complete.
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • query-show replaces query-list and the deprecated scan-show command.
  • query-abort replaces query-kill and the deprecated scan-abort command.
• The batch-without-digests configuration parameter has been removed.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• Several configuration parameters have been renamed or removed. Please refer to Config, Metrics, and Info Changes in Aerospike Database 6.0.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

New Features

• Enterprise, Federal & Community
  • [AER-6511] - (PACKAGING) Added support for Debian 11.
  • [AER-6512] - (PACKAGING) Removed support for Debian 8.
  • [AER-6500] - (QUERY) Enhanced secondary index queries: query by partition, paginate, throttle, apply quotas.

Improvements

• Enterprise, Federal & Community
  • [AER-6488] - (BALANCE) For AP namespaces, made namespace context configuration item replication-factor dynamic.
  • [AER-6489] - (BALANCE) Removed service context configuration item paxos-single-replica-limit.
  • [AER-6499] - (BATCH) Added support for batch writes, deletes, and UDFs.
  • [AER-6509] - (DEPLOYMENT) With auto-pin numa, handle client interfaces with differing numbers of queues.
  • [AER-6492] - (EXPRESSIONS) Removed support for predicate expressions.
  • [AER-6485] - (KVS) Fail duplicate resolutions if they are overwhelming the write queue.
  • [AER-6504] - (KVS) Check 'rw-hash' and 'proxy-hash' for timed out transactions more frequently, to help the client recycle sockets more efficiently.
  • [AER-6510] - (MIGRATION) Do not retransmit updated or deleted records.
  • [AER-6515] - (PACKAGING) Ensure that the 'aerospike' user has a secure nologin shell.
  • [AER-6506] - (SCAN) Unified scans with new queries.
  • [AER-6491] - (STATS) Latency histograms now include time spent processing other service epoll events that precede the transaction request.
  • [AER-6507] - (STATS) Base heap_efficiency_pct on active rather than mapped memory.
  • [AER-6513] - (STORAGE) Detect and mitigate records which are only partially written during an unclean shutdown.
  • [AER-6514] - (STORAGE) Verify that a device not previously used as an Aerospike storage device was erased before use.
  • [AER-6503] - (UDF) Removed unused 'gen' field from udf-get response, and added sanity check of 'content-len' field in udf-put command.
• Enterprise & Federal Only
  • [AER-6495] - (ACL) Added a separate 'truncate' privilege (no longer under 'write'), 'udf-admin' privilege, and 'sindex-admin' privilege.
  • [AER-6487] - (BALANCE) To restore availability, revived nodes now require all nodes to be trusted (i.e. no e-flags).
  • [AER-6505] - (LOGGING) Separated relevant XDR per-DC ticker line items into per-namespace lines.
  • [AER-6501] - (SECURITY) Added support for a special Enterprise build which is FIPS 140-2 compliant.
  • [AER-6483] - (XDR) Added DC namespace context configuration item compression-threshold to specify a size threshold for compression.
  • [AER-6490] - (XDR) Added value 'no-bins' to DC namespace context configuration item bin-policy, to ship record metadata only, including keys, to connectors.
  • [AER-6497] - (XDR) Reapply set shipping filters, and other configured filters, during retries.
  • [AER-6498] - (XDR) Changed automatic throttling to reduce throughput more quickly, with a lower floor.

Known Issues

• If you use ‘equality’ secondary index queries that return a small number of records, you may see a latency increase in server releases 6.0-6.2. A partial fix is included in server 6.3, and a complete fix for server 7.0.
• If your secondary index query only returns 0 records or 1 record, meaning that it is acting as a unique index, you should consider converting such a query to a get/exists operation by creating a self-managed reverse index (lookup table).
• Spark Connector version 3.5 starts using batch writes when possible, a feature which was introduced in Aerospike server version 6.0. Consult the Spark Connector rate limiting documentation before you upgrade the server. Pay attention to throttling write throughput, and use Spark Connector 3.5.5 or later, which fixes throttling behavior to conform to the aerospike.transaction.rate.
• Known Issues: Server

Updates

• aerospike-tools 7.0.0

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6621] - (LOGGING) CDT operations resulting in "normal" errors ELEMENT_NOT_FOUND & ELEMENT_EXISTS are logged as warnings instead of detail.
  • [AER-6623] - (QUERY) For AP namespaces, queries may miss records during certain migration scenarios.
• Enterprise & Federal Only
  • [AER-6620] - (KVS) For index-type flash namespaces, configuring index-stage-size 4G or larger may cause assertions or other bad symptoms on warm restart.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6617] - (DEPLOYMENT) The Aerospike server may fail to start in containers with cgroup v1 when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6618] - (EXPRESSIONS) Deleting a bin via a write operation expression will cause a crash.
  • [AER-6615] - (SMD) A module that is continually retransmitting may block another module's 'set' operations.
• Enterprise Only
  • [AER-6619] - (BALANCE) For strong-consistency namespaces, a stale appeal acknowledgement may cause a crash.
  • [AER-6616] - (XDR) Removing connector seed nodes while a DC is disconnected may cause an assertion on reconnection.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6612] - (CDT) Writing an ordered map with a map index bigger than the content may corrupt the map.
  • [AER-6610] - (DEPLOYMENT) The Aerospike server may fail to start in some containers when the available CPUs are a proper subset of the actual CPUs.
  • [AER-6613] - (KVS) For single-bin, data-in-memory namespaces, writes using the delete-record operation may free the bin data twice and cause a crash.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6601] - (CLUSTERING) When a node fails to cluster due to a cluster size limit, it leaks memory.
  • [AER-6597] - (QUERY) A secondary index query may return incorrect results if the bin type changes from CDT to non-CDT during the query.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6593] - (SINDEX) If garbage collection pauses at a sub-tree boundary, elements may be skipped, causing later queries to assert or return incorrect results.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6582] - (XDR) Setting DC context configuration item tls-name after adding seed nodes which require it may cause a crash.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6572] - (XDR) Not setting DC context configuration item auth-user when auth-mode requires it will cause a crash.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Community
  • [TOOLS-2227] - Bundles Aerospike Tools version 6.3.1 package with Aerospike Server 5.7, removing aerospike-loader.
    • The Aerospike Loader can be downloaded from https://github.com/aerospike/aerospike-loader/releases

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.3.1

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise Only
  • [AER-6570] - (DEPLOYMENT) With index-type flash namespaces, allow the server to start as a non-root user if the flash-index-friendly '/proc/sys' values have been set.

Bug Fixes

• Enterprise Only
  • [AER-6569] - (INFO) A cluster-stable command without a 'namespace' parameter will not check for unavailable and dead partitions.
  • [AER-6571] - (UDF) The record.numbins() and record.bin_names() functions erroneously include bin tombstones.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6566] - (SINDEX) When cold starting storage-backed data-in-memory namespaces, finding a later but expired version of a secondary-indexed record will assert.
• Enterprise Only
  • [AER-6567] - (SINDEX) For index-type flash, a client non-durably deleting a secondary-indexed record may cause an assertion.

Known Issues

• Known Issues: Server

• This release is superseded by 5.7.0.21.
• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6564] - (CDT) A context operation on a CDT with top-level list which changes the CDT size such that it crosses a 256, 64K, or 1M byte boundary may cause a crash.
  • [AER-6563] - (EXPRESSIONS) For namespaces with data not in memory, a client-provided object used as a bin in a call may cause a crash.
• Enterprise Only
  • [AER-6562] - (SINDEX) For index-type flash, adjust secondary index(es) directly on non-durable deletes, instead of relying on garbage collection. [Note: this introduced an issue fixed in AER-6567.]

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6555] - (UDF) For namespaces with data not in memory, a UDF that writes multiple bins and would exceed write-block-size may cause a crash.
• Enterprise Only
  • [AER-6553] - (XDR) A source node may never discover all destination nodes if it starts with partial visibility of the remote cluster.
  • [AER-6554] - (MIGRATION) For strong-consistency namespaces, a failed appeal may block a node from starting migrations.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.1.2

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6539] - (EXPRESSIONS) Comparisons of expression trileans that include 'unknown' do not return 'unknown'.
  • [AER-6541] - (EXPRESSIONS) A cond in an expression fails to set the return type, which may allow an illegal expression to build and cause an assertion.
  • [AER-6533] - (LOGGING) Set index memory is not included in 'total-bytes' and 'used-pct' on the memory-usage ticker line.
• Enterprise Only
  • [AER-6536] - (LOGGING) TLS I/O error may log incorrect errno.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6526] - (SINDEX) Truncating a namespace or set with a secondary index, and more than 2 billion records per node, may overflow a garbage collection queue and crash.
• Enterprise Only
  • [AER-6527] - (XDR) Dynamically removing seed nodes while trying to connect may cause connections to be skipped or cause a crash.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6525] - (XDR) For single-bin, data-in-memory namespaces, shipping records will corrupt the index and may cause a crash.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6523] - (EXPRESSIONS) An empty expression may cause a crash, and a 1-byte expression operation with value zero is misinterpreted as a legacy predexp filter.
  • [AER-6524] - (QUERY) Background UDF/ops queries will leak memory.
• Enterprise Only
  • [AER-6521] - (STORAGE) For storage-engine pmem namespaces, dynamically setting defrag-lwm-pct will set one-eighth the intended threshold.
  • [AER-6520] - (XDR) Removing multiple connector seed nodes in rapid succession may cause an assertion.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6519] - (UDF) A UDF that tries to return a list or map containing an as_rec element will cause an assertion.
• Enterprise Only
  • [AER-6518] - (XDR) Dynamically adding/removing seed nodes and changing the DC context configuration item connector may cause an assertion.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6517] - (QUERY) A no-bins query with an expression filter may return records that it should not.
• Enterprise Only
  • [AER-6516] - (XDR) When a namespace is disabled, the lag, in_queue, and in_progress statistics are not properly cleared.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6508] - (TLS) Race between TLS handshake and changing the certificate chain may cause a crash.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6502] - (SINDEX) Garbage collector reads start key from secondary index without locking, which may cause an assertion.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Community
  • [AER-6484] - (LOGGING) Added a ticker warning for write-commit-level 'master' transactions overloading fabric send queues.

Bug Fixes

• Enterprise & Community
  • [AER-6496] - (QUERY) Info commands to show all queries may cause a crash.
• Enterprise Only
  • [AER-6486] - (STATS) For strong-consistency namespaces, re-replications that time out while queued internally will be reflected in the latency histogram.
  • [AER-6493] - (UDF) The method aerospike:exists() incorrectly returns true for a tombstone.

Known Issues

• Known Issues: Server

• For upgrading, or the unlikely event of downgrading, please refer to Special Upgrades.
• The Predicate Expression API is obsolete. The Aerospike Server and Client have scheduled removal with our next major Aerospike Server release. Use Aerospike Filter Expressions (added in version 5.2).
• The jobs info command is now officially deprecated and will continue to be supported through a deprecation period, after which it will be removed. jobs are now redundant with the new secondary index building methods and the following new info commands:
  • scan-show replaces scan-list.
  • query-show replaces query-list.
  • query-abort replaces query-kill.
• The configuration parameter batch-without-digests, now defaults to true, is deprecated and will be removed in six months. Customers using clients older than a year (around the time of Server 4.9 which introduced batch-without-digests) will now have to explicitly set the batch-without-digests configuration item to false.
• A number of Best Practices will be checked at startup. The Best Practices can be enforced by enabling the new enforce-best-practices configuration item.
• The security context configuration items enable-security and enable-ldap have been removed. The Server will not start if either enable-security or enable-ldap is present in the configuration file.
• Security will now be enabled simply by the presence of the security { } section in the configuration file. Similarly, LDAP will now be enabled simply by the presence of the ldap { } section within the security { } section of the configuration file.
• To use XDR with ACL auth-mode must be explicitly configured.
  • For more information please refer to: Securing with access control using PKI (versions 5.7+).
• We build on Red Hat Enterprise Linux (RHEL) 8 instead of CentOS 8 when creating rpm packages.
  • For more information please refer to: CentOS Linux EOL.
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Community
  • [AER-6429] - (BATCH) Changed default value of service context configuration item batch-without-digests to true - the item is now deprecated.
  • [AER-6430] - (CLUSTERING) Reject the recluster info command if already reclustering.
  • [AER-6461] - (DEPLOYMENT) Sanity-check various system settings and server configuration items at startup.
  • [AER-6432] - (FABRIC) Handle fabric node list with a more granular hash and an improved node id hash function.
  • [AER-6459] - (GEO) Changed namespace geo2dsphere-within context configuration item max-level default from 30 to 20.
  • [AER-6455] - (INFO) Replaced scan-list and query-list with scan-show and query-show, renamed query-kill to query-abort.
  • [AER-6433] - (KVS) Switch write transactions from write-commit-level 'master' to 'all' if fabric send queues are overwhelmed.
  • [AER-6441] - (KVS) Reject replica writes if they are overwhelming the write queue.
  • [AER-6447] - (KVS) By default, exclude group and 'other' permissions when creating files.
  • [AER-6452] - (KVS) Removed non-essential sprig element counters, saving three bytes of overhead per sprig.
  • [AER-6470] - (KVS) Replaced fabric idle connection queue and storage device open file descriptor queues with lockless pools.
  • [AER-6471] - (KVS) Upgraded JEMalloc submodule to 'stable-4' version, plus modifications for Valgrind.
  • [AER-6434] - (LOGGING) Do not truncate the log file when (re)opening it during log rotation.
  • [AER-6460] - (LOGGING) Improved logging around duplicate node-ids.
  • [AER-6428] - (MIGRATION) Pause immigrations if they are overwhelming the write queue.
  • [AER-6450] - (SCAN) Queue dynamic set-index population jobs, to serialize them and reduce CPU usage.
  • [AER-6464] - (SINDEX) Secondary indexes store primary index references instead of digests - reduces memory footprint and improves garbage collection.
  • [AER-6476] - (STATS) Added system_thp_mem_kbytes statistic.
  • [AER-6436] - (STORAGE) Added namespace context configuration item max-record-size.
  • [AER-6468] - (STORAGE) Allow value of 0 for storage context configuration item defrag-startup-minimum, and made that the default.
• Enterprise Only
  • [AER-6454] - (ACL) Moved configuration item session-ttl from 'ldap' to 'security' context, and ldap-login-threads (renamed as login-threads) from 'security' to 'ldap' context.
  • [AER-6456] - (ACL) Removed security context configuration items enable-security and enable-ldap.
  • [AER-6462] - (ACL) Added support for PKI authentication.
  • [AER-6453] - (AUDIT) Added separate 'audit' logging context so that auditing via a regular log sink will not include all 'security' context logs.
  • [AER-6431] - (STATS) Added unreplicated_records statistic for strong-consistency namespaces.
  • [AER-6445] - (STORAGE) Added storage context configuration item encryption-old-key-file to support rotation of encryption keys.
  • [AER-6449] - (STORAGE) Updated storage compression submodules.
  • [AER-6440] - (XDR) Disallow DC context configuration items auth-user and auth-password-file for connector DCs.
  • [AER-6443] - (XDR) An 'xdr' context in the configuration file is no longer required in order to configure DCs dynamically.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 6.1.0

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Federal Only
  • [AER-6569] - (INFO) A cluster-stable command without a 'namespace' parameter will not check for unavailable and dead partitions.
  • [AER-6571] - (UDF) The record.numbins() and record.bin_names() functions erroneously include bin tombstones.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise, Federal & Community
  • [AER-6564] - (CDT) A context operation on a CDT with top-level list which changes the CDT size such that it crosses a 256, 64K, or 1M byte boundary may cause a crash.
  • [AER-6563] - (EXPRESSIONS) For namespaces with data not in memory, a client-provided object used as a bin in a call may cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6555] - (UDF) For namespaces with data not in memory, a UDF that writes multiple bins and would exceed write-block-size may cause a crash.
• Enterprise Only
  • [AER-6553] - (XDR) A source node may never discover all destination nodes if it starts with partial visibility of the remote cluster.
  • [AER-6554] - (MIGRATION) For strong-consistency namespaces, a failed appeal may block a node from starting migrations.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6539] - (EXPRESSIONS) Comparisons of expression trileans that include 'unknown' do not return 'unknown'.
  • [AER-6541] - (EXPRESSIONS) A cond in an expression fails to set the return type, which may allow an illegal expression to build and cause an assertion.
  • [AER-6533] - (LOGGING) Set index memory is not included in 'total-bytes' and 'used-pct' on the memory-usage ticker line.
• Enterprise Only
  • [AER-6536] - (LOGGING) TLS I/O error may log incorrect errno.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6526] - (SINDEX) Truncating a namespace or set with a secondary index, and more than 2 billion records per node, may overflow a garbage collection queue and crash.
• Enterprise Only
  • [AER-6527] - (XDR) Dynamically removing seed nodes while trying to connect may cause connections to be skipped or cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6525] - (XDR) For single-bin, data-in-memory namespaces, shipping records will corrupt the index and may cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6523] - (EXPRESSIONS) An empty expression may cause a crash, and a 1-byte expression operation with value zero is misinterpreted as a legacy predexp filter.
• Enterprise Only
  • [AER-6521] - (STORAGE) For storage-engine pmem namespaces, dynamically setting defrag-lwm-pct will set one-eighth the intended threshold.
  • [AER-6520] - (XDR) Removing multiple connector seed nodes in rapid succession may cause an assertion.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6519] - (UDF) A UDF that tries to return a list or map containing an as_rec element will cause an assertion.
• Enterprise Only
  • [AER-6518] - (XDR) Dynamically adding/removing seed nodes and changing the DC context configuration item connector may cause an assertion.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6516] - (XDR) When a namespace is disabled, the lag, in_queue, and in_progress statistics are not properly cleared.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6508] - (TLS) Race between TLS handshake and changing the certificate chain may cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6486] - (STATS) For strong-consistency namespaces, re-replications that time out while queued internally will be reflected in the latency histogram.
  • [AER-6493] - (UDF) The method aerospike:exists() incorrectly returns true for a tombstone.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6479] - (EXPRESSIONS) For data-in-memory namespaces, an expression let which returns the value of one of its variables may leak memory.
  • [AER-6481] - (KVS) When a service thread exits, its epoll queue's event file descriptor leaks.
  • [AER-6480] - (SCAN) A paginated scan on a set which is indexed may not return the correct records.
  • [AER-6482] - (STORAGE) When a device runs completely out of space, defrag becomes ineffective.
• Enterprise Only
  • [AER-6478] - (STATS) For storage-engine pmem namespaces, the device_data_bytes set statistic is not initialized during warm restart.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6477] - (UDF) When a UDF write fails due to a stop-writes condition, the record may be erroneously deleted.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Improvements

• Enterprise & Community
  • [AER-6475] - (GEO) For data-in-memory namespaces, when trimming GeoJSON particles, reallocate into the appropriate namespace arena.

Bug Fixes

• Enterprise & Community
  • [AER-6473] - (EXPRESSIONS) For data-in-memory namespaces, an expression let which returns the value of one of its variables will cause a double-free.
  • [AER-6472] - (SINDEX) If a replica record is expired or truncated, but not yet actually deleted, it is skipped when building a secondary index, but may also be skipped by a replica write.
• Enterprise Only
  • [AER-6474] - (XDR) DC throughput statistic may be incorrect when there are multiple namespaces.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6467] - (SINDEX) With storage compression, replicas and existing records are decompressed into the same buffer, which may result in an incorrect secondary index or a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6457] - (CDT) Improper CDT operation initialization may access out of scope stack memory and crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6451] - (KVS) Race condition between sprig element counters and changing sprig roots when rebuilding index during warm restart may cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6444] - (CDT) For putItems(), the policy check is skipped for empty ordered maps.
• Enterprise Only
  • [AER-6446] - (SCAN) Race condition when populating set indexes during warm restarts may cause a crash.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise & Community
  • [AER-6438] - (QUERY) A background operations query may become inaccessible via the job monitor before it completes.
  • [AER-6439] - (SCAN) Disabling a set index while it is being populated may result in a deadlock.

Known Issues

• Known Issues: Server

• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

Bug Fixes

• Enterprise Only
  • [AER-6427] - (KVS) For data-in-index namespaces, durable deletes will cause an unnecessary assertion on a warm restart.
  • [AER-6437] - (KVS) Improper initialization of set index trees during warm restart may eventually cause a crash.

Known Issues

• Known Issues: Server

• Aerospike Server release 5.6.0.3 contained a bug that may cause a server crash (AER-6437).
  • If you are running Aerospike Server version 5.6, we recommend that you upgrade to the latest release (currently 5.6.0.4).
• The older Aerospike Connect Outbound versions do not work with Aerospike Server version 5.6 or newer. If you are using Aerospike Connect Outbound, you should upgrade respectively to:
  • Aerospike Connect for JMS - Outbound version 3.0.0 or newer
  • Aerospike Connect for Kafka - Outbound version 4.0.0 or newer
  • Aerospike Connect for Pulsar - Outbound version 2.0.0 or newer
  • XDR Proxy version 1.1.0 or newer
• In Aerospike Server 5.5 or earlier, a UDF returning a Boolean value as a bin would be converted to 1 or 0. In Aerospike 5.6 or newer the value returns as true or false.
• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• 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 are removed in Aerospike Server 5.6.
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• The Predicate Expression API will be removed in the Aerospike Server version 6.0 release. Use Aerospike Filter Expressions (added in version 5.2).
• We have removed support for Ubuntu 16.04.
  • For more information please refer to: Ubuntu 16.04 LTS (Xenial Xerus).
• Use Prometheus Exporter version 1.2.1 or later to run Prometheus Exporter with this version of Aerospike Server.

New Features

• Enterprise & Community
  • [AER-6400] - (EXPRESSIONS) Added support for Operation Expressions.
  • [AER-6399] - (EXPRESSIONS) Added support for arithmetic, branching, and variables to expressions.
  • [AER-6392] - (KVS) Added support for Boolean particle type.
  • [AER-6421] - (SCAN) Added set context configuration item enable-index to maintain a set-specific index for scans of the set.
• Enterprise Only
  • [AER-6416] - (ACL) Added support for rate quotas, including per-user rate statistics.

Improvements

• Enterprise & Community
  • [AER-6422] - (EXPRESSIONS) Added a ticker warning for use of the deprecated predexp API.
  • [AER-6398] - (FABRIC) Handle fabric node list with more granular locking.
  • [AER-6407] - (KVS) Added service context configuration item os-group-perms to add group permissions when creating files.
  • [AER-6415] - (KVS) Removed 'set-' prefix from configuration items in the namespace 'set' context.
  • [AER-6425] - (KVS) Changed transient detached threads to run from a thread pool.
  • [AER-6409] - (NETWORK) Added network service context configuration item disable-localhost to prevent listening on localhost.
  • [AER-6408] - (SCAN) Removed support for non partition-based basic scans, and deprecated scan options.
  • [AER-6424] - (STATS) Added more complete file descriptor stats for client, heartbeat, and fabric.
• Enterprise Only
  • [AER-6393] - (AUDIT) Added 'log' and 'syslog' context configuration items 'report-data-op-role' and 'report-data-op-user' to audit by role or user.
  • [AER-6394] - (AUDIT) Made all 'log' and 'syslog' context 'report-...' configuration items dynamic and properly echoed via get-config.
  • [AER-6417] - (ACL) Included number of per-user open connections in 'show user(s)' output.
  • [AER-6410] - (STATS) Added index_flash_alloc_bytes and index_flash_alloc_pct statistics.
  • [AER-6405] - (XDR) Added new stats for tracking bin-convergence conflicts.
  • [AER-6406] - (XDR) Always send the record last-update-time to connector destinations.

Known Issues

• Known Issues: Server

Updates

• aerospike-tools 5.2.0

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise & Community
  • [AER-6526] - (SINDEX) Truncating a namespace or set with a secondary index, and more than 2 billion records per node, may overflow a garbage collection queue and crash.
• Enterprise Only
  • [AER-6527] - (XDR) Dynamically removing seed nodes while trying to connect may cause connections to be skipped or cause a crash.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise Only
  • [AER-6525] - (XDR) For single-bin, data-in-memory namespaces, shipping records will corrupt the index and may cause a crash.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise & Community
  • [AER-6523] - (EXPRESSIONS) An empty expression may cause a crash, and a 1-byte expression operation with value zero is misinterpreted as a legacy predexp filter.
• Enterprise Only
  • [AER-6521] - (STORAGE) For storage-engine pmem namespaces, dynamically setting defrag-lwm-pct will set one-eighth the intended threshold.
  • [AER-6520] - (XDR) Removing multiple connector seed nodes in rapid succession may cause an assertion.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise & Community
  • [AER-6519] - (UDF) A UDF that tries to return a list or map containing an as_rec element will cause an assertion.
• Enterprise Only
  • [AER-6518] - (XDR) Dynamically adding/removing seed nodes and changing the DC context configuration item connector may cause an assertion.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise Only
  • [AER-6516] - (XDR) When a namespace is disabled, the lag, in_queue, and in_progress statistics are not properly cleared.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise & Community
  • [AER-6508] - (TLS) Race between TLS handshake and changing the certificate chain may cause a crash.

Known Issues

• Known Issues: Server

• Downgrading from Aerospike Database version 5.5 or newer to version 5.4 or version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.4 to version 5.3 or version 5.2 (where XDR bin convergence has been used). Refer to Special Upgrades.
• Downgrading from Aerospike Database version 5.2 or newer to a version previous to 5.2 (where XDR bin shipping has been used). Refer to Special Upgrades.
• ATTENTION: Debian/Ubuntu users - if python2 is not installed, see the Python Package Dependency for .deb Installers article.
• Support for the XDR bin-policy value 'only-specified', has been removed. Users of 'only-specified' will likely want to switch to 'changed-and-specified'.
  • Refer to the Special Upgrades - Upgrading from 5.0 or 5.1 to 5.3 or newer - if using the XDR bin projection functionality documentation.

• Aerospike Server version 5.1 or later requires the operating system distribution's libcurl shared object library.
• Before upgrading to 5.0.0.4 or later, customers already running 5.0.0.3 in a cluster which is an active XDR destination (i.e. an XDR destination also acting as a source XDR or that may in the future act as a source XDR), may want to consider stopping all XDR traffic to the cluster. (Enterprise Only)
  • In the unlikely case of an upgraded 5.0.0.4 or newer node going down while 5.0.0.3 nodes are still running, those nodes would mistakenly ship XDR writes even if forward has not been explicitly enabled.
  • Enterprise Licensees may contact Aerospike Support for any questions before upgrading.
• Cross-Datacenter Replication (XDR) running in Aerospike Server version 5.0 or newer can only connect to XDR destination clusters running versions 4.1 or newer.
• All nodes must be upgraded to Aerospike Server version 4.9.0.7 or newer. Please upgrade to the latest 4.9.0.x release prior to upgrading to Aerospike Server version 5.0 or newer.
  • Aerospike Server version 5.0 or newer will not form a cluster with version 4.8 nodes or earlier.
  • When upgrading the Aerospike Server refer to the Special Upgrades documentation.
• The Aerospike Server will not start if obsolete configuration parameters are set in the Aerospike configuration file (aerospike.conf).
  • Refer to: Configuration parameters that must be removed for Aerospike Server version 5.0 or newer
• ATTENTION: As of Aerospike Server version 4.9, expirations and evictions are disabled by default.
  • For expirations, nsup-period must be configured (new default is 0).
  • For evictions, the relevant high-water-disk-pct/high-water-memory-pct/mounts-high-water-pct must be configured (new defaults are 0).
  • For details refer to the Namespace Retention Configuration documentation.
• CentOS Linux 8 End of Life is scheduled for December 2021.
  • For more information please refer to: FAQ - CentOS Project shifts focus to CentOS Stream

Bug Fixes

• Enterprise Only
  • [AER-6486] - (STATS) For strong-consistency namespaces, re-replications that time out while queued internally will be reflected in the latency histogram.
  • [AER-6493] - (UDF) The method aerospike:exists() incorrectly returns true for a tombstone.

Known Issues

• Known Issues: Server