Installing Cassandra | Apache Cassandra Documentation (2024)

Table of Contents
Prerequisites Choosing an installation method Installing the docker image Installing the binary tarball Installing the Debian packages Installing the RPM packages Further installation info References

These are the instructions for deploying the supported releases ofApache Cassandra on Linux servers.

Cassandra runs on a wide array of Linux distributions including (but notlimited to):

  • Ubuntu, most notably LTS releases 16.04 to 18.04

  • CentOS & RedHat Enterprise Linux (RHEL) including 6.6 to 7.7

  • Amazon Linux AMIs including 2016.09 through to Linux 2

  • Debian versions 8 & 9

  • SUSE Enterprise Linux 12

This is not an exhaustive list of operating system platforms, nor is itprescriptive. However, users will be well-advised to conduct exhaustivetests of their own particularly for less-popular distributions of Linux.Deploying on older versions is not recommended unless you have previousexperience with the older distribution in a production environment.

Prerequisites

  • Install the latest version of Java 8 or Java 11, either theOracleJava Standard Edition 8 / Oracle Java Standard Edition 11 (Long Term Support)or OpenJDK 8 / OpenJDK 11. Toverify that you have the correct version of java installed, typejava -version.

  • NOTE: Experimental support for Java 11 was added in Cassandra 4.0(CASSANDRA-9608).Full support is effective Cassandra 4.0.2 version (CASSANDRA-16894)For more information, seeNEWS.txt.

  • For using cqlsh, the latest version ofPython 3.6+ or Python 2.7 (support deprecated). To verifythat you have the correct version of Python installed, typepython --version.

Choosing an installation method

There are three methods of installing Cassandra that are common:

  • Docker image

  • Tarball binary file

  • Package installation (RPM, YUM)

If you are a current Docker user, installing a Docker image is simple.You’ll need to install Docker Desktop for Mac, Docker Desktop for Windows,or have docker installed on Linux.Pull the appropriate image and then start Cassandra with a run command.

For most users, installing the binary tarball is also a simple choice.The tarball unpacks all its contents into a single location withbinaries and configuration files located in their own subdirectories.The most obvious attribute of the tarball installation is it does notrequire root permissions and can be installed on any Linuxdistribution.

Packaged installations require root permissions, and are most appropriate forproduction installs.Install the RPM build on CentOS and RHEL-based distributions if you want toinstall Cassandra using YUM.Install the Debian build on Ubuntu and other Debian-baseddistributions if you want to install Cassandra using APT.Note that both the YUM and APT methods required root permissions andwill install the binaries and configuration files as the cassandra OS user.

Installing the docker image

  1. Pull the docker image. For the latest image, use:

docker pull cassandra:latest

This docker pull command will get the latest version of the 'Docker Official'Apache Cassandra image available from the Dockerhub.

  1. Start Cassandra with a docker run command:

docker run --name cass_cluster cassandra:latest

The --name option will be the name of the Cassandra cluster created.

  1. Start the CQL shell, cqlsh to interact with the Cassandra node created:

docker exec -it cass_cluster cqlsh

Installing the binary tarball

  1. Verify the version of Java installed. For example:

  • Command

  • Result

$ java -version
openjdk version "1.8.0_222"OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)

  1. Download the binary tarball from one of the mirrors on theApache Cassandra Download site.For example, to download Cassandra 4.0:

$ curl -OL http://apache.mirror.digitalpacific.com.au/cassandra/4.0.0/apache-cassandra-4.0.0-bin.tar.gz
The mirrors only host the latest versions of each major supportedrelease. To download an earlier version of Cassandra, visit theApache Archives.

  1. OPTIONAL: Verify the integrity of the downloaded tarball using one ofthe methods here. Forexample, to verify the hash of the downloaded file using GPG:

$ gpg --print-md SHA256 apache-cassandra-4.0.0-bin.tar.gz
apache-cassandra-4.0.0-bin.tar.gz: 28757DDE 589F7041 0F9A6A95 C39EE7E6 CDE63440 E2B06B91 AE6B2006 14FA364D

Compare the signature with the SHA256 file from the Downloads site:

  • Command

  • Result

$ curl -L https://downloads.apache.org/cassandra/4.0.0/apache-cassandra-4.0.0-bin.tar.gz.sha256
28757dde589f70410f9a6a95c39ee7e6cde63440e2b06b91ae6b200614fa364d

  1. Unpack the tarball:

$ tar xzvf apache-cassandra-4.0.0-bin.tar.gz

The files will be extracted to the apache-cassandra-4.0.0/ directory.This is the tarball installation location.

  1. Located in the tarball installation location are the directories forthe scripts, binaries, utilities, configuration, data and log files:

<tarball_installation>/ bin/(1) conf/(2) data/(3) doc/ interface/ javadoc/ lib/ logs/(4) pylib/ tools/(5)
1location of the commands to run cassandra, cqlsh, nodetool, and SSTable tools
2location of cassandra.yaml and other configuration files
3location of the commit logs, hints, and SSTables
4location of system and debug logs<5>location of cassandra-stress tool

For information on how to configure your installation, seeConfiguringCassandra.

  1. Start Cassandra:

$ cd apache-cassandra-4.0.0/ && bin/cassandra
This will run Cassandra as the authenticated Linux user.

  1. Monitor the progress of the startup with:

  • Command

  • Result

$ tail -f logs/system.log

Cassandra is ready when you see an entry like this in the system.log:

INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on localhost/127.0.0.1:9042 (unencrypted)...

You can monitor the progress of the startup with:

  • Command

  • Result

$ tail -f logs/system.log

