Skip to main content

Upgrading from Enterprise Edition to Federal Edition

info

The FIPS 140-2 compliant Aerospike Enterprise Edition for United States Federal (AKA Federal Edition or FE) was first released with server 6.0.

  • When upgrading from Aerospike EE version 5.x (or 4.9), follow the Storage Format Upgrade in 6.0 Release
  • Back up /opt/aerospike/smd/security.smd in your system metadata (SMD) Directory Structure and Aerospike configuration file (aerospike.conf)
  • Fully remove the Aerospike EE package with your package manager
dpkg --purge aerospike-server-enterprise 
(Reading database ... 11993 files and directories currently installed.)
Removing aerospike-server-enterprise (6.0.0.1-1) ...
Purging configuration files for aerospike-server-enterprise (6.0.0.1-1) ...
dpkg: warning: while removing aerospike-server-enterprise, directory '/usr/lib/systemd/system' not empty so not removed
dpkg: warning: while removing aerospike-server-enterprise, directory '/opt/aerospike/smd' not empty so not removed

dpkg -l | fgrep aerospike
ii aerospike-tools 7.0.3 amd64 Aerospike server tools.
  • Downloaded and install the Aerospike FE package, such as aerospike-server-federal-6.0.0.1-ubuntu20.04.tgz
  • Remove the skeleton aerospike.conf installed and replace it with your backed-up configuraton file
  • Validate that your SMD and TLS certificates are still in place. If they aren't, use a backup of the previous SMD version.
  • In Federal Edition, password authentication is disabled, use either mTLS-based PKI authentication or LDAP for authentication. Refer to TLS configuration and Configuring access control.