h1. Cluster Ganeti

{{>toc}}

h2. Installation from scratch

h3. Ganeti

apt-get install ganeti2

h2. config LVM DRBD

/etc/lvm/lvm.conf

changer le filter lvm dans /etc/lvm/lvm.conf pour

<pre>

# filter = [ "a/.*/" ]

filter = ["r|/dev/cdrom|", "r|/dev/drbd[0-9]+|" ]

</pre>

Evite les soucis avec DRBD

h2. DRBD

* activer drbd

<pre>

# echo "option drbd minor_count=128 usermode_helper=/bin/true" >> /etc/modprobe.d/drbd-ganeti.conf

# rmmod drbd

# modprobe drbd

# cat /sys/module/drbd/parameters/usermode_helper 

/bin/true

</pre>

h2. Partition

* fdisk et LVM

<pre>

fdisk /dev/sda

new primary part

hex code 8e

</pre>

partprobe

pvcreate /dev/sda2 

vgcreate vg_ganeti /dev/sda2

S'il existe deja vider le volume group et le recreer

<pre>

pvs

vgs

lvs

lvremove

vgcreate kvmvg /dev/sdb... #TODO check

</pre>

h3. Network

<pre>

# dans /etc/network/interfaces

# The primary network interface

auto eth0

iface eth0 inet manual

# dans /etc/rc.local     

ip l set eth0 up    

brctl addbr ganeti-br0

ip li set ganeti-br0 up

brctl addif ganeti-br0 eth0

ip a a 10.42.0.13/24 dev ganeti-br0

ip r a default via 10.42.0.1 

</pre>

h3. DNS

<pre>

# Dans /etc/hosts              

10.42.0.10 tmaster.thsf tmaster

10.42.0.11 t1.thsf t1     

10.42.0.12 t2.thsf t2

10.42.0.13 t3.thsf t3

</pre>

h3. Ganeti Service

On master

<pre>

gnt-cluster init --nic-parameters mode=bridged,link=ganeti-br0 --master-netdev=ganeti-br0 \                       

 --vg-name vg_ganeti --enabled-hypervisors=kvm tmaster.thsf

# to add second machine

gnt-node add t2

# add sid

root@t3:~# cat /etc/apt/sources.list

# deb http://ftp2.fr.debian.org/debian/ wheezy main

deb http://ftp2.fr.debian.org/debian/ wheezy main

deb-src http://ftp2.fr.debian.org/debian/ wheezy main

deb http://security.debian.org/ wheezy/updates main

deb-src http://security.debian.org/ wheezy/updates main

deb http://ftp2.fr.debian.org/debian/ sid main

deb-src http://ftp2.fr.debian.org/debian/ sid main

root@t3:~# cat /etc/apt/preferences

Package: *

Pin: release a=unstable

Pin-priority: 10

# to create vm

apt-get install ganeti-htools ganeti ganeti-instance-debootstrap

#/etc/hosts

10.42.0.101 vm1.thsf vm1

gnt-cluster copyfile /etc/hosts

gnt-instance add -H kernel_path=/boot/vmlinuz-3.2.0-2-amd64,initrd_path=/boot/initrd.img-3.2.0-2-amd64 \

-t drbd -B memory=512M,vcpus=1 --disk 0:size=5G -I hail -o debootstrap+default vm1.thsf

</pre>

h2. Administration des VMs

h3. Demarrer et arrêter une instance ?

<pre>

gnt-instance start vm1

gnt-instance stop vm1

</pre>

h3. Comment tout savoir sur une vm ?

<pre>

gnt-instance info vm1

</pre>

h3. Déplacement le(s) disque(s) dur d'une VM

Si la machine a ces disques au format plain (sans drbd), taper:

<pre>

gnt-instance stop vm1

gnt-instance move -n h6 vm1

gnt-instance start vm1

</pre>

Si la machine utilise drbd (uniquement le disque de la node secondaire bascule):

<pre>

gnt-instance replace-disks -n h6 vm1

</pre>

