Procedure-Systel/Production SI/Hyperviseur/ESXi/Mise à jour Serveur ESX.md

# Mettre à jour un serveur VMware ESXi

## 1. Prérequis et ordre des opérations

> **Interruption de service :** cette opération nécessite l'arrêt de toutes les machines virtuelles hébergées sur le serveur ESXi.
> **Ordre requis :** mettre à jour le firmware avant l'hyperviseur. Si un vCenter est présent, le mettre à jour avant ESXi.

Cette procédure décrit une mise à jour vers VMware ESXi 8.0 Update 3. La source indique que cette mise à jour est possible depuis les versions 6.7 et 7.0. Vérifier la compatibilité matérielle, le chemin de mise à niveau et la version recommandée auprès des experts Infrastructure avant de commencer.

Les mises à jour firmware et iLO des serveurs HPE sont fournies dans les paquets **SPP (Service Pack for ProLiant)**. Le paquet ESXi est spécifique aux serveurs HPE ProLiant. Demander aux experts Infrastructure les versions et paquets recommandés pour le serveur concerné.

Les paquets sont disponibles dans les répertoires suivants :

```text
\\cloud\Produits\Produits_tiers\HPE\Service Pack for Proliant
\\cloud\Produits\Produits_tiers\VMWare\VMware_ESXi
```

Avant l'intervention, confirmer le plan d'arrêt et de redémarrage des VM avec les équipes responsables. Prévoir un accès à iLO et à l'interface ESXi ou vCenter.

## 2. Arrêter les machines virtuelles

L'ordre et les modalités d'arrêt des services applicatifs doivent être confirmés avec leurs responsables.

### 2.1 SQL Witness

Consulter les experts SQL avant d'arrêter la VM SQL Witness.

### 2.2 Nœud SWARM

Confirmer le nom exact du nœud avant d'exécuter les commandes : le titre de la procédure source mentionne `SWARM-MANAGER-03`, tandis que sa commande utilise `SWARM-MANAGER-LIVE-03`.

Sur un manager Swarm, drainer le nœud concerné :

```bash
docker node update --availability drain SWARM-MANAGER-LIVE-03
docker node ls
docker ps
```

Vérifier avec `docker node ls` que le nœud est drainé et qu'aucune activité ne subsiste avant l'arrêt. Si l'arrêt de la machine est confirmé :

```bash
shutdown -h now
```

Après le redémarrage, réactiver le nœud avec son nom exact :

```bash
docker node update --availability active SWARM-MANAGER-LIVE-03
```

En cas de doute, contacter les DevOps dans Teams, canal `COM-SUPPORTS > DDP - DevOps`.

### 2.3 Contrôleur HYCU

1. Se connecter à l'interface HYCU et ouvrir **Jobs**.
2. Vérifier qu'aucune sauvegarde n'est en cours.
3. Dans les paramètres, ouvrir **Power Options** et cliquer sur **Suspend All** pour empêcher le lancement de nouvelles sauvegardes pendant l'arrêt et le redémarrage.
4. Arrêter la VM HYCU depuis ESXi ou vCenter.
5. Après le redémarrage, retourner dans **Power Options** et retirer la suspension.

### 2.4 vCenter

Si un vCenter est présent, appliquer sa mise à jour avant celle de l'hôte ESXi. Suivre la procédure [Mise à jour VMware vCenter 7 vers 8](https://tfs2k18.systel-sa.com/tfs/Systel/Etudes/_wiki/wikis/Etudes.wiki/2635/MAJ-VMWare-vCenter-7-vers-8).

Pour l'arrêt du vCenter avant la mise à jour de l'hôte :

1. Éteindre toutes les autres VM hébergées sur l'hôte.
2. Se connecter à **vCenter Server Management** sur `https://IP_vCenter:5480` avec le compte `root`.
3. Dans **Actions**, sélectionner **Arrêt** et confirmer si une demande apparaît.

## 3. Mettre l'hôte ESXi en maintenance

1. Ouvrir l'interface Web de l'hyperviseur ESXi.
2. Vérifier que toutes les VM de l'hôte sont arrêtées.
3. Dans le menu de l'hôte, sélectionner **Entrer en mode de maintenance**.
4. Confirmer si une fenêtre de confirmation apparaît.
5. Vérifier sur la page d'accueil de l'ESXi que l'hôte est bien en mode maintenance.

## 4. Mettre à jour le firmware HPE avec le SPP

