mirror of https://gitee.com/bigwinds/arangodb
126 lines
3.5 KiB
Markdown
126 lines
3.5 KiB
Markdown
Installing ArangoDB on macOS
|
|
============================
|
|
|
|
ArangoDB under macOS can be installed via:
|
|
|
|
1. [Homebrew](#homebrew)
|
|
2. [_DMG_ Package](#package-installation)
|
|
3. [_tar.gz_ Archive](#installing-using-the-archive) (starting from v3.4.0)
|
|
|
|
Homebrew
|
|
--------
|
|
|
|
{% hint 'info' %}
|
|
When installing ArangoDB via the macOS package manager Homebrew,
|
|
only the Community Edition is available.
|
|
{% endhint %}
|
|
|
|
{% hint 'warning' %}
|
|
The Homebrew installation is updated a few days after the
|
|
official release of a new version.
|
|
{% endhint %}
|
|
|
|
If you are using [_homebrew_](http://brew.sh/),
|
|
then you can install the latest released stable version of 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/Cellar/arangodb/3.4.0/sbin/arangod
|
|
```
|
|
|
|
You can start the server by running the command `/usr/local/Cellar/arangodb/3.4.0/sbin/arangod &`.
|
|
|
|
Configuration file is located at
|
|
|
|
/usr/local/etc/arangodb3/arangod.conf
|
|
|
|
The ArangoDB shell will be installed as:
|
|
|
|
```
|
|
/usr/local/Cellar/arangodb/3.4.0/bin/arangosh
|
|
```
|
|
|
|
You can uninstall ArangoDB using:
|
|
|
|
```
|
|
brew uninstall arangodb
|
|
```
|
|
|
|
However, in case you started ArangoDB using the _launchctl_, 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
|
|
```
|
|
|
|
{% hint 'tip' %}
|
|
If the latest ArangoDB version is not shown in Homebrew, you
|
|
also need to update Homebrew executing the command `brew update`.
|
|
{% endhint %}
|
|
|
|
### Known issues
|
|
|
|
- The ArangoDB Starter is not included in v3.3.x, but shipped with all 3.4.x versions.
|
|
- The Commandline argument parsing does not accept blanks in filenames; the CLI version below does.
|
|
- If you need to change server endpoint while starting _homebrew_ version, you can edit arangod.conf
|
|
file and uncomment line with endpoint needed, e.g.:
|
|
|
|
[server]
|
|
endpoint = tcp://0.0.0.0:8529
|
|
|
|
Package Installation
|
|
--------------------
|
|
|
|
We provide a command-line app called *ArangoDB-CLI*.
|
|
Visit the official [Download](https://www.arangodb.com/download) page of the
|
|
ArangoDB website and download the *DMG* Package for macOS.
|
|
|
|
You can install the application in your application folder.
|
|
|
|
Starting the application will start the server and open a terminal window
|
|
showing you the log-file.
|
|
|
|
ArangoDB server has been started
|
|
|
|
The database directory is located at
|
|
'/Users/<user>/Library/ArangoDB/var/lib/arangodb3'
|
|
|
|
The log file is located at
|
|
'/Users/<user>/Library/ArangoDB/var/log/arangodb3/arangod.log'
|
|
|
|
You can access the server using a browser at 'http://127.0.0.1:8529/'
|
|
or start the ArangoDB shell
|
|
'/Applications/ArangoDB3-CLI.app/Contents/Resources/arangosh'
|
|
|
|
Switching to log-file now, killing this windows will NOT stop the server.
|
|
|
|
|
|
2018-03-16T09:37:01Z [13373] INFO ArangoDB (version 3.3.4 [darwin]) is ready for business. Have fun!
|
|
|
|
Note that it is possible to install both, the _homebrew_ version and the command-line
|
|
app. You should, however, edit the configuration files of one version and change
|
|
the port used.
|
|
|
|
Installing using the archive
|
|
----------------------------
|
|
|
|
Starting from v3.4.0 a _tar.gz_ package is also available for macOS.
|
|
|
|
Visit the official [Download](https://www.arangodb.com/download) page of the ArangoDB
|
|
website and download the _tar.gz_ archive for macOS.
|
|
|
|
To install, just extract the archive.
|