Si vous voulais déplacer l'autre disque du drbd, il faut basculer la machine, puis refaire la même chose

h3. Basculer/migrer une machine qui utilise drbd

Bascule avec arret de la machine:

<pre>

gnt-instance failover vm1

</pre>

Sans arrêt, migration à chaud:

<pre>

gnt-instance migrate vm1

</pre>

En cas de soucis primaire/secondaire:

<pre>

gnt-instance migrate --cleanup vm1

</pre>

h3. Création d'une machine

Un script est présent sur h1 voici ca doc:

<pre>

# /root/gnt-addvm

usage: gnt-addvm [options] VIRTUAL_MACHINE_HOSTNAME

       -o OS | --os OS          OS can be default natty32 natty64 sid64 squeeze32 squeeze64 wheezy64

       -s SIZE | --size SIZE    default SIZE is 10G

       -m MEM | --mem MEM       default MEM is 256M

       -c CPU | --cpu CPU               default CPU is 1

       -n NODES | --nodes NODES         default NODES is

       -d MODE | --disk MODE      default MODE is drbd

       -q | --quick             don't wait drbd sync

       --dry-run                        show executed command

       --cdrom PATH             installation from iso file

</pre>

h3. Supprimer une machine

<pre>

gnt-instance remove vm1

</pre>

si la vm est en drbd et que une des nodes du drbd ne fonctionne plus

<pre>

gnt-instance remove --ignore-failures vm1

</pre>

h3. Changer les cractéristique d'une VM, upgrade disk, net, cpu, mem

Et hop une nouvelle carte réseau sur le vlan tsf

<pre>

gnt-instance  modify --net add:link=br1 vm1

</pre>

Un petit disk en plus

<pre>

gnt-instance  modify --disk add:size=50G vm1

</pre>

Un petite upgrade cpu et mémoire

<pre>

gnt-instance modify -B vcpus=2,memory=512M vm1

</pre>

Reboot pour prendre en compte le tout

<pre>

gnt-instance reboot -t full vm1

</pre>

== Je voudrais bien booter mon kernel ! ou un cdrom==

Je peux désactivé le kernel commun pour une vm

<pre>

gnt-instance modify -H kernel_path="" vm1

</pre>

Ou booter sur le cdrom pour le prochain démarrage commme ceci:

<pre>

gnt-instance start -H boot_order=cdrom,cdrom_image_path=/path/to/debian-504-amd64-netinst.iso vm1

</pre>

h3. Relocalisé les disques secondaires si un serveur est HS.

Ceci déplace le disque redondant (qui n'est plus présent si le serveur est HS) est le reconstruit sur un autre serveur

<pre>

gnt-instance replace-disks -I hail vm1

</pre>

h3. Importer une image disque venant de l’extérieur

Convertion de l'image au format raw (si c'est pas déjà le cas)

<pre>

kvm-img convert DISQUEVM.qcow -O raw DISQUEVM.raw

</pre>

Copie du disque au format raw sur un lvm

<pre>

size=$(kvm-img info DISQUEVM.raw | sed -n -e 's/^virtual size:[^(]*(\([[:digit:]]*\).*)/\1/gp')

lvcreate -L ${size}b -n lv_migration_DISQUEVM kvmvg

dd if=DISQUEVM.raw of=/dev/kvmvg/lv_migration_DISQUEVM

</pre>

Création de la VM

<pre>

gnt-instance add -B memory=512M --no-start -t plain -n $(hostname) --disk 0:adopt=lv_migration_DISQUEVM --net 0 -o debootstrap+default VMNAME.tetaneutral.net

</pre>

Et pour finir, on transforme le format de disque de la VM en drbd:

<pre>

gnt-instance modify -t drbd -n h6 VMNAME.tetaneutral.net

</pre>

h3. Copier une VM sur une autre machine

Seul la machine *h1* a l'espace configurer pour faire des dumps de machine virtuelle.

On lance un backup de celle-ci (attention cette commande *éteint* la machine):

<pre>

gnt-backup export -n h1 sileht2

</pre>

