How To Migrate User Credentials from One Cluster to Another

The Aerospike Knowledge Base has moved to https://support.aerospike.com. Content on https://discuss.aerospike.com is being migrated to either https://support.aerospike.com or https://docs.aerospike.com. Maintenance on articles stored in this repository ceased on December 31st 2022 and this article may be stale. If you have any questions, please do not hesitate to raise a case via https://support.aerospike.com.

FAQ - How do I migrate user credentials from one Aerospike cluster to another?

Detail

When setting up a new Aerospike cluster, it could be useful to copy the metadata related to user credentials from an existing Aerospike implementation to a new one.

Answer

  1. Copy the security.smd system metadata file (SMD) from the old to the new cluster.
  2. Refer to this article for details : How to move, recreate or retain the System Metadata Directory.
  3. After copying the security.smd file, it is necessary to restart the Aerospike process (asd) since the SMD files are read only when the service starts.
  4. When migrating SMD files, best practices dictate that this is tested thoroughly in a test environment, before implementing in production systems.

Notes

The system metadata (SMD) files contains (not a complete list) the following:

  1. indexes
  2. UDF definitions
  3. truncation
  4. strong consistency
  5. users/roles

Also refer to this documentation on the structure of the SMD directory.

Keywords

USER PASSWORD CREDENTIALS SMD METADATA MIGRATE

Timestamp

September 2021