Skip to main content

Upgrading from Community to Enterprise version

Aerospike Enterprise Edition includes additional features and provides access to tested and certified builds, hot patches and 24x7 Enterprise Support. To see all other benefits of using the Enterprise Edition, go to Products Pricing.

info

Note: Please contact Aerospike support if you need clarification on any of the following steps.

You can use the following steps to upgrade a cluster of community-version nodes to the enterprise version. For the purposes of upgrading, you can add an enterprise node to a cluster of community nodes.

Perform the following steps on each node, one node at a time.

Check Migrations

Verify that the cluster is not migrating data before you stop one of the nodes. Run the following command to check migration status:

# Migrations are complete when all `migrate_progress_recv` and
# `migrate_progress_send` values return 0.
asadm -e "show stat like migrate_tx_partitions_active migrate_tx_partitions_remaining migrate_rx_partitions_active migrate_rx_partitions_remaining migrate_record_receives -flip "

Stop the Aerospike service

  1. Run the following command to display the current status of the Aerospike Service:

    sudo service aerospike status
  2. Run the following command to stop the Aerospike service on the node:

    sudo service aerospike stop

Backup the Aerospike Configuration File

Create a backup of the current configuration file:

sudo cp /etc/aerospike/aerospike.conf /etc/aerospike/aerospike.conf.bac

Uninstall the Community Aerospike Server Package

  • For Redhat/Centos distributions

    sudo rpm -e aerospike-community-server
    #If you have tools package installed separately
    sudo rpm -e aerospike-community-tools
  • For Debian/Ubuntu distributions:

    sudo dpkg -r aerospike-community-server
    sudo dpkg --purge aerospike-server-community
    #If you have tools package installed separately
    sudo dpkg -r aerospike-community-tools
    sudo dpkg --purge aerospike-community-tools

Install Aerospike Enterprise packages

Download Aerospike and Install Aerospike. For more information on downloading and installing, see the Installation Documentation.

info

You must login to download the Enterprise installer files. For queries regarding access, please contact your Sales Rep.

Restore the backup configuration

Restore the backup configuration file to /etc/aerospike/aerospike.conf:

sudo cp /etc/aerospike/aerospike.conf.bac /etc/aerospike/aerospike.conf

Start Aerospike server

The following steps ensure that you have installed the Enterprise Aerospike server and finished migrations on each node before proceeding to next node.

  1. Start the Aerospike service. Run the following command:

    sudo service aerospike start

    For more information on starting the service, see the Installation Documentation.

    info

    Note: If you see warnings in the Aerospike log about deprecated parameters, confirm their usage in Aerospike 3 in the Configuration Reference.

  2. Wait for Aerospike's service port to open (port 3000) before continuing. When the service port opens, the following command will return "OK":

    asinfo -v STATUS
  3. If your server contains any namespaces that are in-memory without persistence, you must wait for migrations to complete before continuing to the next node to prevent data loss.

    Run the following command to verify migrations are complete:

    # Migrations are complete when all `migrate_progress_recv` and
    # `migrate_progress_send` values return 0.
    asadm -e "show statistics like migrate_progress"
  4. If all namespaces are persisted, you may continue to upgrade the next node and not lose any data.

    caution

    If writes are still active on the cluster, and you choose to not wait for migrations to complete between node upgrades, some record updates may be overwritten during migration conflict resolution. Contact Aerospike Support for further details if necessary.

Verify Aerospike server

After you complete the steps on each node, use these Steps to confirm that Aerospike was successfully installed and is running.