Skip to main content
We are excited to be a part of AWS re:Invent 2024. Visit us at booth #1844 in Las Vegas.More info
Loading

Install on Linux

The following installation steps apply to both the Debian (*.deb) and RHEL (*.rpm) packages. Platform-specific instructions are noted where applicable.

You can install AVS on the following Linux distributions:

  • RHEL / CentOS 7+
  • Ubuntu 18.04+
  • Debian 9+

Prerequisites​

  • Java 21 or higher
  • A running Aerospike Database (ASDB) version 7.x cluster
note

You will need to provide credentials for your ASDB cluster when configuring AVS in Step 5 below.

1. Add namespaces required by AVS​

The Aerospike Database must include a namespace for AVS internal system data storage and at least one namespace for vector and AVS index storage. See Configure Aerospike Database for AVS for more information.

2. Install Java 21 or later​

AVS requires Java 21 or later. If Java 21 is not installed on your system, it is available from a number of distributions such as OpenJDK 21​.

3. Install the AVS package​

Use the following steps to download and install the appropriate version of AVS from Aerospike's hosted jFrog instance.

RHEL or CentOS​

  1. Create or update /etc/yum.repos.d/aerospike.repo with the following content to add Aerospike jFrog to your config manager:

    cat << EOF > /etc/yum.repos.d/aerospike.repo
    [aerospike]
    name=Aerospike
    baseurl=https://aerospike.jfrog.io/artifactory/rpm
    enabled=1
    gpgcheck=1
    gpgkey=https://aerospike.jfrog.io/artifactory/api/security/keypair/aerospike/public
    autorefresh=1
    type=rpm-md
    EOF

  2. Install with yum or dnf.

    sudo yum install aerospike-vector-search

Debian or Ubuntu​

  1. Add the Aerospike public key to your keyring.

    wget -qO - https://aerospike.jfrog.io/artifactory/api/security/keypair/aerospike/public | sudo gpg --dearmor -o /usr/share/keyrings/aerospike.gpg

  2. Add the repository source

    echo 'deb [signed-by=/usr/share/keyrings/aerospike.gpg] https://aerospike.jfrog.io/artifactory/deb stable main' \
    | sudo tee /etc/apt/sources.list.d/aerospike.list

  3. Reload local packages.

    sudo apt update

  4. Install AVS.

    sudo apt install aerospike-vector-search

4. Verify AVS feature-key​

Ensure that your feature-key file features.conf is in /etc/aerospike-vector-search/ and includes the vector-service feature. If that service is not enabled, AVS will not start.

5. Configure AVS​

AVS uses a single configuration file, aerospike-vector-search.yml, located by default in /etc/aerospike-vector-search/. Specify the AVS configuration options and Aerospike cluster details in this file.

For a complete reference of configuration options, see Configuring AVS.

6. Start AVS​

The AVS package includes a systemd service definition. The installation procedure creates an aerospike-vector-search service. You can start the service manually or enable the service to start automatically when the system restarts.

Start AVS

sudo systemctl start aerospike-vector-search

Enable AVS on system restart

sudo systemctl enable aerospike-vector-search
Last updated on