PDB Ayuda

Cómo instalar la base de datos Cassandra en Windows 11

📅
🕑 5 minutos de lectura

Instalar Cassandra en Windows 11 puede ser un poco complicado si no estás preparado, sobre todo porque depende en gran medida de Java y las variables de entorno. A veces, incluso después de instalarlo todo, la línea de comandos simplemente no reconoce los comandos de Cassandra o CQLSH no se conecta. Me ha pasado: lo tengo todo configurado, pero nada funciona hasta que descubro algunos de estos problemas. Con suerte, estos pasos te ayudarán a evitar algunos de los dolores de cabeza típicos, como que Java no se detecte o que Cassandra no se inicie correctamente. Una vez configurado, ejecutar Cassandra en Windows para desarrollo o pruebas es bastante sencillo, pero Windows parece hacerlo un poco menos directo que Linux, claro.

Cómo solucionar problemas de instalación de Cassandra en Windows 11

Asegúrese de que Java esté correctamente instalado y reconocido.

Uno de los problemas más comunes es que Cassandra no se inicie porque Java no se detecta correctamente. Cassandra necesita Java y depende de variables de entorno como JAVA_HOME. Si instalaste Java pero el símbolo del sistema no lo encuentra, Cassandra no se iniciará o CQLSH mostrará errores. Para solucionarlo, verifica que Java esté en la variable de entorno PATH de tu sistema y que JAVA_HOME apunte a la carpeta correcta.

  • Abra el Menú Inicio y busque Ver configuración avanzada del sistema o haga clic con el botón derecho en Este equipo > Propiedades > Configuración avanzada del sistema.
  • Haz clic en Variables de entorno.
  • En Variables del sistema, busque o cree JAVA_HOME.
  • Establezca su valor en la ruta de instalación de Java, por ejemplo: C:\Program Files\Java\jdk-21.
  • Agregue %JAVA_HOME%\bin a su variable Path; simplemente haga clic en Editar, luego en Nuevo y pegue eso.

Esto ayuda a Windows a indicarle a Cassandra dónde se encuentra Java.En algunas configuraciones, no basta con establecer JAVA_HOME; también hay que agregarlo a la variable de entorno PATH.

Configure correctamente CASSANDRA_HOME y PATH.

A continuación, debes indicarle a Windows dónde se encuentra Cassandra. El procedimiento es el mismo: variables de entorno.

  • Cree una variable CASSANDRA_HOME que apunte a su carpeta de Cassandra, por ejemplo: C:\Cassandra\apache-cassandra-5.0.
  • No olvides añadir %CASSANDRA_HOME%\bin a la ruta de tu sistema para poder ejecutar comandos desde cualquier lugar.¡Te ahorrará muchísimo tiempo!

Después de configurar esto, reinicia el Símbolo del sistema o PowerShell para asegurarte de que las variables de entorno se recarguen. Verifica con echo %JAVA_HOME%y echo %CASSANDRA_HOME%. Si muestran las rutas correctas, todo está bien.

Instalar Python para CQLSH

Este problema suele causar confusión, sobre todo porque la interfaz de línea de comandos de Cassandra, CQLSH, a menudo requiere Python. Sin Python, es posible que aparezcan errores como «Python no encontrado» o que simplemente no se inicie. Descarga Python desde python.org, ejecuta el instalador y asegúrate de marcar la opción «Añadir Python a la variable de entorno PATH».

Abre la línea de comandos y escribe python --version. Debería mostrar el número de versión. Si no es así, intenta reinstalarlo; a veces, la variable PATH no se actualiza correctamente después de la instalación.

Inicia Cassandra correctamente

Una vez que se hayan configurado todas las variables de entorno y se hayan instalado Java y Python, abra el Símbolo del sistema como administrador. Navegue hasta el directorio bin, por ejemplo:

cd C:\Cassandra\apache-cassandra-5.0\bin

Y correr:

cassandra

Esto iniciará el servidor. A veces, tarda uno o dos minutos en cargarse por completo y los registros se desplazarán hacia abajo; esto es normal. Si después de un rato no ocurre nada, revise los registros en \logsla carpeta correspondiente para obtener pistas. Asegúrese de que el Firewall de Windows no esté bloqueando los puertos (9042, 7000, 7199).Si aparecen solicitudes de permisos, otórguelos.

Lanzamiento de CQLSH y conexión

Una vez que el servidor esté en funcionamiento, abra una nueva ventana del símbolo del sistema, navegue nuevamente hasta \biny escriba cqlsh. Si todo está configurado correctamente, verá un mensaje como este:

Connected to Test Cluster at 127.0.0.1:9042

Esto significa que Cassandra está operativo. Ahora puede comenzar a crear espacios de claves y tablas, tal como se indica en la documentación, por ejemplo:

CREATE KEYSPACE testdb WITH replication = { 'class': 'SimpleStrategy', 'replication_factor': 1 };

Y luego:

USE testdb;

Por lo general, si experimenta errores de conexión, revise la configuración del entorno o compruebe si hay conflictos de puertos o problemas con el cortafuegos. A veces, simplemente reiniciar el equipo después de configurar las variables de entorno ayuda a que todo se reconozca correctamente.

Consejos adicionales desde las trincheras:

  • Ejecuta el símbolo del sistema como administrador; en ocasiones, Cassandra necesita permisos superiores para asignar puertos.
  • Utiliza rutas sencillas como esta C:\Cassandra: Windows puede generar problemas de ruta si usas carpetas anidadas demasiado complejas.
  • Si al iniciar Cassandra aparecen errores relacionados con la versión de Java o con que no se encuentra, compruebe la ruta en JAVA_HOME.
  • Si CQLSH no se inicia, verifique la instalación de Python y agréguelo también a la variable PATH.

Sinceramente, en algunas configuraciones, puede que las cosas no funcionen a la perfección la primera vez. Quizás tengas que reiniciar o revisar las variables de entorno. A Windows le encanta complicar las cosas, pero una vez que todo está configurado correctamente, Cassandra funciona sin problemas.

Resumen

  • Asegúrese de que Java esté instalado y que la variable JAVA_HOME esté configurada correctamente.
  • Agregue los binarios de Java y Cassandra a la ruta del sistema.
  • Asegúrese de que CASSANDRA_HOME apunte a la carpeta extraída.
  • Instala Python si quieres usar CQLSH sin problemas.
  • Ejecuta Cassandra desde la línea de comandos como administrador.
  • Inicie CQLSH desde una nueva ventana de comandos para conectarse a su clúster local.

Resumen

Configurar Cassandra en Windows 11 puede parecer una tarea ardua, pero una vez que se corrigen las variables de entorno y el servidor arranca, todo cambia. Sigue estos pasos, revisa los archivos de registro y ten paciencia durante el inicio. Es muy gratificante ver Cassandra funcionando en tu equipo Windows, sobre todo porque suele funcionar mejor en entornos Linux. Esperemos que esto le ahorre a alguien muchos quebraderos de cabeza o que pase horas solucionando problemas. Solo ten cuidado con las rutas de entorno: Windows les da mucha importancia.