Prerequisites

This tutorial uses examples from the Aerospike Graph repository. You’ll generate TLS certificates, configure Docker containers, and run Python scripts to verify secure connections.

Required dependencies

Install the following tools before starting the tutorial:

Docker

Docker runs AGS and Aerospike Database in containers. Download and install from the Docker website.

Verify your installation:

docker --version

Python 3

Python 3.10 is required to run the Gremlin client examples. Most systems include Python by default.

Verify your installation:

python3 --version

The examples use pip to install Python packages. If pip is not available, install it from the Python website.

OpenSSL

OpenSSL generates the TLS certificates and keys. Most Unix-like systems include OpenSSL by default.

Verify your installation:

openssl version

If OpenSSL is not available, install it using your system package manager (e.g., brew install openssl on macOS or apt-get install openssl on Debian/Ubuntu).

Clone the repository

1. Clone the aerospike-graph repository to your local machine.

   git clone https://github.com/aerospike-examples/aerospike-graph.git
   cd aerospike-graph/python/tls

   The python/tls directory contains two subdirectories:

   • GremlinClient-to-AGS: TLS between Gremlin clients and AGS
   • AGS-to-AerospikeDB: TLS between AGS and Aerospike Database

2. Create and activate a Python virtual environment in the TLS example directory.

   python3 -m venv .venv
   source .venv/bin/activate

3. Install the required Python packages.

   python3 -m pip install gremlinpython async_timeout

You’re now ready to configure TLS for Aerospike Graph.

Checklist

• I’ve installed Docker and verified it’s running.
• I’ve installed Python 3.10 and pip.
• I’ve verified OpenSSL is available on my system.
• I’ve cloned the Aerospike Graph repository.