Les fichiers sont ensuite sur h1 dans /exports/sileht2.tetaneutral.net/

Le fichier qui nous intéresse est celui qui fini par *.snap* qui est le disque dur au format raw de la VM, dans mon cas:

<pre>

09d836a0-22e0-4ea4-9104-c301351bb2e2.disk0_data.snap

</pre>

Pour la démonstration je copie ce fichier sur h2:

<pre>

scp /exportfs/sileht2.tetaneutral.net/09d836a0-22e0-4ea4-9104-c301351bb2e2.disk0_data.snap h2:/root/sileht.raw

</pre>

Et je le test avec kvm:

<pre>

kvm -m 256 -drive file=sileht.raw,format=raw,if=virtio,boot=on,cache=writeback -usbdevice tablet -netdev type=tap,id=netdev0,fd=10 -device virtio-net-pci,mac=aa:00:00:62:e3:a0,netdev=netdev0

</pre>

A savoir l'image utilise les pilotes kvm "virtio", si on souhaite utiliser la VM avec un autre logiciel de virtualisation,

il faudra modifié le fstab pour mettre /dev/sda1 au lieu de /dev/vda1 et supprimer le fichier /etc/udev/rules.d/70-persistent-net.rules

h3. Monter une partition de machine virtuelle sur la machine hôte (!Attention DANGER!)

Arret de la machine et activation des disques

<pre>

 $ gnt-instance stop VMNAME.tetaneutral.net

 $ gnt-instance activate-disks VMNAME.tetaneutral.net

 h1.tetaneutral.net:disk/0:/dev/drbd34

</pre>

Ensuite pour voir les partitions du disque, ici le /dev/drbd34:

<pre>

kpartx -l /dev/drbd34

</pre>

On créé ensuite les partitions dans /dev avec devmapper

<pre>

kpartx -a /dev/drbd34

ls -la /dev/mapper/drbd34*

</pre>

A partir de maintenant on peut faire mumuse avec la partition, exemple:

<pre>

mount /dev/mapper/drbd34p1 /mnt/

....

umount /mnt

</pre>

Puis *très important*, il faut nettoyer devmapper et déactiver les disk pour ganeti

<pre>

kpartx -d /dev/drbd34

gnt-instance deactivate-disks VMNAME.tetaneutral.net

gnt-instance start VMNAME.tetaneutral.net

</pre>

h2. Administration des serveurs/nodes

h3. Éteindre/rebooter provisoirement un des serveurs sans coupure de service

La procédure est la suivante:

 - migration des machines virtuelles sur leurs secondaires

 - Arret/Ralummage ou reboot du serveur

 - remigration des machines virtuelles sur le serveur hX

<pre>

gnt-node migrate hX

shutdown -h now # ou reboot

hbal -L --no-disk-moves -X

</pre>

La resynchro drbd est automatique.

h3. L'extinction d'une node proprement dans le but de la désactivé du cluster

<pre>

gnt-node migrate hX # gnt-node failover hX

gnt-node evacuate -I hail hX

gnt-node modify -O yes hX

</pre>

Ici toutes les VMs seront migrés et les données auront été déplacé vers les autres nodes.

h3. Vérifier l'état du cluster

Sur le masternode normalement h1 faire:

<pre>

gnt-cluster verify

</pre>

h3. Change le node principal (masternode) de "ganeti", celui qui permet de lancer des commandes ganeti.

Allez sur un node, taper ceci et il deviendra "maternode":

<pre>

gnt-node masterfailover

</pre>

h3. Gestion des fichiers de configuration (ie: /etc/ganeti, /etc/hosts, /etc/rc.local, ...)

Tous les fichiers de configuration à synchroniser entre toutes les nodes du cluster sont contenues dans ce script:

<pre>

/etc/ganeti/pushconf.sh

</pre>

Le lancer recopie ces fichiers du masternode vers les autres nodes.

h3. Désactiver un serveur qui serait HS du cluster provisoirement.

On bascule les machines qui n'ont pas le failover en automatique

<pre>

