These are steps to install Aerospike on Ubuntu operating systems.
These instructions assume that you have the following skills or understanding:
- Familiarity with the Linux operating system you are installing on.
- Shell commands like
tar, and editors.
- TCP/IP networking.
- To install, you must have root access or permission to run
sudo. As an alternative to root access, you can install the binary distribution.
- For Aerospike Database 5.1 and later, be sure to install the proper version of
libcurl. See libcurl Required.
- In server 6.3 Aerospike gains compatibility with OpenSSL 3, to support 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.
Download the package
See Download Aerospike Database for more details on manual or automated downloads of server versions.
# In server version 6.2 and later
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/184.108.40.206/aerospike-server-enterprise_220.127.116.11_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/18.104.22.168/aerospike-server-enterprise-22.214.171.124-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/126.96.36.199/aerospike-server-enterprise-188.8.131.52-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:
license.txt— licenses for Aerospike and other software included in the package
- Tools RPM — Aerospike command-line tools and utilities
- Server RPM — the Aerospike Database package
Install and Configure Aerospike
Install Aerospike Database
To install the server and the tools packages, run the following from the command line:
For a description of files and directories that are installed, see Directory Structure.
Alternatively, you can install the Debian packages directly.
184.108.40.206, and so on
arm64 based on
sudo dpkg -i aerospike-server-enterprise_220.127.116.11-1ubuntu20.04_arm64.deb
sudo dpkg -i aerospike-tools_8.1.0-ubuntu20.04_arm64.deb
Troubleshooting the installation
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
Configure EE feature key file
Aerospike EE requires a feature-key file to start up and optionally enable gated features, such as compression.
Since server 6.1 the feature key file for a single-node cluster is provided, so the server will start up automatically.
To configure logging for the Aerospike database, refer to Configuring Log Files.
The Aerospike-included init script
/etc/init.d/aerospike manages the Aerospike Database Daemon
In addition, the Aerospike database can be controlled with standard
systemctl commands. For details, see Aerospike systemd Daemon Management.
Troubleshoot the startup
Verify Aerospike is running
For details on getting the status of the Aerospike database with
systemctl, see Aerospike systemd Daemon Management.