Поиск по сайту:

Как установить базу данных ArangoDB NoSQL на Debian 11

На этой странице

  1. Предпосылки
  2. Установка ArangoDB
  3. Настройка оптимизации системы для развертывания ArangoDB
  4. Подключение к ArangoDB и создание базы данных и пользователя
  5. Включить консоль веб-администрирования ArangoDB
  6. Заключение

ArangoDB — современная мультимодельная система баз данных, разработанная ArangoDB GmbH. это бесплатная система баз данных с открытым исходным кодом, которая поддерживает три различные модели данных, документы, графики и ключ/значение. ArangoDB — это гибкая система баз данных, обеспечивающая высокую производительность и ACID-транзакции, а также легко масштабируемая по вертикали и горизонтали.

ArangoDB предоставляет единый язык запросов под названием AQL, который позволяет хранить данные в разных модулях данных. AQL — это декларативный язык запросов, который позволяет сочетать различные шаблоны доступа к данным в одном запросе.

В этом руководстве мы покажем вам, как установить и настроить ArangoDB, многомодельную систему баз данных на сервере Debian 11.

Предпосылки

  • Сервер Linux Debian 11.
  • Пользователь без полномочий root с привилегиями sudo/root.

Установка АрангоДБ

По умолчанию ArangoDB предоставляет бинарный пакет для самых популярных дистрибутивов Linux, таких как Debian, Ubuntu и CentOS. Это позволяет разработчикам и администраторам проще устанавливать ArangoDB на свои машины или серверы.

Перед установкой ArangoDB выполните приведенную ниже команду apt, чтобы установить утилиту пакета gnupg2 и apt-transport-https для безопасной установки через соединения HTTPS.

sudo apt install -y gnupg2 apt-transport-https

После завершения установки загрузите ключ GPG ArangoDB и добавьте его в свою систему Debian.

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

Затем добавьте репозиторий ArangoDB для системы Debian с помощью приведенной ниже команды.

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

Обновите и обновите свой репозиторий Debian.

sudo apt update

На приведенном ниже снимке экрана вы увидите, что репозиторий ArangoDB добавлен в систему Debian.

Теперь установите пакет ArangoDB, используя приведенную ниже команду apt.

sudo apt install arangodb3 arangodb3-dbg

Во время установки вам будет предложено установить пароль root для ArangoDB. Введите свой пароль и выберите ОК.

Повторите пароль root и нажмите OK.

Чтобы автоматически обновить базу данных, выберите Да, чтобы включить ее.

Теперь вам будет предложено сделать резервную копию старых данных базы данных ArangoDB, которые будут храниться на основе даты в каталоге /var/lib. Выберите Да, чтобы создать резервную копию базы данных.

Теперь установка ArangoDB будет завершена.

Затем запустите и включите службу ArangoDB, используя приведенную ниже команду.

sudo systemctl start arangodb3
sudo systemctl enable arangodb3

Наконец, проверьте службу ArangoDb, используя приведенную ниже команду.

sudo systemctl status arangodb3

Как видно из приведенного ниже снимка экрана, служба arangodb3 запущена и включена. Служба arangodb3 будет автоматически запущена при запуске системы.

Настройка оптимизации системы для развертывания ArangoDB

Для развертывания ArangoDB вам потребуется оптимизировать систему с помощью определенной конфигурации, особенно для повышения производительности ArangoDB.

Теперь вы будете создавать сценарий bash, который будет автоматически выполняться при загрузке системы. Этот скрипт автоматически оптимизирует вашу систему Debian для запуска ArangoDB.

Сначала установите пакет sysfsutils с помощью приведенной ниже команды apt.

sudo apt install sysfsutils -y

После завершения установки создайте новый скрипт bash /etc/init.d/arangodb-os-optimization с помощью редактора nano.

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

Добавьте приведенный ниже скрипт bash в файл.

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

Сохраните и закройте файл, когда закончите.

Теперь сделайте скрипт исполняемым, изменив разрешение на 755 или +x с помощью приведенной ниже команды.

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

Наконец, добавьте скрипт для запуска при загрузке с помощью приведенной ниже команды.

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

Теперь вы завершили установку ArangoDB и добавили скрипт автоматической оптимизации для запуска ArangoDB.

