SDB:ArangoDB

openSUSE Support Database

Portal - SDB Categories - How to write an article

Tested on openSUSE

Recommended articles

Related articles

This is the beginning of the ArangoDB support database...

About

ArangoDB is a native multi-model database. Multi-model because ArangoDB provides the capabilities of a graph database, a document database, a key-value store in one C++ core. ArangoDB is native, because users can use and freely combine all supported data models even in a single query.

Installation

First, add the repository using Zypper:

Official Vendor Release

ArangoDB officially supports openSUSE with RPMs and a repository, instructions can be found for using those at arangodb.com. The installation manual there may also have newer instructions that may not have been updated here yet, but may also have more generic instructions not specifically for openSUSE.

OBS Releases

Leap 15.3

zypper ar https://download.opensuse.org/repositories/server:/database/openSUSE_Leap_15.3/server:database.repo

Tumbleweed

zypper ar https://download.opensuse.org/repositories/server:/database/openSUSE_Tumbleweed/server:database.repo

Other versions can use one of the repos here.

ArangoDB can now be installed using Zypper:

zypper in arangodb3

Secure

Run the following command to set the root password for ArangoDB:

arango-secure-installation

Service

The status of the can be verifed using systemctl:

systemctl status arangodb3

Start ArangoDB:

systemctl start arangodb3

Stop ArangoDB:

systemctl stop arangodb3

Restart ArangoDB:

systemctl restart arangodb3

ArangoDB doesn't start upon boot, by default. To start it upon boot, enable it:

systemctl enable arangodb3

Configuration

ArangoDB's configuration files can be found in /usr/etc/arangodb3/ on openSUSE.

arangod.conf

Web Interface

If you need to access the ArangoDB web interface on another server, you'll need to change the endpoint configuration setting. Open /usr/etc/arangodb3/arangod.conf and edit the line:

[server]
# Specify the endpoint for HTTP requests by clients.
#  tcp://ipv4-address:port
#  tcp://[ipv6-address]:port
#  ssl://ipv4-address:port
#  ssl://[ipv6-address]:port
#  unix:///path/to/socket
#
# Examples:
#   endpoint = tcp://0.0.0.0:8529
#   endpoint = tcp://127.0.0.1:8529
#   endpoint = tcp://localhost:8529
#   endpoint = tcp://myserver.arangodb.com:8529
#   endpoint = tcp://[::]:8529
#   endpoint = tcp://[fe80::21a:5df1:aede:98cf]:8529
#
endpoint = tcp://127.0.0.1:8529

Keep in mind: changing this to a public access point will allow public HTTP access to the database, not just the Web Interface. To allow network access, set the IP address or [::] in arangod.conf. You will also have to open TCP port 8929 in the default zone in the Firewall.

Once the endpoint and Firewall are set up, you can access the Web Interface in a browser (assuming an ArangoDB server IP address 192.168.122.200):

http://192.168.122.200:8529

Restart

Reminder: configuration changes will require restarting ArangoDB with systemctl

Firewall

ArangoDB utilizes TCP port 8529