Cómo instalar la base de datos ArangoDB NoSQL en Debian 11

añadir clave gpg

ArangoDB es un moderno sistema de base de datos multimodelo desarrollado por ArangoDB GmbH. es un sistema de base de datos gratuito y de código abierto que admite tres modelos de datos, documentos, gráficos y valores/clave diferentes. ArangoDB es un sistema de base de datos flexible que proporciona alto rendimiento y transacciones ACID, además es fácil de escalar vertical y horizontalmente.

ArangoDB proporciona un lenguaje de consulta unificado llamado AQL, que le permite almacenar sus datos en diferentes módulos de datos. El AQL es un lenguaje de consulta declarativo que permite la combinación de diferentes patrones de acceso a datos en una sola consulta.

En este tutorial, le mostraremos cómo instalar y configurar ArangoDB, el sistema de base de datos multimodelo en el servidor Debian 11.

requisitos previos

  • Un servidor Linux Debian 11.
  • Un usuario no root con privilegios sudo/root.

Instalando ArangoDB

De forma predeterminada, ArangoDB proporciona un paquete binario para la distribución de Linux más popular, como Debian, Ubuntu y CentOS. Esto permite que los desarrolladores y administradores instalen más fácilmente ArangoDB en sus máquinas o servidores.

Antes de instalar ArangoDB, ejecute el siguiente comando apt para instalar la utilidad del paquete gnupg2 y apt-transport-https para una instalación segura a través de conexiones HTTPS.

sudo apt install -y gnupg2 apt-transport-https

Una vez completada la instalación, descargue la clave GPG de ArangoDB y agréguela a su sistema Debian.

curl -OL https://download.arangodb.com/arangodb39/DEBIAN/Release.key
sudo apt-key add - < Release.key

añadir clave gpg

Luego, agregue el repositorio ArangoDB para el sistema Debian usando el siguiente comando.

echo 'deb https://download.arangodb.com/arangodb39/DEBIAN/ /' | sudo tee /etc/apt/sources.list.d/arangodb.list

Actualice y refresque su repositorio de Debian.

sudo apt update

En la siguiente captura de pantalla, verá que el repositorio ArangoDB se agrega al sistema Debian.

añadir repositorio arangodb

Ahora instale el paquete ArangoDB usando el comando apt a continuación.

sudo apt install arangodb3 arangodb3-dbg

Durante la instalación, se le pedirá que configure la contraseña de root para ArangoDB. Ingrese su contraseña y seleccione OK.

configurar la contraseña raíz

Repita su contraseña de root y seleccione OK.

repetir la contraseña de root

Para actualizar automáticamente la base de datos, seleccione Sí para habilitarlo.

habilitar la actualización automática

Ahora se le pedirá que haga una copia de seguridad de los datos de la base de datos antigua de ArangoDB, que se almacenarán según la fecha en el directorio /var/lib. Seleccione Sí para hacer una copia de seguridad de la base de datos.

copia de seguridad de la base de datos antes de la actualización

La instalación de ArangoDB ahora estará completa.

Luego, inicie y habilite el servicio ArangoDB usando el siguiente comando.

sudo systemctl start arangodb3
sudo systemctl enable arangodb3

Por último, verifique el servicio ArangoDb usando el siguiente comando.

sudo systemctl status arangodb3

Como puede ver en la siguiente captura de pantalla, el servicio arangodb3 se está ejecutando y habilitado. El servicio arangodb3 se iniciará automáticamente al iniciar el sistema.

verificar arangodb3Anuncio publicitario

Optimización del sistema de configuración para la implementación de ArangoDB

Para la implementación de ArangoDB, deberá optimizar su sistema utilizando alguna configuración específica, especialmente para obtener un mayor rendimiento de ArangoDB.

Ahora creará un script bash que se ejecutará automáticamente cada vez que se inicie el sistema. Este script optimizará automáticamente su sistema Debian para ejecutar ArangoDB.

Primero, instale el paquete sysfsutils usando el comando apt a continuación.

sudo apt install sysfsutils -y

Una vez completada la instalación, cree un nuevo script bash /etc/init.d/arangodb-os-optimization usando el editor nano.

sudo nano /etc/init.d/arangodb-os-optimization

Agregue el script bash a continuación al archivo.

#!/bin/bash
### BEGIN INIT INFO
# Provides: arangodb-memory-configuration
# Required-Start:
# Required-Stop:
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Set arangodb kernel parameters
# Description: Set arangodb kernel parameters
### END INIT INFO

# 1 - Raise the vm map count value
sudo sysctl -w "vm.max_map_count=2048000"

# 2 - Disable Transparent Huge Pages
sudo bash -c "echo madvise > /sys/kernel/mm/transparent_hugepage/enabled"
sudo bash -c "echo madvise > /sys/kernel/mm/transparent_hugepage/defrag"

# 3 - Set the virtual memory accounting mode
sudo bash -c "echo 0 > /proc/sys/vm/overcommit_memory"

Guarde y cierre el archivo cuando haya terminado.

Ahora haga que el script sea ejecutable cambiando el permiso a 755 o +x usando el siguiente comando.

sudo chmod +x /etc/init.d/arangodb-os-optimization

Por último, agregue el script para que se ejecute en el arranque con el siguiente comando.