1. Ouvrir l'interface iLO du serveur et lancer la console distante.
2. Depuis la console, monter ou importer le fichier ISO SPP, puis confirmer l'opération.
3. Redémarrer le serveur.
4. Au démarrage, appuyer sur `F11` pour ouvrir le menu **One-Time Boot Menu**.
5. Sélectionner l'entrée correspondant au média SPP monté. Vérifier son libellé dans le menu avant de la choisir.
6. Sélectionner **Automatic** pour lancer la mise à jour automatisée.

La procédure source estime la durée de l'opération à une à deux heures. Ne pas interrompre le serveur. La console iLO peut redémarrer pendant l'installation; se reconnecter si nécessaire pour suivre la suite du processus. Si iLO affiche un message pendant l'installation, ne pas intervenir sans confirmation des experts Infrastructure : les redémarrages peuvent faire partie du processus automatisé.

Si la console iLO ne se reconnecte pas correctement, vider le cache du navigateur puis réessayer.

## 5. Mettre à jour ESXi

Après la mise à jour du firmware, vérifier que l'hôte est démarré et toujours en mode maintenance.

### 5.1 Déposer le paquet sur un datastore

1. Dans l'interface ESXi, ouvrir **Stockage > Parcourir les banques de données**.
2. Ouvrir le répertoire de mise à jour souhaité ou en créer un.
3. Utiliser **Télécharger** pour déposer le paquet ESXi `.zip` sur le datastore.

### 5.2 Activer SSH et relever le profil

Activer SSH dans **Hôte > Services > Activer Secure Shell (SSH)**, puis se connecter à l'hôte en SSH.

Vérifier le mode maintenance :

```bash
esxcli system maintenanceMode get
```

Lister les profils disponibles dans le paquet en remplaçant le chemin par celui du fichier `.zip` :

```bash
esxcli software sources profile list -d <chemin-complet-vers-le-fichier.zip>
```

Exemple :

```bash
esxcli software sources profile list -d /vmfs/volumes/datastore/MAJ/Update.zip
```

Noter le nom exact du profil souhaité pour la commande suivante.

### 5.3 Installer le profil et redémarrer

Lancer la mise à jour en remplaçant le chemin et le profil par les valeurs relevées :

```bash
esxcli software profile update -d <chemin-complet-vers-le-fichier.zip> -p <nom-du-profil>
```

Exemple fourni dans la procédure source :

```bash
esxcli software profile update -d /vmfs/volumes/datastore/MAJ/Update.zip -p HPE-Custom-AddOn_803.0.0.12.1.0-11
```

Après la fin de la commande, redémarrer l'hôte :

```bash
esxcli system shutdown reboot --reason "maj vers 8.0U3"
```

Après le redémarrage, vérifier la version ESXi et l'état de l'hôte, puis quitter le mode maintenance si les contrôles sont concluants.

## 6. Vérifier ou appliquer la licence ESXi

Ouvrir **Hôte > Gérer > Attribution de licence** et vérifier la licence installée.

Une mise à jour de version majeure, par exemple de 7.0 à 8.0, nécessite une licence compatible avec la version installée. Si une nouvelle licence est nécessaire :

1. Se connecter à [Broadcom Support](https://support.broadcom.com/) avec le compte de licence dont les informations sont conservées dans `RDM > COMMUN`.
2. Ouvrir **Entitlements** et développer les détails jusqu'à la section **License** pour ESXi.
3. Relever la clé au format `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`.
4. Dans ESXi, ouvrir **Hôte > Gérer > Attribution de licence**, choisir **Attribuer une licence**, saisir la clé et cliquer sur **Vérifier la licence**.
5. Après validation, cliquer sur **Attribuer une licence** et vérifier que l'attribution est effective.

Ne pas inscrire la clé de licence dans cette procédure.

## 7. Mettre à jour VMware Tools

> La mise à jour de VMware Tools peut nécessiter le redémarrage de la VM. Prévoir l'interruption avec les responsables applicatifs.

Après la mise à jour de l'hôte, vérifier les VM et mettre à jour VMware Tools lorsqu'une version plus récente est disponible :

1. Sélectionner la VM dans ESXi ou vCenter.
2. Ouvrir **Actions > SE invité > Mettre à niveau VMware Tools**.
3. Attendre la fin de l'installation et effectuer le redémarrage requis.
4. Vérifier dans la description de la VM que VMware Tools est conforme.

Répéter pour chaque VM concernée.

## 8. Remise en service

Vérifier le bon fonctionnement de l'hôte et des VM, puis confirmer que les services applicatifs sont opérationnels. Réactiver les tâches HYCU suspendues et réactiver le nœud Swarm après validation des équipes concernées.