Подключитесь к ArangoDB и создайте базу данных и пользователя

После завершения установки ArangoDB вы теперь узнаете, как войти в arangoDB, используя оболочку ArangoDB с именем arangosh, и создать новую базу данных и пользователя для ArangoDB. Командная строка arangosh позволяет вам установить соединение с ArangoDB, это похоже на команду mysql для MySQL, pgsql для PostgreSQL или mongosh для MongoDB.

Выполните приведенную ниже команду, чтобы войти в оболочку ArangoDB. Если вы не указали имя пользователя, оно автоматически подключится в зависимости от вашей системы. В этом случае пользователь является root.

sudo arangosh

Введите корневой пароль ArangoDB. После подключения вы увидите следующий вывод. На следующем снимке экрана вы можете увидеть подробное подключение к ArangoDb, который подключен как пользователь root к базе данных по умолчанию _system и к серверу ArangoDB tcp:/ /127.0.0.1:8529.

Чтобы создать нового пользователя, вам нужно будет загрузить пользовательский модуль. Выполните следующий запрос, чтобы загрузить модуль users и создать нового пользователя testuser с паролем testpassword.

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

Затем выполните приведенные ниже запросы, чтобы создать новую базу данных testdb и предоставить административный доступ (rw — чтение и запись) пользователю testuser.

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

Введите exit, чтобы выйти из оболочки ArangoDB, или вы можете просто нажать Ctrl+c.

Наконец, чтобы проверить тестового пользователя и базу данных testdb, выполните следующую команду, чтобы подключиться к ArangoDB в качестве пользователя testuser к базе данных testdb.

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

Введите пароль для тестового пользователя, и вы увидите следующий вывод.

На приведенном ниже снимке экрана вы увидите подробные текущие подключения к ArangoDB, которая подключена как пользователь testuser к базе данных testdb на сервере ArangoDB tcp://127.0.0.1:8529.

Включить консоль веб-администрирования ArangoDB

Одним из основных преимуществ ArangoDB является то, что он предоставляет веб-консоль администрирования для управления развертыванием ArangoDB. Панель администрирования по умолчанию работает под тем же портом 8529 на локальном хосте или 127.0.0.1.

Теперь, если вы используете ArangoDB на сервере, вам нужно будет изменить адрес привязки на IP-адрес вашего сервера, чтобы вы могли получить доступ к консоли веб-администрирования ArangoDB.

Отредактируйте конфигурацию /etc/arangodb3/arangod.conf с помощью редактора nano.

sudo nano /etc/arangodb3/arangod.conf

Измените адрес конечной точки по умолчанию с 127.0.01 на IP-адрес вашего сервера. В этом примере IP-адрес сервера — 192.168.5.20.

endpoint = tcp://192.168.5.20:8529

Сохраните и закройте файл, когда закончите.

Теперь перезапустите службу ArangoDB, чтобы применить новые изменения к вашей конфигурации ArangoDB.

sudo systemctl restart arangodb3

Проверьте порт прослушивания и IP-адрес на вашем сервере, используя приведенную ниже команду.

ss -plnt

Как вы можете видеть на следующем снимке экрана, ArangoDB теперь работает на IP-адресе сервера 192.168.5.20 с портом по умолчанию 8529.

Затем включите веб-браузер и посетите IP-адрес сервера ArangoDB с портом 8529.

Ниже вы увидите страницу входа в ArangoDB. Введите имя пользователя и пароль к базе данных и нажмите Войти. В этом примере используется привилегированный пользователь ArangoDB по умолчанию.

Выберите базу данных, к которой вы хотите подключиться, и нажмите кнопку Select DB: dbname.

Ниже вы можете увидеть панель администрирования ArangoDB.

Затем щелкните меню ПОЛЬЗОВАТЕЛИ с левой стороны, и вы увидите пользователя testuser, которого вы только что создали.

Наконец, нажмите на меню DATABASE, и вы увидите тестовую базу данных, доступную в ArangoDB.

Заключение

Поздравляем! Теперь вы завершили и узнали, как установить ArangoDB на сервер Debian 11. Вы также узнали, как использовать оболочку ArangoDB для создания базы данных и пользователя. Наконец, вы также узнали, как включить консоль веб-администрирования ArangoDB для своего развертывания.