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:
|
||||
|
||||
- Visit the official [Download](https://www.arangodb.com/download) page of the
|
||||
ArangoDB web site and download the correct package for your Linux distribution.
|
||||
You can find binary packages for the most common distributions there.
|
||||
- Follow the instructions to use your favorite package manager for the
|
||||
major distributions. After setting up the ArangoDB repository you can
|
||||
easily install ArangoDB using _yum_, _aptitude_, _urpmi_ or _zypper_.
|
||||
- Debian based packages will ask for a password during installation. For an
|
||||
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
|
||||
following:
|
||||
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.
|
||||
You can find binary packages for the most common distributions there. Linux Mint:
|
||||
please use the corresponding Ubuntu or Debian packages.
|
||||
2. Follow the installation instructions on the _Download_ page to use your
|
||||
favorite package manager for the major distributions. After setting up the ArangoDB
|
||||
repository you can easily install ArangoDB using _yum_, _aptitude_, _urpmi_ or _zypper_.
|
||||
|
||||
unix> /etc/init.d/arangod start
|
||||
|
||||
The above command will start the server, and do that as well at system boot time.
|
||||
{% hint 'info' %}
|
||||
In addition to installation packages (distribution dependent) a `tar.gz` archive
|
||||
is available starting from version 3.4.0.
|
||||
{% endhint %}
|
||||
|
||||
To stop the server you can use the following command:
|
||||
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_).
|
||||
|
||||
unix> /etc/init.d/arangod stop
|
||||
Please refer to the [_Deployment_](../Deployment/README.md) chapter for details.
|
||||
|
||||
The exact commands depend on your Linux distribution.
|
||||
You may require root privileges to execute these commands.
|
||||
Securing your Installation
|
||||
--------------------------
|
||||
|
||||
Linux Mint
|
||||
----------
|
||||
### Debian / Ubuntu
|
||||
|
||||
Please use the corresponding Ubuntu or Debian packages.
|
||||
Debian based packages will ask for a password during installation.
|
||||
|
||||
Unattended Installation
|
||||
-----------------------
|
||||
#### Securing Unattended Installations on Debian
|
||||
|
||||
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).
|
||||
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):
|
||||
|
||||
```
|
||||
echo arangodb3 arangodb3/password 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.
|
||||
If you want to force a password, execute
|
||||
### Red-Hat / CentOS
|
||||
|
||||
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
|
||||
|
|
@ -59,43 +53,11 @@ ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arango-secure-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
|
||||
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:
|
||||
For other distributions run `arango-secure-installation` to set a _root_ password.
|
||||
|
||||
```
|
||||
unix> /usr/local/sbin/arangod /tmp/vocbase
|
||||
20ZZ-XX-YYT12:37:08Z [8145] INFO using built-in JavaScript startup files
|
||||
20ZZ-XX-YYT12:37:08Z [8145] INFO ArangoDB (version 1.x.y) is ready for business
|
||||
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.
|
||||
{% hint 'danger' %}
|
||||
Please be aware that running `arango-secure-installation` on your ArangoDB Server will remove
|
||||
all current database users but root.
|
||||
{% endhint %}
|
||||
|
|
|
|||
Loading…
Reference in New Issue