sudo update-rc.d arangodb-os-optimization defaults

Ahora ha completado la instalación de ArangoDB y ha agregado un script de optimización automática para ejecutar ArangoDB.

configurar el script de optimización de arangodb

Conéctese a ArangoDB y cree una base de datos y un usuario

Después de completar la instalación de ArangoDB, ahora aprenderá cómo iniciar sesión en arangoDB usando el shell de ArangoDB llamado «arangosh» y crear una nueva base de datos y un usuario para ArangoDB. La línea de comando arangosh le permite establecer una conexión con ArangoDB, es como el comando mysql en MySQL, pgsql de PostgreSQL o mongosh para MongoDB.

Ejecute el siguiente comando para iniciar sesión en el shell de ArangoDB. Si no especificó el nombre de usuario, este se conectará automáticamente según su sistema. En este caso, el usuario es el root.

sudo arangosh

Ingrese la contraseña de root de ArangoDB. Una vez que esté conectado, verá el siguiente resultado. Puede ver en la siguiente captura de pantalla la conexión detallada a ArangoDb, que está conectado como usuario raíz a la base de datos predeterminada _system y al servidor ArangoDB tcp://127.0.0.1:8529.

iniciar sesión en el shell arangosh arangodb

Para crear un nuevo usuario, deberá cargar el módulo de usuario. Ejecute la siguiente consulta para cargar el módulo de usuarios y crear un nuevo usuario usuario de prueba con la contraseña contraseña de prueba.

const users = require('@arangodb/users');
users.save('testuser', 'testpassword');

A continuación, ejecute las siguientes consultas para crear una nueva base de datos testdb y otorgar acceso administrativo (rw – lectura y escritura) al usuario usuario de prueba.

db._createDatabase('testdb');
users.grantDatabase('testuser', 'testdb', 'rw');

Escriba exit para cerrar sesión en el shell de ArangoDB o simplemente presione Ctrl+c.

crear nueva base de datos y usuario

Por último, para verificar el usuario de prueba y testdb base de datos, ejecute el siguiente comando para conectarse a ArangoDB como usuario usuario de prueba a la base de datos testdb.

sudo arangosh --server.endpoint tcp://127.0.0.1:8529 --server.username testuser --server.database testdb

Ingrese la contraseña para testuser y verá el siguiente resultado.

En la siguiente captura de pantalla, verá las conexiones actuales detalladas a ArangoDB, que está conectado como el usuario usuario de prueba a la base de datos testdb en el servidor ArangoDB tcp://127.0.0.1:8529.

inicie sesión en arangodb usando un nuevo usuario

Habilitar la consola de administración web de ArangoDB

Una de las principales ventajas de ArangoDB es que proporciona una consola de administración basada en web para administrar su implementación de ArangoDB. El panel de administración predeterminado se ejecuta en el mismo puerto 8529 en el host local o 127.0.0.1.

Ahora, si está ejecutando ArangoDB en un servidor, deberá cambiar la dirección de enlace a la dirección IP de su servidor para poder acceder a la consola de administración web de ArangoDB.

Edite la configuración /etc/arangodb3/arangod.conf usando el editor nano.

sudo nano /etc/arangodb3/arangod.conf

Cambie la dirección del punto final predeterminado de 127.0.01 a la dirección IP de su servidor. En este ejemplo, la dirección IP del servidor es 192.168.5.20.

endpoint = tcp://192.168.5.20:8529

Guarde y cierre el archivo cuando haya terminado.

Ahora reinicie el servicio ArangoDB para aplicar nuevos cambios a su configuración ArangoDB.

sudo systemctl restart arangodb3

Verifique el puerto de escucha y la dirección IP en su servidor usando el siguiente comando.

ss -plnt

Como puede ver en la siguiente captura de pantalla, ArangoDB ahora se está ejecutando en la dirección IP del servidor 192.168.5.20 con puerto predeterminado 8529.

habilitar la consola de administración web de arangodb

A continuación, encienda su navegador web y visite la dirección IP del servidor ArangoDB con el puerto 8529.Anuncio publicitario

http://192.168.5.20:8529/

Verá la página de inicio de sesión de ArangoDB a continuación. Ingrese su usuario y contraseña de la base de datos y haga clic en Acceso. Este ejemplo utiliza el valor predeterminado raíz usuario de ArangoDB.

iniciar sesión en arangodb

Seleccione la base de datos a la que desea conectarse y haga clic en el botón Seleccionar base de datos: nombre de base de datos.

seleccione la base de datos para conectarse

A continuación puede ver el panel de administración de ArangoDB.

Panel de administración de ArangoDB

A continuación, haga clic en el USUARIOS menú en el lado izquierdo y verás el usuario usuario de prueba que acabas de crear.

Lista de usuarios de ArangoDB

Por último, haga clic en el BASE DE DATOS menú y verás el testdb disponible en ArangoDB.

ArangoDB Listar bases de datos

Conclusión

¡Felicidades! Ahora ha completado y aprendido cómo instalar ArangoDB en el servidor Debian 11. También aprendió a usar el shell ArangoDB para crear una base de datos y un usuario. Por último, también aprendió cómo habilitar la consola de administración web de ArangoDB para su implementación.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *