Linux

  • Visit the official ArangoDB download pageand download the correct package for your Linux distribution. You can findbinary packages for the most common distributions there.
  • Follow the instructions to use your favorite package manager for themajor distributions. After setting up the ArangoDB repository you caneasily install ArangoDB using yum, aptitude, urpmi or zypper.
  • Debian based packages will ask for a password during installation. For anunattended installation for Debian, see below.Red-Hat based packages will set a random password during installation.For other distributions or to change the password, runarango-secure-installation to set a root password.
  • Alternatively, see Compiling if you want to build ArangoDByourself.
  • Start up the database server.Normally, this is done by executing the following command:
  1. unix> /etc/init.d/arangod start

It will start the server, and do that as well at system boot time.

To stop the server you can use the following command:

  1. unix> /etc/init.d/arangod stop

The exact commands depend on your Linux distribution.You may require root privileges to execute these commands.

Linux Mint

Please use the corresponding Ubuntu or Debian packages.

Unattended Installation

Debian based package will ask for a password during installation.For unattended installation, you can set the password using thedebconf helpers.

  1. echo arangodb3 arangodb3/password password NEWPASSWORD | debconf-set-selections
  2. echo arangodb3 arangodb3/password_again password NEWPASSWORD | debconf-set-selections

The commands should be executed prior to the installation.

Red-Hat based packages will set a random password during installation.If you want to force a password, execute

  1. ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arango-secure-installation

The command should be executed after the installation.

Non-Standard Installation

If you compiled ArangoDB from source and did not use any installationpackage – or using non-default locations and/or multiple ArangoDBinstances on the same host – you may want to start the server process manually. You can do so by invoking the arangod binary from the commandline as shown below:

  1. unix> /usr/local/sbin/arangod /tmp/vocbase
  2. 20ZZ-XX-YYT12:37:08Z [8145] INFO using built-in JavaScript startup files
  3. 20ZZ-XX-YYT12:37:08Z [8145] INFO ArangoDB (version 1.x.y) is ready for business
  4. 20ZZ-XX-YYT12:37:08Z [8145] INFO Have Fun!

To stop the database server gracefully, you caneither press CTRL-C or by send the SIGINT signal to the server process. On many systems this can be achieved with the following command:

  1. unix> kill -2 `pidof arangod`

Once you started the server, there should be a running instance of arangod -the ArangoDB database server.

  1. unix> ps auxw | fgrep arangod
  2. arangodb 14536 0.1 0.6 5307264 23464 s002 S 1:21pm 0:00.18 /usr/local/sbin/arangod

If there is no such process, check the log file/var/log/arangodb/arangod.log for errors. If you see a log message like

  1. 2012-12-03T11:35:29Z [12882] ERROR Database directory version (1) is lower than server version (1.2).
  2. 2012-12-03T11:35:29Z [12882] ERROR It seems like you have upgraded the ArangoDB binary. If this is what you wanted to do, please restart with the --database.auto-upgrade option to upgrade the data in the database directory.
  3. 2012-12-03T11:35:29Z [12882] FATAL Database version check failed. Please start the server with the --database.auto-upgrade option

make sure to start the server once with the —database.auto-upgrade option.

Note that you may have to enable logging first. If you start the serverin a shell, you should see errors logged there as well.