gnt-node failover [ --ignore-consistency ] h2

</pre>

le --ignore-consistency permet de forcer ganeti à ne pas contrôler le disk avant le basculement

On peux (optionnellement) déplacer les disques durs secondaires des VMs

gnt-node evacuate [--early-release]  -I hail hX

le --early-release permet de forcer ganeti à ne pas contrôler le disk avant le basculement (utile si le disk de h2 est HS)

Puis on désactive la node:

<pre>

gnt-node modify -O yes h2

</pre>

h3. Réinsertion dans le cluster d'un node désactivé

- On réactive la node

- On remet dessus des machines et des disques en répartissant la charge du cluster

<pre>

gnt-node modify -O no h2

hbal -L -X

</pre>

h2. Setup d'un nouveau NODE

h3. Installation

* Installer squeeze basique avec juste ssh

* Ajouter wheezy dans /etc/apt/sources.list

<pre>

# deb http://ftp.fr.debian.org/debian/ squeeze main

deb http://ftp.fr.debian.org/debian/ squeeze main contrib non-free

deb-src http://ftp.fr.debian.org/debian/ squeeze main contrib non-free

deb http://ftp.fr.debian.org/debian/ sid main contrib non-free

deb-src http://ftp.fr.debian.org/debian/ sid main contrib non-free

deb http://ftp.de.debian.org/debian-backports/ squeeze-backports main contrib non-free

deb-src http://ftp.de.debian.org/debian-backports/ squeeze-backports main contrib non-free

deb http://security.debian.org/ squeeze/updates main

deb-src http://security.debian.org/ squeeze/updates main

# squeeze-updates, previously known as 'volatile'

deb http://ftp.fr.debian.org/debian/ squeeze-updates main

deb-src http://ftp.fr.debian.org/debian/ squeeze-updates main

</pre>

* Allouer un port avec 3131, 3175, 3195 tagged sur le procurve

* Monter le reseau manuellement IP X

<pre>

ip link add link eth0 name eth0.3131 type vlan id 3131

ip link set eth0.3131 up

ip addr add 91.224.149.15X/25 dev eth0.3131

</pre>

* Creer /etc/rc.local.conf avec X et Y

<pre>

IP_3131="91.224.149.15X/25"

GW_3131="91.224.149.254"

IP_3175="192.168.3.Y/24"

KVM_DISKS="sdb"

</pre>

* Installer les packages

<pre>

#TODO liste en fichier commit qqpart

#TODO: passer a une version compilée en local de ganeti pour eviter les update de version wheezy

dpkg --get-selections | ssh root@h48 dpkg --set-selections

ssh root@h48 apt-get dselect-upgrade

</pre>

* munin:

dans /etc/munin/munin-node.conf ajouter: allow ^91\.224\.149\.194$

* TODO patch munin Loic

http://trac.fsffrance.org/wiki/PatchInventory#Munin

* reboot

* Installer le node dans le cluster ganeti apres s'etre assure que la version de ganeti est bien la meme

<pre>

dpkg -l|grep -i ganeti

gnt-node add h48

/etc/ganeti/pushconf.sh

</pre>

Appliquer ce patch à ganeti-instance-debootstrap:

<pre>

--- /usr/share/ganeti/os/debootstrap/common.sh.ori  2010-09-15 22:34:12.000000000 +0200

+++ /usr/share/ganeti/os/debootstrap/common.sh  2011-07-27 12:33:55.695617766 +0200

@@ -91,7 +91,7 @@

# some versions of sfdisk need manual specification of

# head/sectors for devices such as drbd which don't

# report geometry

-  sfdisk -H 255 -S 63 --quiet --Linux "$1" <<EOF

+  sfdisk -H 255 -S 63 -D --quiet --Linux "$1" <<EOF

0,,L,*

EOF

}

</pre>

Ci dessous ajouter dkms et r8168 si nécessaire.

h3. Pilotes additionnel

Sur h1,h2,h4,h5 et h6, le pilote (r8169.ko) de la carte réseau (r8168/8111) provoque des kernels panic, il a été remplacé la version du constructeur (r8168.ko).

