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

Verify an Installation

Overview​

Use this procedure to verify that you have successfully installed Aerospike and that it is now running.

When you install Aerospike, the essential files are created in the following directories:

/etc/aerospike/                 - configuration files for Aerospike
/etc/aerospike/aerospike.conf   — default configuration for Aerospike
/etc/init.d/aerospike           — init script for Aerospike on non-systemd platforms
/etc/logrotate.d/aerospike      — logrotate configuration for Aerospike on non-systemd platforms
/opt/aerospike/bin/             — binaries including Aerospike server and tools
/opt/aerospike/doc/             — documents, including licenses
/opt/aerospike/sys/             — system data files, maintained by Aerospike
/opt/aerospike/usr/             — user data files
/var/log/aerospike/             — log files emitted by Aerospike
/usr/bin/asd                    — Aerospike Server daemon

See Directory Structure for more details.

  1. Verify record operations:

    Use the Aerospike aql tool (installed at /opt/aerospike/bin/aql and linked in /usr/bin/aql) to insert and read a few sample records. Start by creating a new object with the key Aerospike in the test namespace that is part of the default configuration and adding three fields, name, address and email:

    note

    macOS Vagrant Aerospike Server install also installs the Aerospike Tools in the Vagrant container. The Tools package, including aql, is accessible in the Vagrant container.

    aql -h 127.0.0.1 -c "INSERT INTO test.demo (PK, name, address, email) VALUES ('Aerospike', 'Aerospike, Inc.', 'Mountain View, CA 94043', 'info@aerospike.com')"

    Expected response:

    OK, 1 record affected.

  2. Retrieve the record and make sure it looks right:

    aql -h 127.0.0.1 -c "select * from test.demo where PK='Aerospike'"

    Expected response:

    +-------------------+---------------------------+----------------------+
    | name              | address                   | email                |
    +-------------------+---------------------------+----------------------+
    | "Aerospike, Inc." | "Mountain View, CA 94043" | "info@aerospike.com" |
    +-------------------+---------------------------+----------------------+
    1 row in set (0.002 secs)

    OK

  3. Delete the record and verify that it is deleted:

    aql -h 127.0.0.1 -c "DELETE FROM test.demo where PK='Aerospike'"

    Expected response:

    OK, 1 record affected.

    aql is intended only for basic validation. aql creates a new connection for every transaction and is not recommended as a production level client. Instead, use your application, integrated with Aerospike’s client libraries as described in the Development section.

  4. Now that you have a running server, pick a client library and start developing!

Next steps​