Preliminary Information

For Debian/Ubuntu Systems

Use a different configuration file for the Cluster instance

The configuration file used for the standalone instance is/etc/arangodb3/arangod.conf (on Linux), and you should use a different one forthe cluster instance(s). If you are using the Starter binary arangodb, that isautomatically the case. Otherwise, you might have to copy the configurationsomewhere else and pass it to your arangod cluster instance via—configuration.

Use a different data directory for the standalone instance

The data directory is configured in arangod.conf:

  1. [database]
  2. directory = /var/lib/arangodb3

You have to make sure that the Cluster instance uses a different data directoryas the standalone instance. If that is not already the case, change thedatabase.directory entry in arangod.conf as seen above to a differentdirectory

  1. # in arangod.conf:
  2. [database]
  3. directory = /var/lib/arangodb3.standalone

and create it with the correct permissions:

  1. $ mkdir -vp /var/lib/arangodb3.standalone
  2. $ chown -c arangodb:arangodb /var/lib/arangodb3.standalone
  3. $ chmod -c 0700 /var/lib/arangodb3.standalone

Use a different socket for the standalone instance

The standalone instance must use a different socket, i.e. it cannot use thesame port on the same network interface than the Cluster. For that, change thestandalone instance’s port in /etc/arangodb3/arangod.conf

  1. [server]
  2. endpoint = tcp://127.0.0.1:8529

to something unused, e.g.

  1. [server]
  2. endpoint = tcp://127.1.2.3:45678

.

Use a different init script for the Cluster instance

This section applies to SystemV-compatible init systems (e.g. sysvinit, OpenRC,upstart). The steps are different for systemd.

The package install scripts use the default init script /etc/init.d/arangodb3(on Linux) to stop and start ArangoDB during the installation. If you are usingan init script for your Cluster instance, make sure it is named differently.In addition, the installation might overwrite your init script otherwise.

If you have previously changed the default init script, move it out of the way

  1. $ mv -vi /etc/init.d/arangodb3 /etc/init.d/arangodb3.cluster

and add it to the autostart; how this is done depends on your distribution andinit system. On older Debian and Ubuntu systems, you can use update-rc.d:

  1. $ update-rc.d arangodb3.cluster defaults

Make sure your init script uses a different PIDFILE than the default script!