Kiểm tra yêu cầu phần cứng và phiên bản Kernel
Đảm bảo hệ điều hành và tài nguyên tối thiểu
Trước khi cài đặt, cần xác nhận hệ điều hành đang chạy là Ubuntu 24.04 và phiên bản kernel hỗ trợ các tính năng mới nhất của ArangoDB.
Thực hiện lệnh kiểm tra phiên bản OS và kernel để đảm bảo môi trường tương thích.
cat /etc/os-release && uname -r
Kết quả mong đợi: Dòng đầu tiên hiển thị "VERSION_CODENAME=noble" hoặc "VERSION_ID="24.04" và dòng thứ hai hiển thị số phiên bản kernel (thường là 6.8 trở lên).
Kiểm tra RAM và CPU
ArangoDB hoạt động hiệu quả nhất khi có đủ RAM để cache dữ liệu. Tối thiểu cần 2GB RAM cho môi trường phát triển.
Sử dụng lệnh free và lscpu để kiểm tra tài nguyên vật lý.
free -h && lscpu | grep "CPU(s)"
Kết quả mong đợi: Tổng RAM (total) >= 2G và số CPU cores >= 2.
Cấu hình Repository chính thức của ArangoDB
Thêm khóa GPG và nguồn Repository
Để cài đặt phiên bản ổn định nhất từ nguồn chính thức, cần thêm repository vào hệ thống thay vì dùng gói trong kho mặc định của Ubuntu (thường là bản cũ).
Thực hiện các lệnh sau để tải khóa bảo mật và cập nhật danh sách nguồn.
curl -fsSL https://arangodb.com/keys/arangodb.asc | gpg --dearmor -o /usr/share/keyrings/arangodb.gpg
Kết quả mong đợi: Không có lỗi, file khóa được tạo tại /usr/share/keyrings/arangodb.gpg.
Tiếp theo, thêm dòng repository vào file nguồn apt.
echo "deb [signed-by=/usr/share/keyrings/arangodb.gpg] https://arangodb.com/3.11/deb/ focal main" | tee /etc/apt/sources.list.d/arangodb.list
Kết quả mong đợi: Nội dung repository được ghi vào file arangodb.list.
Cập nhật danh sách gói phần mềm
Yêu cầu apt cache để tải thông tin phiên bản mới nhất từ repository vừa thêm.
apt update
Kết quả mong đợi: Dòng đầu tiên hiển thị "Hit: ... arangodb.com/3.11/deb/ focal main" và không có lỗi "404 Not Found".
Cài đặt gói ArangoDB và khởi động dịch vụ
Cài đặt gói arangodb3-server
Cài đặt gói server chính thức. Gói này bao gồm cả trình quản lý (arangoshell) và web interface cơ bản.
Thực hiện lệnh cài đặt không yêu cầu xác nhận (non-interactive) để tự động đồng ý các tùy chọn mặc định.
DEBIAN_FRONTEND=noninteractive apt install -y arangodb3-server arangodb3-tools
Kết quả mong đợi: Quá trình cài đặt hoàn tất, hiển thị "Setting up arangodb3-server (3.11.x)" và không có cảnh báo lỗi.
Kiểm tra trạng thái dịch vụ systemd
ArangoDB chạy dưới dạng service systemd. Cần kiểm tra xem service đã khởi động thành công hay chưa.
systemctl status arangodb3-server
Kết quả mong đợi: Trạng thái hiển thị "active (running)" và dòng "Main PID" chỉ ra tiến trình đang chạy.
Cấu hình tự động khởi động khi Boot
Đảm bảo dịch vụ sẽ tự động chạy khi server khởi động lại để tránh mất dịch vụ.
systemctl enable arangodb3-server
Kết quả mong đợi: Hiển thị "Created symlink /etc/systemd/system/multi-user.target.wants/arangodb3-server.service -> /lib/systemd/system/arangodb3-server.service."
Cấu hình file arangod.conf cho chế độ Single-Node
Chỉnh sửa file cấu hình chính
File cấu hình mặc định của ArangoDB nằm tại /etc/arangodb3/arangod.conf. Mặc định đã chạy ở chế độ single-node, nhưng cần cấu hình rõ ràng để chuẩn bị cho các phần sau.
Viết đè file cấu hình với các tham số tối ưu cơ bản cho môi trường Single-Node: bật web interface, đặt mật khẩu root mặc định (cần thay đổi ngay sau khi chạy) và xác định đường dẫn dữ liệu.
cat > /etc/arangodb3/arangod.conf
Kết quả mong đợi: File được ghi thành công, không có lỗi syntax.
Khởi động lại dịch vụ để áp dụng cấu hình
Thay đổi cấu hình file yêu cầu phải restart service để có hiệu lực.
systemctl restart arangodb3-server
Kết quả mong đợi: Dịch vụ được restart thành công và quay lại trạng thái "active (running)".
Verify kết quả cấu hình
Để xác nhận ArangoDB đang chạy đúng chế độ single-node và lắng nghe đúng cổng, sử dụng arangoshell để kết nối.
arangosh --server.endpoint tcp://127.0.0.1:8529 --javascript "db._admin('ping')"
Kết quả mong đợi: Xuất hiện JSON trả về "ok": true, "version": "3.11.x". Nếu thấy lỗi "Connection refused", kiểm tra lại firewall hoặc bind-ipv4.
Verify kết quả tổng thể
Đảm bảo truy cập được Web Interface
Kiểm tra xem cổng 8529 đã mở và phục hồi yêu cầu HTTP chưa.
curl -s http://127.0.0.1:8529/_admin/server
Kết quả mong đợi: Trả về một đoạn JSON chứa thông tin server, không bị lỗi 403 hoặc 500.
Kiểm tra tiến trình đang chạy
Xác nhận tiến trình arangod đang chạy với đúng các tham số mong muốn.
ps aux | grep arangod | grep -v grep
Kết quả mong đợi: Dòng lệnh hiển thị "arangod" và các tham số như "--server.endpoint" hoặc "--log.level".
Điều hướng series:
Mục lục: Series: Triển khai Database Multi-Model với ArangoDB trên Ubuntu 24.04
Phần 2: Khám phá giao diện web (ArangoShell) và quản lý Database »