How to Install ScyllaDB: Step-by-Step Tutorial
ScyllaDB is a modern NoSQL database designed for high throughput and low latency. It is a drop-in replacement for Apache Cassandra but built on a highly efficient C++ architecture to deliver superior performance. In this tutorial, you’ll learn how to install ScyllaDB on a Linux system, configure it, and get started with a basic cluster setup.
Prerequisites
- A Linux server (Ubuntu 20.04 or later recommended) with sudo privileges.
- Minimum 4GB of RAM and a multicore processor for better performance.
- Basic knowledge of Linux command line and system administration.
- Internet connection to download packages.
Step 1: Update Your System
Start by updating your package repositories and upgrading installed packages to ensure system stability.
sudo apt update
sudo apt upgrade -y
Step 2: Add ScyllaDB Repository
ScyllaDB provides official packages via a repository. Add this to your system sources:
curl -s https://repositories.scylladb.com/scylla/repo_key | sudo apt-key add -
sudo curl -o /etc/apt/sources.list.d/scylladb.list https://repositories.scylladb.com/scylla/scylladb-4.7.list
sudo apt update
Step 3: Install ScyllaDB Package
Once updated, install ScyllaDB with the following command:
sudo apt install scylla
Step 4: Run ScyllaDB Setup
ScyllaDB comes with a setup script to configure system requirements like disk setup, firewall rules, and tuning for performance. Run the setup with:
sudo scylla_setup
Follow the instructions on-screen to complete the configuration. You’ll be prompted to set the data directory, commit log location, and network interfaces.
Step 5: Start and Enable ScyllaDB Service
Enable the ScyllaDB service to start on boot and start it manually for this session:
sudo systemctl enable scylla-server
sudo systemctl start scylla-server
sudo systemctl status scylla-server
Step 6: Verify Installation
Check if ScyllaDB is running properly by connecting to its native CQL shell, cqlsh:
sudo apt install scylla-tools
cqlsh
If you see the cqlsh prompt, you have successfully installed ScyllaDB.
Troubleshooting Tips
- If the
scylla-serverservice fails to start, check logs withjournalctl -xe | grep scylla. - Ensure your firewall allows ports 9042 (CQL) and 9180 (HTTP API) if you want external connections.
- Verify that your kernel supports required features with
scylla_check_setup. - For cluster setups, ensure all nodes have synchronized time and proper network connectivity.
Summary Checklist
- System updated to latest packages.
- ScyllaDB repository added and package installed.
- ScyllaDB setup completed for system tuning.
- ScyllaDB service started and enabled.
- Successfully connected to
cqlsh.
For advanced database setups, including clustering and performance tuning, check more guides on our site such as <a href="/
About the Author
