Skip to main content

Step-by-Step Guide to Installing Apache Cassandra on Ubuntu

Apache Cassandra is a high-performance, distributed NoSQL database designed to handle large volumes of data across many servers with no single point of failure. This guide will walk you through the process of installing Cassandra on an Ubuntu system.


Prerequisites

  1. Ubuntu System: This guide assumes you're using Ubuntu 20.04 or later.
  2. Java Installed: Apache Cassandra requires Java (JRE version 8 or later).
  3. Root or Sudo Access: Ensure you have administrative privileges.

Step 1: Update System Packages
    Always start with updating your package index to ensure all dependencies are up-to-date. Open a terminal and run:

    sudo apt update && sudo apt upgrade -y

Step 2: Install Java

    Apache Cassandra requires Java to run. You can install OpenJDK using the following commands:

     sudo apt install openjdk-11-jdk -y

    Verify the installation:

    java -version

    The output should display the Java version installed.

Step 3: Add the Cassandra Repository
    To get the latest stable version of Cassandra, add the Apache Cassandra repository to your system:

    Import the GPG key:

    curl https://downloads.apache.org/cassandra/KEYS | sudo gpg --dearmor -o /usr/share/keyrings/cassandra-archive-keyring.gpg

    Add the repository:

    echo "deb [signed-by=/usr/share/keyrings/cassandra-archive-keyring.gpg] https://downloads.apache.org/cassandra/debian 40x main" | sudo tee /etc/apt/sources.list.d/cassandra.list

Step 4: Install Apache Cassandra
    Update the package list and install Cassandra:
    sudo apt update
    sudo apt install cassandra -y

Step 5: Start and Enable Cassandra
    After the installation, start the Cassandra service and enable it to run at boot:
    sudo systemctl start cassandra
    sudo systemctl enable cassandra
    
    Check the service status to confirm it's running:
    
    sudo systemctl status cassandra

Step 6: Verify the Installation
    To ensure Cassandra is running correctly, use the cqlsh tool (Cassandra Query Language Shell):
    cqlsh

    You should see a prompt like this:

    Connected to Test Cluster at 127.0.0.1:9042.
    [cqlsh 6.0.0 | Cassandra 4.x.x | CQL spec 3.x.x | Native protocol vX]
    Use HELP for help.

    Exit cqlsh by typing:
    
    exit

Step 7: Configure Cassandra (Optional)
    The default configuration works well for testing, but for production, you'll likely need to modify the cassandra.yaml file:

    sudo nano /etc/cassandra/cassandra.yaml

    Key configurations to consider:
  • Cluster Name: Set a meaningful cluster name.
  • Seed Nodes: Define the seed nodes in your cluster.
  • Data Directory: Ensure sufficient disk space is allocated.
  • Heap Size: Adjust for optimal performance.
    After making changes, restart Cassandra:

    sudo systemctl restart cassandra

Step 8: Enable Firewall Rules
    If your system uses a firewall, allow Cassandra's ports (default: 9042 for CQL, 7000 for intra-node communication):

    sudo ufw allow 9042/tcp
    sudo ufw allow 7000/tcp

    

Conclusion

Congratulations! You have successfully installed Apache Cassandra on Ubuntu. You can now use this powerful NoSQL database for your applications.

For more details, refer to the official Apache Cassandra documentation or join the active community for support.


    Feel free to comment below if you encounter any issues during the installation!




                

Comments