docker-compose

Stargate Docker Compose Scripts

This directory provides Docker compose scripts with sample configurations for the various supported Stargate backends:

• Cassandra 3.11
• Cassandra 4.0

Stargate coordinator image is publicly available on Docker Hub. Cassandra-dynamoDB-adapter image is also publicly available on Docker Hub.

Quick Start

Step 1. Launch Docker.

Step 2. Enter cassandra-3.11 or cassandra-4.0 directory, and run

./start_cass_311.sh

or

./start_cass_40.sh

Docker Troubleshooting

If you have problems running Stargate Docker images there are a couple of things you can check that might be causing these problems.

Docker Engine does not have enough memory to run full Stargate

Many Docker engines have default settings for low memory usage. For example:

• Docker Desktop defaults to 2 GB: depending on your setup, you may need to increase this up to 6 GBs (although some developers report 4 GB being sufficient)

OS may too low limit for File Descriptors

If you see a message like this:

Jars will not be watched due to unexpected error: User limit of inotify instances reached or too many open files

on Docker logs for Coordinator, you are probably hitting it.

Solution depends on OS you are on; here are some suggestions

MacOS: too low FD limit

On MacOS a solution is to increase maxfiles limit; you can do that by:

sudo launchctl limit maxfiles 999999 999999

but note that this setting will not persist over restart.

For more information see f.ex:

• https://wilsonmar.github.io/maximum-limits/
• https://superuser.com/questions/433746/is-there-a-fix-for-the-too-many-open-files-in-system-error-on-os-x-10-7-1

Unfortunately the "permanent" solution appears to be different across different MacOS versions!