Ricerca nel sito web

Come installare il database ArangoDB NoSQL su Debian 11

Su questa pagina

  1. Prerequisiti
  2. Installazione di ArangoDB
  3. Imposta l'ottimizzazione del sistema per la distribuzione di ArangoDB
  4. Connettiti ad ArangoDB e crea un database e un utente
  5. Abilita la console di amministrazione web di ArangoDB
  6. Conclusione

ArangoDB è un moderno sistema di database multi-modello sviluppato da ArangoDB GmbH. è un sistema di database gratuito e open source che supporta tre diversi modelli di dati, documenti, grafici e chiavi/valori. ArangoDB è un sistema di database flessibile che fornisce transazioni ACID e ad alte prestazioni, inoltre è facile da scalare verticalmente e orizzontalmente.

ArangoDB fornisce un linguaggio di query unificato chiamato AQL, che consente di archiviare i dati in diversi moduli di dati. L'AQL è un linguaggio di query dichiarativo che consente la combinazione di diversi modelli di accesso ai dati in una singola query.

In questo tutorial, ti mostreremo come installare e configurare ArangoDB, il sistema di database multi-modello sul server Debian 11.

Prerequisiti

  • Un server Linux Debian 11.
  • Un utente non root con privilegi sudo/root.

Installazione di ArangoDB

Per impostazione predefinita, ArangoDB fornisce un pacchetto binario per la distribuzione Linux più popolare come Debian, Ubuntu e CentOS. Ciò consente agli sviluppatori e agli amministratori di installare più facilmente ArangoDB sulle loro macchine o server.

Prima di installare ArangoDB, esegui il comando apt di seguito per installare l'utilità del pacchetto gnupg2 e apt-transport-https per un'installazione sicura tramite connessioni HTTPS.

sudo apt install -y gnupg2 apt-transport-https

Al termine dell'installazione, scarica la chiave GPG di ArangoDB e aggiungila al tuo sistema Debian.

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

Successivamente, aggiungi il repository ArangoDB per il sistema Debian usando il comando seguente.

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

Aggiorna e aggiorna il tuo repository Debian.

sudo apt update

Nello screenshot qui sotto vedrai che il repository ArangoDB è stato aggiunto al sistema Debian.

Ora installa il pacchetto ArangoDB usando il comando apt di seguito.

sudo apt install arangodb3 arangodb3-dbg

Durante l'installazione, ti verrà chiesto di impostare la password di root per ArangoDB. Inserisci la tua password e seleziona OK.

Ripeti la password di root e seleziona OK.

Per aggiornare automaticamente il database, selezionare Sì per abilitarlo.

Ora ti verrà chiesto di eseguire il backup dei dati del vecchio database di ArangoDB, che verranno archiviati in base alla data nella directory /var/lib. Selezionare Sì per eseguire il backup del database.

L'installazione di ArangoDB sarà ora completata.

Successivamente, avvia e abilita il servizio ArangoDB utilizzando il comando seguente.

sudo systemctl start arangodb3
sudo systemctl enable arangodb3

Infine, verifica il servizio ArangoDb utilizzando il comando seguente.

sudo systemctl status arangodb3

Come puoi vedere dallo screenshot qui sotto, il servizio arangodb3 è in esecuzione e abilitato. Il servizio arangodb3 verrà avviato automaticamente all'avvio del sistema.

Configurazione dell'ottimizzazione del sistema per la distribuzione di ArangoDB

Per la distribuzione di ArangoDB, dovrai ottimizzare il tuo sistema utilizzando una configurazione specifica, in particolare per ottenere maggiori prestazioni da ArangoDB.

Ora creerai uno script bash che verrà eseguito automaticamente all'avvio del sistema. Questo script ottimizzerà automaticamente il tuo sistema Debian per l'esecuzione di ArangoDB.

Per prima cosa, installa il pacchetto sysfsutils usando il comando apt qui sotto.

sudo apt install sysfsutils -y

Al termine dell'installazione, crea un nuovo script bash /etc/init.d/arangodb-os-optimization utilizzando l'editor nano.

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

Aggiungi lo script bash di seguito al file.

#!/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"

Salva e chiudi il file quando hai finito.

Ora rendi eseguibile lo script modificando l'autorizzazione in 755 o +x utilizzando il comando seguente.

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

Infine, aggiungi lo script da eseguire all'avvio utilizzando il comando seguente.

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

