本页内容

  • 前提条件
  • 安装 ArangoDB
  • 为 ArangoDB 部署设置系统优化
  • 连接到 ArangoDB 并创建数据库和用户
  • 启用 ArangoDB Web 管理控制台
  • 结论

ArangoDB 是由 ArangoDB GmbH 开发的现代多模型数据库系统。它是一个免费开源数据库系统,支持三种不同的数据模型:文档、图和键/值。ArangoDB 是一个灵活的数据库系统,提供高性能和 ACID 事务,并且易于垂直和水平扩展。

ArangoDB 提供了一种名为 AQL 的统一查询语言,它允许你将数据存储在不同的数据模块中。AQL 是一种声明式查询语言,允许在单个查询中组合不同的数据访问模式。

在本教程中,我们将向你展示如何在 Debian 11 服务器上安装和配置多模型数据库系统 ArangoDB。

前提条件

  • 一台 Debian 11 的 Linux 服务器。
  • 一个具有 sudo/root 权限的非 root 用户。

安装 ArangoDB

默认情况下,ArangoDB 为最流行的 Linux 发行版(如 Debian、Ubuntu 和 CentOS)提供二进制包。这让开发人员和管理员可以更轻松地在自己的机器或服务器上安装 ArangoDB。

在安装 ArangoDB 之前,运行下面的 apt 命令来安装 gnupg2 软件包工具和 apt-transport-https,以便通过 HTTPS 连接进行安全安装。

sudo apt install -y gnupg2 apt-transport-https

安装完成后,下载 ArangoDB 的 GPG 密钥并将其添加到你的 Debian 系统。

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

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

接下来,使用下面的命令为 Debian 系统添加 ArangoDB 仓库。

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

更新并刷新你的 Debian 仓库。

sudo apt update

在下面的截图中,你将看到 ArangoDB 仓库已添加到 Debian 系统。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

现在使用下面的 apt 命令安装 ArangoDB 软件包。

sudo apt install arangodb3 arangodb3-dbg

在安装过程中,系统将提示你为 ArangoDB 设置 root 密码。输入你的密码并选择 OK 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

重复输入你的 root 密码并选择 OK 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

要自动升级数据库,选择 Yes 来启用它。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

现在系统将提示你备份 ArangoDB 的旧数据库数据,这些数据将按日期存储在 /var/lib 目录中。选择 Yes 来备份数据库。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

至此 ArangoDB 的安装将完成。

接下来,使用下面的命令启动并启用 ArangoDB 服务。

sudo systemctl start arangodb3
sudo systemctl enable arangodb3

最后,使用下面的命令验证 ArangoDb 服务。

sudo systemctl status arangodb3

从下面的截图可以看到,arangodb3 服务正在运行且已启用。arangodb3 服务将在系统启动时自动启动。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

为 ArangoDB 部署设置系统优化

对于 ArangoDB 部署,你需要使用一些特定配置来优化系统,尤其是为了获得更高的 ArangoDB 性能。

现在你将创建一个 bash 脚本,它会在系统启动时自动执行。该脚本将自动优化你的 Debian 系统以运行 ArangoDB。

首先,使用下面的 apt 命令安装 sysfsutils 软件包。

sudo apt install sysfsutils -y

安装完成后,使用 nano 编辑器创建一个新的 bash 脚本 /etc/init.d/arangodb-os-optimization。

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 的自动优化脚本。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

连接到 ArangoDB 并创建数据库和用户

完成 ArangoDB 安装后,你现在将学习如何使用名为 "arangosh" 的 ArangoDB shell 登录到 arangoDB,并为 ArangoDB 创建新的数据库和用户。arangosh 命令行允许你建立到 ArangoDB 的连接,它类似于 MySQL 的 mysql 命令、PostgreSQL 的 pgsql 或 MongoDB 的 mongosh。

运行下面的命令登录到 ArangoDB shell。如果你没有指定用户名,它将根据你的系统自动连接。在本例中,用户是 root 。

sudo arangosh

输入 ArangoDB 的 root 密码。连接成功后,你将看到以下输出。你可以在下面的截图中看到到 ArangoDb 的详细连接,它以 root 用户身份连接到默认数据库 _system 和 ArangoDB 服务器 tcp://127.0.0.1:8529 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

要创建新用户,你需要加载用户模块。运行以下查询来加载 users 模块,并创建一个密码为 testpassword 的新用户 testuser 。

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

接下来,运行下面的查询来创建一个新数据库 testdb,并为用户 testuser 授予管理访问权限(rw - 读写)。

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

输入 exit 从 ArangoDB shell 退出,或者直接按 Ctrl+c 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

最后,为验证测试用户和 testdb 数据库,运行以下命令,以用户 testuser 身份连接到 ArangoDB 的 testdb 数据库。

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

输入 testuser 的密码,你将看到以下输出。

在下面的截图中,你将看到到 ArangoDB 的当前连接的详细信息,它以用户 testuser 身份连接到 ArangoDB 服务器 tcp://127.0.0.1:8529 上的数据库 testdb 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

启用 ArangoDB Web 管理控制台

ArangoDB 的主要优势之一是它提供了一个基于 Web 的管理控制台,用于管理你的 ArangoDB 部署。默认的管理仪表板在 localhost 或 127.0.0.1 上的同一端口 8529 下运行。

现在,如果你在服务器上运行 ArangoDB,则需要将绑定地址更改为你的服务器 IP 地址,以便访问 ArangoDB Web 管理控制台。

使用 nano 编辑器编辑配置文件 /etc/arangodb3/arangod.conf。

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 。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

接下来,打开你的 Web 浏览器,访问 ArangoDB 服务器 IP 地址及端口 8529 。

http://192.168.5.20:8529/

你将看到下面的 ArangoDB 登录页面。输入你的数据库用户和密码,然后单击 Login 。本例使用 ArangoDB 的默认 root 用户。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

选择你要连接的数据库,然后单击 Select DB: dbname 按钮。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

下面你可以看到 ArangoDB 管理仪表板。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

接下来,单击左侧的 USERS 菜单,你将看到刚创建的用户 testuser。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

最后,单击 DATABASE 菜单,你将看到 ArangoDB 上可用的 testdb。

在 Debian 11 上安装配置 ArangoDB 数据库完整教程

结论

恭喜!你现在已经完成并学会了如何在 Debian 11 服务器上安装 ArangoDB。你还学会了如何使用 ArangoDB shell 创建数据库和用户。最后,你还学会了如何为你的部署启用 ArangoDB Web 管理控制台。