Was this page helpful?
We recommend installing ScyllaDB using ScyllaDB Web Installer for Linux, a platform-agnostic installation script, to install ScyllaDB on any supported Linux platform. Alternatively, you can install ScyllaDB using Linux packages.
This article will help you install ScyllaDB on Linux using platform-specific packages.
Ubuntu, Debian, CentOS, or RHEL (see OS Support by Platform and Version for details about supported versions and architecture)
Root or sudo access to the system
(CentOS and RHEL only) Removing Automatic Bug Reporting Tool (ABRT) if installed before installing ScyllaDB, as it may conflict with ScyllaDB coredump configuration:
sudo yum remove -y abrt
Install a repo file and add the ScyllaDB APT repository to your system.
sudo mkdir -p /etc/apt/keyringssudo gpg --homedir /tmp --no-default-keyring --keyring /etc/apt/keyrings/scylladb.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys a43e06657bac99e3sudo wget -O /etc/apt/sources.list.d/scylla.list http://downloads.scylladb.com/deb/debian/scylla-6.2.list
Install ScyllaDB packages.
sudo apt-get update sudo apt-get install -y scyllaRunning the command installs the latest official version of ScyllaDB Open Source. To install a specific patch version, list all the available patch versions:
apt-cache madison scyllaThen install the selected patch version:
apt-get install scylla{,-server,-tools,-tools-core,-kernel-conf,-node-exporter,-conf,-python3}=<your patch version>The following example shows installing ScyllaDB 5.2.3.
apt-cache madison scylla scylla | 5.2.3-0.20230608.ea08d409f155-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages scylla | 5.2.2-0.20230521.9dd70a58c3f9-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages scylla | 5.2.1-0.20230508.f1c45553bc29-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages scylla | 5.2.0-0.20230427.429b696bbc1b-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packagesapt-get install scylla{,-server,-tools,-tools-core,-kernel-conf,-node-exporter,-conf,-python3}=5.2.3-0.20230608.ea08d409f155-1
(Ubuntu only) Set Java 11.
sudo apt-get update sudo apt-get install -y openjdk-11-jre-headless sudo update-java-alternatives --jre-headless -s java-1.11.0-openjdk-amd64
Install the EPEL repository.
CentOS:
sudo yum install epel-release
Rocky/RHEL 8
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
Rocky/RHEL 9
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
Add the ScyllaDB RPM repository to your system.
sudo curl -o /etc/yum.repos.d/scylla.repo -L http://downloads.scylladb.com/rpm/centos/scylla-6.2.repo
Install ScyllaDB packages.
sudo yum install scyllaRunning the command installs the latest official version of ScyllaDB Open Source. Alternatively, you can to install a specific patch version:
sudo yum install scylla-<your patch version>Example: The following example shows the command to install ScyllaDB 5.2.3.
sudo yum install scylla-5.2.3
scylla-jmx becomes optional package from ScyllaDB 6.2, not installed by default. If you need JMX server, see Install scylla-jmx Package
Configure the following parameters in the /etc/scylla/scylla.yaml configuration file.
cluster_name - The name of the cluster. All the nodes in the cluster must have the same
cluster name configured.
seeds - The IP address of the first node. Other nodes will use it as the first contact
point to discover the cluster topology when joining the cluster.
listen_address - The IP address that ScyllaDB uses to connect to other nodes in the cluster.
rpc_address - The IP address of the interface for CQL client connections.
Run the scylla_setup script to tune the system settings and determine the optimal configuration.
sudo scylla_setup
The script invokes a set of scripts to configure several operating system settings; for example, it sets RAID0 and XFS filesystem.
The script runs a short (up to a few minutes) benchmark on your storage and generates the /etc/scylla.d/io.conf
configuration file. When the file is ready, you can start ScyllaDB. ScyllaDB will not run without XFS
or io.conf file.
You can bypass this check by running ScyllaDB in developer mode. We recommend against enabling developer mode in production environments to ensure ScyllaDB’s maximum performance.
Run ScyllaDB as a service (if not already running).
sudo systemctl start scylla-server
Now you can start using ScyllaDB. Here are some tools you may find useful.
Run nodetool:
nodetool status
Run cqlsh:
cqlsh
Run cassandra-stress:
cassandra-stress write -mode cql3 native
Manage your clusters with ScyllaDB Manager
Monitor your cluster and data with ScyllaDB Monitoring
Get familiar with ScyllaDB’s command line reference guide.
Learn about ScyllaDB at ScyllaDB University
Was this page helpful?