Skip to main content
Loading

Install on Ubuntu

These are steps to install Aerospike on Ubuntu operating systems.

Assumed skills

These instructions assume that you have the following skills or understanding:

  • Familiarity with the Linux operating system you are installing on.
  • Shell commands like wget or apt-get, tar, and editors.
  • TCP/IP networking.

Prerequisites

  • To install, you must have root access or permission to run sudo.
  • Starting with Database 7.2, Aerospike gains compatibility with OpenSSL 3.0.13, to support Ubuntu 24.04 LTS.
  • Starting with Database 6.3, Aerospike is compatible with OpenSSL 3, supporting Ubuntu 22.04, RHEL 9/CentOS Stream 9, and other Linux distributions that support OpenSSL 3. The Aerospike server and clients retain compatibility with OpenSSL 1.1.
  • Be sure to install the proper version of libcurl. See libcurl Required.

Download the package​

See Download Aerospike Database for more details on manual or automated downloads of server versions.

# In Database 6.2 and later
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/6.2.0.0/aerospike-server-enterprise_6.2.0.0_tools-8.0.2_ubuntu20.04_x86_64.tgz
# In server versions prior to 6.2
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/6.1.0.1/aerospike-server-enterprise-6.1.0.1-ubuntu20.04.tgz

For version 4.5.x or earlier of the Aerospike EE, use the following command and enter your username and password:

wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/4.5.3.22/aerospike-server-enterprise-4.5.3.22-ubuntu16.04.tgz --user='userName' --password='passWord'

Extract the contents of the package​

To extract the contents of the package, run the following:

tar -xvf aerospike.tgz

The contents are extracted to a directory with a name similar to the following, where community_or_enterprise depends on the version of the server you downloaded:

The directory includes:

Install and Configure Aerospike​

Install Aerospike Database​

To install the server and the tools packages, run the following from the command line:

cd aerospike-server-enterprise-*
sudo ./asinstall

For a description of files and directories that are installed, see Directory Structure.

Alternatively, you can install the Debian packages directly.

Debian Format​

aerospike-server-<edition>_<version>-1<distro>_<architecture>.deb
aerospike-tools_<version>-<[commit]distro>_<architecture>.deb

edition: community, enterprise, federal

version: 6.2.0.0, and so on

distro: ubuntu18.04, ubuntu20.04

architecture: amd64, arm64 based on dpkg-architecture -qDEB_HOST_ARCH

sudo dpkg -i aerospike-server-enterprise_6.2.0.0-1ubuntu20.04_arm64.deb
sudo dpkg -i aerospike-tools_8.1.0-ubuntu20.04_arm64.deb

Troubleshooting the installation​

If there are errors during the installation, consult Troubleshooting Install Problems. The Knowledge Base is also a good source of troubleshooting tips.

Configure Aerospike​

Installation establishes the server's default configuration. An in-memory test namespace is configured by default. See Configure Aerospike Database to modify and tune the configuration.

Add devices and more​

To add SSDs, make sure to read about setup and initialization.

Configure EE feature-key file​

caution

Aerospike EE requires a feature-key file to start up and optionally enable gated features, such as compression.

Since Database 6.1 the feature-key file for a single-node cluster is provided, so the server will start up automatically.

Configure logging​

To configure logging for the Aerospike database, refer to Configuring Log Files.

Start Aerospike​

The Aerospike-included init script /etc/init.d/aerospike manages the Aerospike Database Daemon /usr/bin/asd.

In addition, the Aerospike database can be controlled with standard systemctl commands. For details, see Aerospike Daemon Management.

Troubleshoot the startup​

If there are errors during start up, see Startup Problems. The Knowledge Base is also a good source of troubleshooting tips.

Verify Aerospike is running​

For details on getting the status of the Aerospike database with systemctl, see Aerospike Daemon Management.

Last updated on