Cassandra is ready when you see an entry like this in the system.log:

INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on localhost/127.0.0.1:9042 (unencrypted)...
For information on how to configure your installation, seeConfiguringCassandra.

  1. Check the status of Cassandra:

$ bin/nodetool status
See Also
Dragon Age: Inquisition - Builds

The status column in the output should report UN which stands for"Up/Normal".

Alternatively, connect to the database with:

$ bin/cqlsh

Installing the Debian packages

  1. Verify the version of Java installed. For example:

  • Command

  • Result

$ java -version
openjdk version "1.8.0_222"OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)

  1. Add the Apache repository of Cassandra to the filecassandra.sources.list.The latest major version is {41_version} and the corresponding distribution name is 41x (with an "x" as the suffix).For older releases use:

    • 41x for C* {41_version} series

    • 40x for C* 4.0 series

    • 311x for C* {311_version} series

    • 30x for C* {30_version} series

For example, to add the repository for version {41_version} (41x):

$ echo "deb [signed-by=/etc/apt/keyrings/apache-cassandra.asc] https://debian.cassandra.apache.org 41x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.listdeb https://debian.cassandra.apache.org 41x main

  1. Add the Apache Cassandra repository keys to the list of trusted keyson the server:

  • Command

  • Result

$ curl -o /etc/apt/keyrings/apache-cassandra.asc https://downloads.apache.org/cassandra/KEYS
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed100 266k 100 266k 0 0 320k 0 --:--:-- --:--:-- --:--:-- 320kOK

  1. Update the package index from sources:

$ sudo apt-get update

  1. Install Cassandra with APT:

$ sudo apt-get install cassandra
For information on how to configure your installation, seeConfiguringCassandra.

  1. Monitor the progress of the startup with:

  • Command

  • Result

$ tail -f logs/system.log

Cassandra is ready when you see an entry like this in the system.log:

INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on localhost/127.0.0.1:9042 (unencrypted)...
For information on how to configure your installation, seeConfiguringCassandra.

  1. Check the status of Cassandra:

$ nodetool status

The status column in the output should report UN which stands for"Up/Normal".

Alternatively, connect to the database with:

$ cqlsh

Installing the RPM packages

  1. Verify the version of Java installed. For example:

  • Command

  • Result

$ java -version
openjdk version "1.8.0_222"OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10)OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)

  1. Add the Apache repository of Cassandra to the file/etc/yum.repos.d/cassandra.repo (as the root user).The latest major version is {41_version} and the corresponding distribution name is 41x (with an "x" as the suffix).For older releases use:

    • 41x for C* {41_version} series

    • 40x for C* 4.0 series

    • 311x for C* {311_version} series

    • 30x for C* {30_version} series

For example, to add the repository for version {41_version} (41x):

[cassandra]name=Apache Cassandrabaseurl=https://redhat.cassandra.apache.org/41x/gpgcheck=1repo_gpgcheck=1gpgkey=https://downloads.apache.org/cassandra/KEYS

  1. Update the package index from sources:

$ sudo yum update

  1. Install Cassandra with YUM:

$ sudo yum install cassandra
A new Linux user cassandra will get created as part of theinstallation. The Cassandra service will also be run as this user.

  1. Start the Cassandra service:

$ sudo service cassandra start

  1. Monitor the progress of the startup with:

  • Command

  • Result

$ tail -f logs/system.log

Cassandra is ready when you see an entry like this in the system.log:

INFO [main] 2019-12-17 03:03:37,526 Server.java:156 - Starting listening for CQL clients on localhost/127.0.0.1:9042 (unencrypted)...
For information on how to configure your installation, seeConfiguringCassandra.

  1. Check the status of Cassandra:

$ nodetool status

The status column in the output should report UN which stands for"Up/Normal".

Alternatively, connect to the database with:

$ cqlsh

Further installation info

For help with installation issues, see theTroubleshootingsection.

Installing Cassandra | Apache Cassandra Documentation (2024)

References

Top Articles
Spaghetti and Drop Meatballs With Tomato Sauce Recipe
5 Incredibly Simple DIY RV Cleaner Recipes
253704410 : 8 saulc : keep on rocking : 3 lper : various artists :
Na internetu prodaje krv, znoj i suze i zarađuje milione
Temu Eyebrow Brush
Surtidora Departamental busca personas para el cargo de Ventas en Piso en Tonalá, Jalisco, Mexico | LinkedIn
Interactive Ice Bowl Exhibit
Lakers Game Summary
R/Pesmobile
SEUS PTGI Shaders 1.21 → 1.20, 1.20.6 - Free Download
Former Eufaula and Ole Miss standout KD Hill gives back to community with KD's Fun Day
Jurrion Dickey: A Star in the Making
Latest Posts
Heinz Baked Beans recipe - copycat!
Top 3 DIY car wash liquid soap recipes THAT WORK [Cheap & Easy]
Article information

Author: Catherine Tremblay

Last Updated:

Views: 6068

Rating: 4.7 / 5 (67 voted)

Reviews: 90% of readers found this page helpful

Author information

Name: Catherine Tremblay

Birthday: 1999-09-23

Address: Suite 461 73643 Sherril Loaf, Dickinsonland, AZ 47941-2379

Phone: +2678139151039

Job: International Administration Supervisor

Hobby: Dowsing, Snowboarding, Rowing, Beekeeping, Calligraphy, Shooting, Air sports

Introduction: My name is Catherine Tremblay, I am a precious, perfect, tasty, enthusiastic, inexpensive, vast, kind person who loves writing and wants to share my knowledge and understanding with you.