Pilote dispo ici: (http://www.realtek.com/downloads/downloadsView.aspx?Langid=1&PNid=13&PFid=5&Level=5&Conn=4&DownTypeID=3&GetDown=false)

<pre>

apt-get install gcc dkms

cd /usr/src

wget http://url_to_pilot/r8168-8.024.00.tar.bz2

tar -xjf r8168-8.024.00.tar.bz2

cd r8168-8.024.00

cat > dkms.conf << EOF

PACKAGE_NAME=r8168

PACKAGE_VERSION=8.024.00

MAKE[0]="make"

BUILT_MODULE_NAME[0]=r8168

BUILT_MODULE_LOCATION[0]="src/"

DEST_MODULE_LOCATION[0]="/kernel/updates/dkms"

AUTOINSTALL="YES"

EOF

dkms add -m r8168 -v 8.024.00

dkms build -m r8168 -v 8.024.00

dkms install -m r8168 -v 8.024.00

echo "r8168" >> /etc/modules

echo "blacklist r8169" >> /etc/modprobe.d/blacklist-network.conf

update-initramfs -u

reboot

</pre>

Pour les machines a base de e1000e:

<pre>

apt-get install gcc dkms

cd /usr/src

wget http://downloadmirror.intel.com/15817/eng/e1000e-1.3.17.tar.gz

tar -xzf e1000e-1.3.17.tar.gz

cd e1000e-1.3.17

cat > dkms.conf << EOF

PACKAGE_NAME=e1000e

PACKAGE_VERSION=1.3.17

CLEAN="make -C src/ clean"

MAKE[0]="make -C src/"

BUILT_MODULE_NAME[0]=e1000e

BUILT_MODULE_LOCATION[0]="src/"

DEST_MODULE_LOCATION[0]="/kernel/updates/dkms"

AUTOINSTALL="YES"

EOF

dkms add -m e1000e -v 1.3.17

dkms build -m e1000e -v 1.3.17

dkms install -m e1000e -v 1.3.17

reboot

</pre>

h2. Annexe 

h3. Configuration réseau

le script /etc/rc.local, qui s'occupe de préparer la configuration réseaux pour ganeti (avec les vlan, bridge and co)

le script /etc/rc.local.conf, contient les adresses IP de la machine et les gw

h3. Protection VNC

Le VNC de kvm est utiliser sur chaque MV.

Des règles de firewall sont automatiquement mise en place par le script /etc/ganeti/vnc-firewall pour que seul la machine gntwebmgr.tetaneutral.net soit autoriser a s'y connecter

Ce script est appelé par les hooks ganeti.

h3. Mac spoofing configuration (Actuellement désactivé)

Le script ifup de ganeti pour kvm a été modifier (ie: /etc/ganeti/kvm-vif-bridge) pour écrire la relation entre la vm, le numero de ces interfaces réseaux et ces tap.

Le fichier prends la forme suivante:

munin.tetaneutral.net:0:tap3

trac.tetaneutral.net:0:tap5

munin.tetaneutral.net:1:tap5

Les règles ebtables sont écrites par le script /etc/ganeti/spoofing/spoofing-protection avec les informations de ce fichier.

Les scripts de hook de ganeti (ie:/etc/ganeti/hook/) utilise ce script, pour lancer ou arreter le spoofing.

h3. Patch maison pour ganeti

Ajout de l'option -D à sfdisk au script /usr/share/ganeti/os/debootstrap/common.sh ligne 84 pour créer des partitions avec assez d'espace pour grub

Celui-ci est décrit dans l'installation d'une node aussi.

h3. J'ai n'est pas trouvé mon bonheur, comment je vais faire ?!

Voici quelques ressources:

* http://docs.ganeti.org/ganeti/current/html/

* http://docs.ganeti.org/ganeti/2.1/man/

* http://wiki.osuosl.org/public/ganeti/

Ou bien je demande à sileht d'écrire le use case qui me manque s'il à le temps