Procedure-Systel/Docker/Dépannage/Augmenter espace disque.md

# Augmenter l'espace disque d'un volume LVM

Cette procédure concerne principalement l'espace utilisé par les données cartographiques. Elle décrit l'extension d'un volume logique (LV) à partir d'espace déjà disponible dans le volume de groupe (VG), l'agrandissement d'un disque existant ou l'ajout d'un nouveau disque.

> **Précaution :** vérifier les sauvegardes et prendre un snapshot de la VM avant toute modification du disque ou des partitions. Confirmer les noms du disque, de la partition PV, du VG et du LV sur la machine. Ne jamais réutiliser aveuglément les valeurs d'exemple.

## 1. Comprendre les éléments LVM

- Un disque physique ou une partition de disque peut servir de volume physique (PV).
- Un volume de groupe (VG) agrège un ou plusieurs PV.
- Un volume logique (LV) est créé dans un VG et porte un système de fichiers.
- Un point de montage donne accès au système de fichiers.

Dans l'exemple de la procédure source, le VG est `gluster-vg`, le LV cartographique est `gis` et son chemin est `/dev/mapper/gluster--vg-gis--lv`.

Pour l'environnement GlusterFS décrit dans la source, `/mnt/gis` et `/mnt/data` sont des points de montage réseau, tandis que `/gluster/gis` et `/gluster/data` correspondent aux systèmes de fichiers locaux adossés aux volumes logiques. Identifier le LV local concerné avant toute extension : ne pas passer un point de montage réseau à une commande LVM.

## 2. Diagnostiquer l'espace disponible

Vérifier le système de fichiers et l'espace utilisé :

```bash
df -hT
```

Examiner les disques, partitions et signatures :

```bash
lsblk -f
sudo fdisk -l
```

Afficher les PV, VG et LV :

```bash
sudo pvs
sudo vgs
sudo lvs
sudo pvdisplay
sudo vgdisplay
sudo lvdisplay
```

Le fichier `/etc/fstab` peut aider à faire correspondre les systèmes de fichiers aux points de montage :

```bash
cat /etc/fstab
```

Si `VFree`/l'espace libre du VG est suffisant, passer à la section 3. S'il n'y en a pas assez, choisir entre agrandir un disque existant (section 4) et ajouter un nouveau disque (section 5).

## 3. Étendre un LV avec l'espace libre du VG

Déterminer la taille à ajouter à partir de l'espace libre constaté et des besoins futurs. Ne pas utiliser une taille arbitrairement grande. La valeur `+500000G` présente dans la source est manifestement incorrecte et ne doit pas être utilisée.

Pour ajouter une taille définie, remplacer `TAILLE` par la quantité validée :

```bash
sudo lvresize --resizefs --size +TAILLE /dev/mapper/gluster--vg-gis--lv
```

Exemple de la source, ajout de 5 Go au LV cartographique :

```bash
sudo lvresize --resizefs --size +5G /dev/mapper/gluster--vg-gis--lv
```

Pour affecter tout l'espace libre du VG au LV, uniquement si cela est prévu et approuvé :

```bash
sudo lvresize --resizefs -l +100%FREE /dev/mapper/gluster--vg-gis--lv
```

Cette dernière commande ne laisse aucun espace libre dans le VG pour d'autres LV. Vérifier le chemin du LV et l'espace libre avant de l'exécuter.

## 4. Agrandir un disque existant

Cette méthode s'applique lorsque la capacité du disque virtuel a été augmentée dans l'hyperviseur et que le PV se trouve sur une partition existante.

### 4.1 Agrandir le disque virtuel et relire sa capacité

1. Après avoir pris un snapshot, augmenter la capacité du bon disque dans l'hyperviseur. Dans l'exemple source, l'augmentation est de 50 Go.
2. Vérifier que Linux voit la nouvelle taille :

```bash
sudo fdisk -l
lsblk
```

Dans l'exemple source, le disque passe de 50 à 100 Go, tandis que la partition reste encore à 50 Go.

### 4.2 Agrandir la partition PV

Identifier précisément le disque et le numéro de partition. Exemple source : partition 1 sur `/dev/sdb`.

```bash
sudo growpart -v /dev/sdb 1
```

Vérifier la nouvelle taille de la partition :

```bash
lsblk
```

### 4.3 Redimensionner le PV, puis le LV

Après l'agrandissement de la partition, redimensionner le PV pour que le VG détecte la capacité ajoutée. Exemple source :

```bash
sudo pvresize /dev/sdb1
sudo vgs
```

Vérifier que l'espace libre est apparu dans le VG, puis étendre le LV concerné. Exemple d'ajout de 50 Go au LV cartographique :

```bash
sudo lvresize --resizefs --size +50G /dev/mapper/gluster--vg-gis--lv
```

Remplacer `/dev/sdb1`, le chemin du LV et la taille par les valeurs réellement confirmées sur la VM.

## 5. Ajouter un nouveau disque au VG

Utiliser cette méthode si le VG ne dispose pas d'assez d'espace et qu'un nouveau disque doit être ajouté à la VM.

1. Ajouter le disque dans l'hyperviseur.
2. Vérifier son nom et sa capacité :

```bash
lsblk -f
sudo fdisk -l
```

3. Confirmer que le disque choisi est bien le nouveau disque et qu'il ne contient aucune donnée à conserver. La source utilise `/dev/sdc` comme exemple.
4. Créer le PV :

```bash
sudo pvcreate /dev/sdc
```

5. Ajouter le PV au VG concerné. Exemple source :

```bash
sudo vgextend gluster-vg /dev/sdc
```

6. Vérifier que le PV appartient au VG et que l'espace libre a augmenté :

```bash
sudo pvs
sudo vgdisplay gluster-vg
```

L'exemple source indique que le VG passe de 5 à 15 Go libres après l'ajout d'un disque de 10 Go. Ces valeurs sont illustratives.

7. Après avoir confirmé l'espace disponible, étendre le LV concerné. Exemple d'ajout de 10 Go :

```bash
sudo lvresize --resizefs --size +10G /dev/mapper/gluster--vg-gis--lv
```

## 6. Vérifier l'extension

Contrôler la taille du LV et l'espace du système de fichiers :

```bash
sudo pvs
sudo vgs
sudo lvs
sudo df -hT
lsblk
```

Confirmer que le point de montage local prévu affiche la nouvelle capacité et que les services concernés fonctionnent normalement.

> Si les données font partie d'un volume GlusterFS répliqué ou distribué, cette procédure ne décrit que l'extension locale du stockage. Vérifier la procédure d'exploitation GlusterFS pour déterminer les opérations à effectuer sur les autres nœuds et le volume Gluster.