V2.1.0 User Manual

From Kerrighed

This page describes how to use Kerrighed operating system.

[edit] Presentation

Kerrighed is modified version of Linux. Hence using it should'nt be more complicated that using a Linux box. Furthermore, a Kerrighed box can be used as a standalone node then join a cluster, then leave it, etc.

[edit] Enable/Disable Kerrighed services

Kerrighed services are provided by the Kerrighed module (kerrighed.ko). For convenience, a script in /etc/init.d/kerrighed is provided to load the module at boottime if configured in /etc/default/kerrighed.

• The /etc/init.d/kerrighed can take one argument amongst 4:

/etc/init.d/kerrighed start            # Load the module
/etc/init.d/kerrighed stop             # Unload the module
/etc/init.d/kerrighed restart          # Re-load the module
/etc/init.d/kerrighed status           # Check if module is loaded

• The file /etc/default/kerrighed configure above script behaviour:

# If true, enable Kerrighed module loading
ENABLE=true
#ENABLE=false 

[edit] Start/stop the cluster

There are two ways of starting a Kerrighed cluster, one automatic and one manually.

[edit] Automatic method

In /etc/kerrighed_nodes, you can set the nbmin value to the number or required nodes to start automatically the cluster. For instance, if nbmin=4, the cluster will start as soon as 4 Kerrighed-enabled nodes are started.

[edit] Manual method

If you don't set nbmin, you must use the krgadm command to start the cluster.