3.0 KiB
Stir up your ArangoDB Cluster
Setting up a cluster can be intimidating task. You have to deal with firewalls, ports, different types of machines, and the like. ArangoDB is prepared to deal with all kinds of different setups and requirements.
However, in the following section we concentrate on a standard setup and show you, how to build a ArangoDB cluster within minutes. If you want to dive deeper into the nasty details, you should read LINK.
Development Scenario
While not really relevant for a prodution environment, a common setup for development is to create a cluster on a single maschine. This is the easiest of all setups and you should be ready to play with a ArangoDB cluster in less than a minute. Even when developing it is convenient to create a cluster on a single machine instead of having to deal with a lot of servers.
###Step 1: Install ArangoDB
We assume that you are using a Debian 7.0 system to run ArangoDB. For other operation systems, checkout our @S_EXTREF_S{https://www.arangodb.org/download,download page} and follow the instructions given there.
Run the following as root:
echo 'deb http://www.arangodb.org/repositories/arangodb2/Debian_7.0/ /' >> /etc/apt/sources.list.d/arangodb.list
apt-get update
apt-get install arangodb
You have now installed ArangoDB on your system. By default, ArangoDB runs in standalone mode.
###Step 2: Enable the Cluster mode
In order to enable the cluster mode, edit the configuration file as root
vi /etc/arangodb/arangod.conf
and change the lines
[cluster]
disable-dispatcher-kickstarter = yes
disable-dispatcher-frontend = yes
to
[cluster]
disable-dispatcher-kickstarter = no
disable-dispatcher-frontend = no
Save and restart
/etc/init.d/arangodb restart
###Setp 3: Setup your Cluster
You can now configure your cluster. A cluster consists of a number of database server and coordinators. A database servers holds you precious data, while a coordinator talks to the outside worlds, takes requests from clients, distributes them to database server and assembles the result.
For this example, we assume that are creating three database servers and two coordinators.
Use your favorite web browser and go to
http://localhost:8529/
You will now see the cluster management frontend.
Select Single Machine scenario. The next page allows you to enter
the number of coordinators and database servers.
Press Launch Cluster to fire up the cluster. That's it. Your cluster
is up and running.
###Step 4: Test your Cluster
Click on one of the coordinators (e. g. "Claus") to access your
cluster. In order to create a sharded collection, use Tools / JS Shell and execute
JSH> db._create("users", { numberOfShards: 3 });
JSH> db.users.save({ _key: "cmeier", firstName: "Claus", lastName: "Meier" });
Congratulations! You have created your first sharded collection and stored a document in it.