mirror of https://gitee.com/bigwinds/arangodb
Doc - Installation refactor Linux (#7671)
This commit is contained in:
Simran
sleto-it
parent
32bc599a87
commit
48043c667e
|
|
@ -1,57 +1,51 @@
|
||||||
Linux
|
Installing ArangoDB on Linux
|
||||||
=====
|
============================
|
||||||
|
|
||||||
To install ArangoDB on Linux:
|
To install ArangoDB on Linux:
|
||||||
|
|
||||||
- Visit the official [Download](https://www.arangodb.com/download) page of the
|
1. Visit the official [Download](https://www.arangodb.com/download) page of the
|
||||||
ArangoDB web site and download the correct package for your Linux distribution.
|
ArangoDB web site and download the correct package for your Linux distribution.
|
||||||
You can find binary packages for the most common distributions there.
|
You can find binary packages for the most common distributions there. Linux Mint:
|
||||||
- Follow the instructions to use your favorite package manager for the
|
please use the corresponding Ubuntu or Debian packages.
|
||||||
major distributions. After setting up the ArangoDB repository you can
|
2. Follow the installation instructions on the _Download_ page to use your
|
||||||
easily install ArangoDB using _yum_, _aptitude_, _urpmi_ or _zypper_.
|
favorite package manager for the major distributions. After setting up the ArangoDB
|
||||||
- Debian based packages will ask for a password during installation. For an
|
repository you can easily install ArangoDB using _yum_, _aptitude_, _urpmi_ or _zypper_.
|
||||||
unattended installation for Debian, see [below](#unattended-installation).
|
|
||||||
Red-Hat based packages will set a random password during installation.
|
|
||||||
For other distributions or to change the password, run
|
|
||||||
`arango-secure-installation` to set a root password.
|
|
||||||
- Alternatively, see [Compiling](Compiling.md) if you want to build ArangoDB
|
|
||||||
yourself.
|
|
||||||
|
|
||||||
After installation, the ArangoDB Server can be started with a command like the
|
{% hint 'info' %}
|
||||||
following:
|
In addition to installation packages (distribution dependent) a `tar.gz` archive
|
||||||
|
is available starting from version 3.4.0.
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
unix> /etc/init.d/arangod start
|
After installation, you may start ArangoDB in several ways. The exact start-up command
|
||||||
|
depends on your Linux distribution, as well as on the type of ArangoDB deployment you
|
||||||
|
are interested in (_Single Server_, _Master-Slave_, _Active Failover_, _Cluster_, _DC2DC_).
|
||||||
|
|
||||||
The above command will start the server, and do that as well at system boot time.
|
Please refer to the [_Deployment_](../Deployment/README.md) chapter for details.
|
||||||
|
|
||||||
To stop the server you can use the following command:
|
Securing your Installation
|
||||||
|
--------------------------
|
||||||
|
|
||||||
unix> /etc/init.d/arangod stop
|
### Debian / Ubuntu
|
||||||
|
|
||||||
The exact commands depend on your Linux distribution.
|
Debian based packages will ask for a password during installation.
|
||||||
You may require root privileges to execute these commands.
|
|
||||||
|
|
||||||
Linux Mint
|
#### Securing Unattended Installations on Debian
|
||||||
----------
|
|
||||||
|
|
||||||
Please use the corresponding Ubuntu or Debian packages.
|
For unattended installations, you can set the password using the
|
||||||
|
[debconf helpers](http://www.microhowto.info/howto/perform_an_unattended_installation_of_a_debian_package.html):
|
||||||
Unattended Installation
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
Debian based package will ask for a password during installation.
|
|
||||||
For unattended installation, you can set the password using the
|
|
||||||
[debconf helpers](http://www.microhowto.info/howto/perform_an_unattended_installation_of_a_debian_package.html).
|
|
||||||
|
|
||||||
```
|
```
|
||||||
echo arangodb3 arangodb3/password password NEWPASSWORD | debconf-set-selections
|
echo arangodb3 arangodb3/password password NEWPASSWORD | debconf-set-selections
|
||||||
echo arangodb3 arangodb3/password_again password NEWPASSWORD | debconf-set-selections
|
echo arangodb3 arangodb3/password_again password NEWPASSWORD | debconf-set-selections
|
||||||
```
|
```
|
||||||
|
|
||||||
The commands should be executed prior to the installation.
|
The commands above should be executed prior to the installation.
|
||||||
|
|
||||||
Red-Hat based packages will set a random password during installation.
|
### Red-Hat / CentOS
|
||||||
If you want to force a password, execute
|
|
||||||
|
Red-Hat based packages will set a random password during installation. The generated
|
||||||
|
random password is printed during the installation. Please write it down somewhere,
|
||||||
|
or change it to a password of your choice by executing:
|
||||||
|
|
||||||
```
|
```
|
||||||
ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arango-secure-installation
|
ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arango-secure-installation
|
||||||
|
|
@ -59,43 +53,11 @@ ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arango-secure-installation
|
||||||
|
|
||||||
The command should be executed after the installation.
|
The command should be executed after the installation.
|
||||||
|
|
||||||
Non-Standard Installation
|
### Other Distributions
|
||||||
-------------------------
|
|
||||||
|
|
||||||
If you compiled ArangoDB from source and did not use any installation
|
For other distributions run `arango-secure-installation` to set a _root_ password.
|
||||||
package – or using non-default locations and/or multiple ArangoDB
|
|
||||||
instances on the same host – you may want to start the server process
|
|
||||||
manually. You can do so by invoking the arangod binary from the command
|
|
||||||
line as shown below:
|
|
||||||
|
|
||||||
```
|
{% hint 'danger' %}
|
||||||
unix> /usr/local/sbin/arangod /tmp/vocbase
|
Please be aware that running `arango-secure-installation` on your ArangoDB Server will remove
|
||||||
20ZZ-XX-YYT12:37:08Z [8145] INFO using built-in JavaScript startup files
|
all current database users but root.
|
||||||
20ZZ-XX-YYT12:37:08Z [8145] INFO ArangoDB (version 1.x.y) is ready for business
|
{% endhint %}
|
||||||
20ZZ-XX-YYT12:37:08Z [8145] INFO Have Fun!
|
|
||||||
```
|
|
||||||
|
|
||||||
To stop the database server gracefully, you can
|
|
||||||
either press CTRL-C or by send the SIGINT signal to the server process.
|
|
||||||
On many systems this can be achieved with the following command:
|
|
||||||
|
|
||||||
unix> kill -2 `pidof arangod`
|
|
||||||
|
|
||||||
|
|
||||||
Once you started the server, there should be a running instance of *_arangod_* -
|
|
||||||
the ArangoDB database server.
|
|
||||||
|
|
||||||
unix> ps auxw | fgrep arangod
|
|
||||||
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
|
|
||||||
|
|
||||||
2012-12-03T11:35:29Z [12882] ERROR Database directory version (1) is lower than server version (1.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.
|
|
||||||
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 server
|
|
||||||
in a shell, you should see errors logged there as well.
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue