Cómo instalar Cassandra y ejecutar un clúster de un solo nodo en Ubuntu 22.04

El autor seleccionó el Fondo de Código Libre y Abierto para recibir una donación como parte del programa Write for DOnations .

Introducción

Apache Cassandra es un sistema de base de datos NoSQL distribuido, sin maestro y de código abierto. Cassandra se considera muy adecuado para aplicaciones de misión crítica y configuraciones de múltiples nodos porque es escalable, elástico y tolerante a fallas. La administración de bases de datos de Cassandra funciona a través de un sistema de nodos y los nodos se mantienen dentro de un clúster.

En este tutorial, instalará y utilizará Cassandra para ejecutar un clúster de un solo nodo en Ubuntu 22.04.

Prerrequisitos

Para completar este tutorial, necesitará lo siguiente:

Un servidor Ubuntu 22.04 configurado con la guía de configuración inicial de servidores Ubuntu 22.04 con un usuario sudo que no sea root, firewall y al menos 2 GB de RAM. Cassandra no se ejecutará si se implementa en un servidor con solo 1 GB de RAM. Consulta la guía oficial de requisitos de hardware para Cassandra para obtener más información.
Java runtime instalado en su máquina. Puede instalar uno de los runtimes OpenJDK 8, OpenJDK 11, Oracle Java Standard Edition 8 u Oracle Java Standard Edition 11 siguiendo el Paso 1 de Cómo instalar Java con Apt en Ubuntu 22.04 .

Nota: Si actualiza la base de datos del paquete y actualiza el servidor con los comandos sudo apt updatey sudo apt upgrade, reiniciar el servidor antes de comenzar el Paso 1 de este artículo hará que el mensaje que apareció en el Paso 1 no vuelva a aparecer.

Paso 1: Instalación de Cassandra

Instalarás Cassandra usando paquetes de los repositorios oficiales de Apache Software Foundation . Comenzarás agregando el repositorio para que los paquetes estén disponibles en tu sistema.

Para comenzar, inicie sesión en su servidor:

ssh sammy@your-server-ip

Actualizar la base de datos del paquete:

sudo apt update

Luego actualice el sistema:

sudo apt upgrade

Confirme la instalación con y.

Durante el proceso de actualización, es posible que reciba un mensaje en su terminal (consulte la imagen a continuación) que le solicite información sobre la versión del kernel instalada y le solicite que reinicie el servidor. No verá estos mensajes si actualizó y reinició el servidor en la fase de configuración inicial:

Presione Enterpara cerrar el mensaje, pero tome nota para reiniciar el servidor después de completar este tutorial.

También puede aparecer el mensaje que se muestra a continuación. Si es así, presione Enterpara aceptar la opción predeterminada.

Cuando se haya completado la actualización, utilice el siguiente comando para agregar el repositorio oficial de Cassandra al sistema:

echo "deb http://www.apache.org/dist/cassandra/debian 40x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list

El echocomando escribirá la cadena entre comillas en una salida estándar, que se envía por canalización ( |) al teecomando. El teecomando la escribe en el cassandra.sources.listarchivo. La -abandera indica teeque se debe agregar la línea al final del archivo. De lo contrario, sobrescribiría el contenido existente, si lo hubiera.

Al momento de escribir, la última versión de Cassandra es 4.0.4. El comando hace referencia 40xporque está agregando el repositorio para la serie 4.0 de Cassandra.

Si se agregó correctamente, el resultado debería ser:

Outputdeb http://www.apache.org/dist/cassandra/debian 40x main

Luego, utilizando los comandos wgety tee, agregue las claves del repositorio a la lista de claves confiables en el sistema:

wget -q -O - https://www.apache.org/dist/cassandra/KEYS | sudo tee /etc/apt/trusted.gpg.d/cassandra.asc

En este comando canalizado, wgetse descarga el KEYSarchivo, que luego se canaliza ( |) al teecomando. El teecomando escribe la entrada que recibió en el cassandra.ascarchivo. La qopción indica al wgetcomando que suprima su salida normal y la Oopción indica wgetque escriba el archivo que descargó en la salida estándar ( -). Esta opción es la letra mayúscula O , no el número cero.

Actualice la base de datos del paquete una vez más:

sudo apt update

Por último, instala Cassandra:

sudo apt install cassandra

Si se le solicita, confirme la instalación con y.

Con esto, Cassandra ya debería estar instalada en el servidor. En la siguiente sección, confirmará que el demonio Cassandra se está ejecutando.

Paso 2: Confirmar que el demonio Cassandra se está ejecutando

Con el paquete instalado, el demonio Cassandra debería haberse iniciado automáticamente.

Para confirmar que se está ejecutando, utilice este comando:

sudo systemctl status cassandra

La salida debería ser similar a la siguiente:

Output● cassandra.service - LSB: distributed storage system for structured data     Loaded: loaded (/etc/init.d/cassandra; generated)     Active: active (running) since Tue 2022-06-28 03:25:52 UTC; 1min 32s ago       Docs: man:systemd-sysv-generator(8)    Process: 4606 ExecStart=/etc/init.d/cassandra start (code=exited, status=0/SUCCESS)      Tasks: 52 (limit: 9495)     Memory: 2.2G        CPU: 17.401s     CGroup: /system.slice/cassandra.service             └─4723 /usr/bin/java -ea -da:net.openhft... -XX:+UseThreadPriorities -XX:+HeapDumpOnOutOfMemoryError -Xss256k -XX:+AlwaysPreTouch -XXJun 28 03:25:52 ubuntu-cass systemd[1]: Starting LSB: distributed storage system for structured data...Jun 28 03:25:52 ubuntu-cass systemd[1]: Started LSB: distributed storage system for structured data.

Si el resultado indica que el demonio no pudo iniciarse con un error oom-kill , el demonio no pudo iniciarse porque el sistema se quedó sin memoria. Para resolver el problema, agregue más RAM a su servidor. Si está utilizando un Droplet de DigitalOcean, puede cambiar el tamaño del Droplet desde la consola o mediante la API .

Ahora que ha confirmado que el demonio Cassandra se está ejecutando, ahora verificará el estado del clúster y se conectará a él.

Paso 3: Conexión al clúster

Para conectarse al clúster, utilizará la nodetoolutilidad.

Para comprobar el estado del clúster, escriba:

sudo nodetool status

En la salida, UNsignifica que está Arriba y Normal :

OutputDatacenter: datacenter1=======================Status=Up/Down|/ State=Normal/Leaving/Joining/Moving--  Address    Load       Tokens  Owns (effective)  Host ID                               Rack UN  127.0.0.1  69.08 KiB  16      100.0%            d9618485-4c16-4feb-8a2a-632192c0d587  rack1

Luego conéctese al clúster utilizando su interfaz de línea de comandos interactiva cqlsh:

cqlsh

Verás que se conecta:

OutputConnected to Test Cluster at 127.0.0.1:9042[cqlsh 6.0.0 | Cassandra 4.0.4 | CQL spec 3.4.5 | Native protocol v5]Use HELP for help.

Escriba exitpara salir:

exit

Conclusión

¡Felicitaciones! Ahora tienes un clúster Cassandra de un solo nodo ejecutándose en Ubuntu 22.04. Puedes configurar un clúster de varios nodos con Cómo instalar Cassandra y ejecutar un clúster de varios nodos . Hay más información sobre Cassandra disponible en el sitio web del proyecto .