> Source: https://docs.cyberelements.io/bastion/4.6/fr/HowTo/ExtendVirtualApplianceDiskSpace/

# Étendre l'espace disque d'une appliance virtuelle

Les appliances virtuelles se remplissent : enregistrements, archives, bases de données et journaux s'accumulent sur les partitions qui les portent. Cette page étend l'une de ces partitions pour qu'elle occupe tout l'espace disponible sur le disque — sur un **Mediation Controller** ou sur une **Edge Gateway**.

L'opération se mène normalement **à chaud, sans impact sur la production**.

> **Une condition, et elle n'est pas négociable**
>
> Les commandes ci-dessous supposent la **disposition des disques et le partitionnement livrés avec l'appliance**. Si les disques ou le partitionnement de cette machine virtuelle ont été **modifiés à la main**, elles ne s'appliquent pas : elles suppriment et recréent une partition, et le feraient à partir d'hypothèses qui ne sont plus vraies. Dans ce cas, contactez le support CyberElements plutôt que d'adapter les commandes vous-même.
>
> **Une seule modification est tolérée : celle que cette procédure a elle-même déjà faite.** La page est destinée à être appliquée de nouveau — une appliance étendue de cette façon reste éligible, et chaque nouvel agrandissement du disque virtuel est remis à la partition de la même manière.

## Avant de commencer

Déroulez ces quatre étapes dans l'ordre. La première est celle qui rend les suivantes réversibles.

### 1. Sauvegarder la machine virtuelle

Prenez une sauvegarde de la machine virtuelle avant toute chose. L'extension réécrit la table des partitions : une sauvegarde est ce qui transforme une opération ratée en restauration plutôt qu'en réinstallation.

### 2. Étendre le disque virtuel depuis l'hyperviseur

Ajoutez l'espace nécessaire au disque de l'appliance, depuis votre hyperviseur. Cette étape seule ne change rien à l'intérieur de la machine — le système d'exploitation continue de voir l'ancienne taille tant que les commandes ci-dessous n'ont pas été exécutées.

> **L'option est grisée ? Cherchez un instantané**
>
> Un hyperviseur refuse d'étendre le disque d'une machine virtuelle qui porte un **instantané**. Si l'option est indisponible, vérifiez s'il en subsiste un et supprimez-le — puis étendez le disque.

### 3. Éventuellement, prendre un instantané

Une fois le disque étendu, vous pouvez prendre un instantané de la machine, comme retour arrière immédiat pour les commandes qui suivent. Prenez-le **après** l'extension du disque, jamais avant : un instantané est précisément ce qui empêcherait cette extension.

### 4. Appliquer l'extension à l'intérieur de l'appliance

Alors seulement, exécutez les commandes de la section suivante.

## Quelle partition étendre

Les commandes prennent un **répertoire** et étendent la partition qui le porte. **N'importe quel répertoire du système peut être désigné**, à une exception près.

> **`/boot` est exclu**
>
> Ne visez pas `/boot`. Les commandes travaillent sur le volume LVM de l'appliance, dont `/boot` est tenu à l'écart. Le champ ci-dessous refuse ce chemin.

En pratique, deux répertoires par appliance grossissent plus vite que les autres — ce sont eux qui motivent habituellement cette procédure :

| Appliance | Répertoire | Ce qu'il contient |
|---|---|---|
| **Mediation Controller** | `/var` | Les données du Mediation Controller, dont la base de données. |
| **Mediation Controller** | `/var/log` | Les journaux système. |
| **Edge Gateway** | `/var/lib/ipdiva/carerecord/archives` | Les archives graphiques des sessions enregistrées. |
| **Edge Gateway** | `/var/log` | Les journaux système. |

> **On désigne un répertoire, pas une partition**
>
> Vous n'avez pas besoin de savoir quelle partition ni quel volume logique porte quoi : les commandes le lisent à partir du répertoire que vous leur donnez. Exécutez `df -h` sur l'appliance pour voir lequel arrive à saturation.

## Étendre la partition

Ouvrez une session SSH sur l'appliance, en tant que `root`, puis exécutez les commandes qui lui correspondent.

Vous pouvez personnaliser la variable des commandes suivantes :

| Valeur personnalisée | Variable | Commentaire |
|---|---|---|
|  | `TARGET_DIRECTORY` | Répertoire dont la partition doit être étendue — voir [Quelle partition étendre](#which-partition-to-extend). |

Ou remplissez le champ avec l'un des trois répertoires qui saturent en premier :

**Mediation Controller**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> ```

**Edge Gateway**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

> **Ce que font les commandes**
>
> Elles enchaînent quatre opérations : faire **voir la nouvelle taille du disque** au noyau sans redémarrer, **réécrire la dernière partition LVM** pour qu'elle atteigne la fin du disque, remettre cet espace à **LVM**, puis étendre le **système de fichiers** dessus. Les deux variantes ne diffèrent que par la disposition des partitions de chaque appliance — retenez celle qui correspond à la machine sur laquelle vous êtes.

> **Vérifiez l'espace libre avant et après**
>
> Exécutez `df -h` sur le répertoire avant et après. Le gain doit correspondre à l'espace ajouté à l'étape 2.
>
> Si le système de fichiers n'a **pas** grossi, n'exécutez pas les commandes de nouveau dans la foulée : la table des partitions a déjà été réécrite, et un second passage sur la même taille de disque partirait d'un état qu'elles n'attendent pas. Signalez plutôt le résultat au support CyberElements.
>
> Les exécuter de nouveau est légitime dans un cas, et c'est le cas ordinaire : **quand de l'espace supplémentaire a été ajouté au disque virtuel**. Reprenez à l'étape 1 — toute la procédure s'applique de nouveau, sauvegarde comprise.