Ora hai completato l'installazione di ArangoDB e hai aggiunto uno script di ottimizzazione automatica per l'esecuzione di ArangoDB.

Connettiti ad ArangoDB e crea un database e un utente

Dopo aver completato l'installazione di ArangoDB, ora imparerai come accedere ad arangoDB usando la shell ArangoDB chiamata \arangosh\ e creare un nuovo database e utente per ArangoDB. La riga di comando arangosh ti consente di stabilire una connessione con ArangoDB, è come il comando mysql su MySQL, pgsql di PostgreSQL o mongosh per MongoDB.

Esegui il comando seguente per accedere alla shell ArangoDB. Se non hai specificato il nome utente, questo si collegherà automaticamente in base al tuo sistema. In questo caso, l'utente è la root.

sudo arangosh

Inserisci la password di root di ArangoDB. Una volta connesso, vedrai il seguente output. Puoi vedere nello screenshot seguente la connessione dettagliata ad ArangoDb, che è connesso come utente root al database predefinito _system e al server ArangoDB tcp:/ /127.0.0.1:8529.

Per creare un nuovo utente, dovrai caricare il modulo utente. Esegui la seguente query per caricare il modulo users e creare un nuovo utente testuser con la password testpassword.

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

Successivamente, eseguire le query seguenti per creare un nuovo database testdb e concedere l'accesso amministrativo (rw - lettura e scrittura) all'utente testuser.

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

Digita exit per uscire dalla shell ArangoDB oppure puoi semplicemente premere Ctrl+c.

Infine, per verificare l'utente test e il database testdb, eseguire il seguente comando per connettersi ad ArangoDB come utente testuser al database testdb.

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

Inserisci la password per il testuser e vedrai il seguente output.

Nello screenshot seguente, vedrai le connessioni correnti dettagliate ad ArangoDB, che è connesso come utente testuser al database testdb sul server ArangoDB tcp://127.0.0.1:8529.

Abilita la console di amministrazione Web di ArangoDB

Uno dei principali vantaggi di ArangoDB è che fornisce una console di amministrazione basata sul Web per la gestione della distribuzione di ArangoDB. Il dashboard di amministrazione predefinito è in esecuzione sulla stessa porta 8529 sull'host locale o 127.0.0.1.

Ora, se stai eseguendo ArangoDB su un server, dovrai modificare l'indirizzo di bind con l'indirizzo IP del tuo server in modo da poter accedere alla console di amministrazione web di ArangoDB.

Modifica la configurazione /etc/arangodb3/arangod.conf usando l'editor nano.

sudo nano /etc/arangodb3/arangod.conf

Modifica l'indirizzo dell'endpoint predefinito da 127.0.01 all'indirizzo IP del tuo server. In questo esempio, l'indirizzo IP del server è 192.168.5.20.

endpoint = tcp://192.168.5.20:8529

Salva e chiudi il file quando hai finito.

Ora riavvia il servizio ArangoDB per applicare le nuove modifiche alla tua configurazione ArangoDB.

sudo systemctl restart arangodb3

Verifica la porta di ascolto e l'indirizzo IP sul tuo server utilizzando il comando seguente.

ss -plnt

Come puoi vedere nello screenshot seguente, ArangoDB è ora in esecuzione sull'indirizzo IP del server 192.168.5.20 con la porta predefinita 8529.

Quindi, accendi il browser Web e visita l'indirizzo IP del server ArangoDB con la porta 8529.

Vedrai la pagina di accesso di ArangoDB qui sotto. Immettere l'utente e la password del database e fare clic su Accedi. Questo esempio utilizza l'utente root predefinito di ArangoDB.

Seleziona il database a cui vuoi connetterti e fai clic sul pulsante Seleziona DB: nomedb.

Di seguito puoi vedere la dashboard di amministrazione di ArangoDB.

Successivamente, fai clic sul menu USERS sul lato sinistro e vedrai l'utente testuser che hai appena creato.

Infine, fai clic sul menu DATABASE e vedrai il testdb disponibile su ArangoDB.

Conclusione

Congratulazioni! Ora hai completato e imparato come installare ArangoDB sul server Debian 11. Hai anche imparato come utilizzare la shell ArangoDB per creare un database e un utente. Infine, hai anche imparato come abilitare la console di amministrazione web di ArangoDB per la tua distribuzione.