1
0
Fork 0
arangodb/Documentation/InstallationManual/Installing.md

5.5 KiB

Installing ArangoDB

@NAVIGATE_Installing @EMBEDTOC{InstallingTOC}

Linux

You can find binary packages for various Linux distributions @EXTREF{http://www.arangodb.org/download/,here}.

We provide packages for

  • Centos
  • Debian
  • Fedora
  • Mandriva
  • OpenSUSE
  • RedHat RHEL
  • SUSE SLE
  • Ubuntu

Using a Package Manager to install ArangoDB

Follow the instructions on the download page to use your favorite package manager for the major distributions. After setting up the ArangoDB repository you can then easily install ArangoDB using yum, aptitude, urpmi, or zypper.

Gentoo

Please use the @EXTREF_S{https://github.com/mgiken/portage-overlay/tree/master/dev-db/ArangoDB,portage} provided by @@mgiken.

Linux-Mint

Download and import GPG-PublicKey

wget -O RPM-GPG-KEY-www.arangodb.org http://www.arangodb.org/repositories/PublicKey
apt-key add RPM-GPG-KEY-www.arangodb.org

Add the corresponding repository in file /etc/apt/sources.list:

deb http://www.arangodb.org/repositories LinuxMint-13 main

Update the repository data:

aptitude update

Now you should be able to search for arangodb:

aptitude search arangodb

In order to install arangodb:

aptitude install arangodb

Using Vagrant and Chef

A Chef recipe is available from jbianquetti at

https://github.com/jbianquetti/chef-arangodb

Mac OS X

You can find the Mac OS X packages here:

http://www.arangodb.org/repositories/MacOSX

Homebrew

If you are using @S_EXTREF{http://mxcl.github.com/homebrew/,homebrew}, then you can install the ArangoDB using brew as follows:

brew install arangodb

This will install the current stable version of ArangoDB and all dependencies within your Homebrew tree. Note that the server will be installed as

/usr/local/sbin/arangod

The ArangoDB shell will be install as

/usr/local/bin/arangosh

If you want to install the latest version use:

brew install --HEAD arangodb

You can unstall ArangoDB using

brew uninstall arangodb

However, in case you started ArangoDB using the launchctl, then you need to unload it before uninstalling the server.

launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.arangodb.plist

Then remove the LaunchAgent

rm ~/Library/LaunchAgents/homebrew.mxcl.arangodb.plist

Apple's App Store

ArangoDB is available in Apple's App-Store. Please note, that it sometimes take a few days or weeks until the latest versions will be available.

Windows

We provide precompiled Windows binaries for ArangoDB. The binaries are statically linked with the required libraries such as V8, but they may still require some Windows platform libraries to be present. These libraries should be present on a Windows Vista, Windows 7, and Windows 8 by default, but there may be issues with other platforms.

The Windows builds are available as .msi packages @EXTREF{http://www.arangodb.org/download/,here}. Please note that we provide binaries for 32 and 64 bit Windows, and that you need the package that matches your platform.

The msi installer will install the ArangoDB server, shell (arangosh) and the ArangoDB import tool (arangoimp) in a directory of the user's choice.

Included in the distribution are some .bat files that can be used to easily start the ArangoDB server and shell. The .bat files will be installed in the same directory as ArangoDB so they should be easy to find. The batch files contain a lot of configuration settings, and you might want to eventually adjust these parameters to match your own environment.

To start the ArangoDB server, use the batch file serverExample.bat. It will start the ArangoDB server and will wait until you terminate it by pressing CTRL-C. Starting ArangoDB for the first time will automatically create a database sub-directory in the directory ArangoDB was installed in.

If you already have a previous version of ArangoDB installed and want to upgrade to a newer version, use the upgradeExample.bat file. This will start ArangoDB with the --upgrade option and perform a migration of an existing database.

To start arangosh, use the batch file shellExample.bat.

Please note an important limitation when running ArangoDB under Cygwin: Starting ArangoDB can be started from out of a Cygwin terminal, but pressing CTRL-C will forcefully kill the server process, without giving it a chance to handle the kill signal. In this case, a regular server shutdown is not possible, which may leave a file LOCK around in the server's data directory. This file needs to be removed manually to make ArangoDB start again. Additionally, as ArangoDB does not have a chance to handle the kill signal, the server cannot forcefully flush any data to disk on shutdown, leading to potential data loss.

Starting ArangoDB from an MS-DOS command prompt does not impose the limitations, and the kill signal will be handled normally by the server, allowing it to shut down normally.

Please note that when using ArangoDB's web interface with Internet Explorer (IE), you will need IE version 9 or higher to use all features. The web interface partly relies on SVG, which is not available in previous versions of IE.