Starting an ArangoDB Cluster the Easy Way
ArangoDB now makes starting up a cluster a lot easier! In this post we take a look at how to start up an ArangoDB cluster the easy way.
Join the DZone community and get the full member experience.
Join For FreeRecently, we have gotten a lot of feedback about the fact that standing up an ArangoDB cluster “manually” is an awkward and error-prone affair. We have been aware of this for some time but always expected that most users running ArangoDB clusters would do so on Apache Mesos or DC/OS, where deployment is a breeze.
However, for various valid reasons, people do not want to use Apache Mesos and thus are back to square one with the problem of deploying an ArangoDB cluster without Apache Mesos.
So we have listened to this and have looked what other distributed databases offer, and have put together a tool called arangodb
(as opposed to arangod
) to help you. It essentially gives you the following experience:
You install ArangoDB in the usual way as a binary package. Then, on host A, simply do (in an empty directory):
arangodb
This will use port 4000 to wait for colleagues (three are needed for a resilient agency). On host B, (can be the same as A), you do:
arangodb--joinA
This will contact A on port 4000 and register. On host C (can be same as A or B), do:
arangodb--joinA
This will contact A on port 4000 and register.
From the moment that three have joined, each will fire up an agent, a coordinator, and a DBserver — and the cluster is up. Ports are shown on the console.
Additional servers can be added in the same way.
If two or more of the arangodb
instances run on the same machine, one has to use the --dataDir
option to let each use a different directory.
The arangodb
program will find the ArangoDB executable and the other installation files automatically.
So far, the tool is experimental, but it works on Linux, OSX, and Windows and even allows users to mix different operating systems. One should use ArangoDB 3.1.4 or higher for it. The code can be found in this GitHub repository. The README.md
contains building, installation, and usage instructions.
Please give it a try, we are curious about your opinion and are looking forward to your feedback, be it positive or negative. You can let us know what you think by opening an issue in the relevant GitHub repository.
If people like this, we might bundle it with the distribution and maybe even make it the default way to launch ArangoDB manually.
Published at DZone with permission of Max Neunhoeffer, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
Comments