Installing Disco System-Wide

Install From Source

Note: On FreeBSD, replace all of the instances of make with gmake.

Assuming you have already gotten Disco running out of the source directory, as described in Install Disco, to install system-wide, just run make install as root:

make install

This will build and install the Disco master to your system (see the Makefile for exact directory locations). You can specify DESTDIR and prefix, in compliance with GNU make.

On systems that are intended to function as Disco worker nodes only, you can use the make install-node target instead.

System Settings

make install installs a configuration file to /etc/disco/settings.py that is tuned for clusters, not a single machine.

By default, the settings assume that you have at least three nodes in your cluster, so DDFS can use three-way replication. If you have fewer nodes, you need to lower the number of replicas in /etc/disco/settings.py:

DDFS_TAG_MIN_REPLICAS=1
DDFS_TAG_REPLICAS=1
DDFS_BLOB_REPLICAS=1

Most likely you do not need to modify anything else in this file right now, but you can change the settings here, if the defaults are not suitable for your system.

See disco.settings for more information.

Creating a disco user

You can use any account for running Disco, however it may be convenient to create a separate disco user. Among other advantages, this allows setting resource utilization limits for the disco user (through limits.conf or similar mechanism).

Since Disco places no special requirements on the user, (except access to certain ports and the ability to execute and read its files), simply follow the guidelines of your system when it comes to creating new users.

Keeping Disco Running

You can easily integrate disco into your system’s startup sequence. As an example, you can see how disco-master.init is implemented in Disco’s debian packaging.

Configuring DDFS Storage

On the Disco nodes, DDFS creates by default a subdirectory named vol0 under the DDFS_DATA directory to use for storage. If you have one or more dedicated disks or storage areas you wish to use instead, you can mount them under the directory specified by DDFS_DATA as subdirectories named vol0, vol1 and so on.