Corriger l'erreur de mise à niveau de Microsoft Intune Tunnel v20260129.1 – Serveurs Linux 2026

Ceci est le script de remédiation officiel de Microsoft pour résoudre les problèmes de mise à niveau avec la version 20260129.1.

1. Connectez-vous à votre serveur Linux Tunnel via SSH avec des privilèges administratifs
2. Téléchargez le script de correctif officiel de Microsoft :
   

   wget https://download.microsoft.com/download/tunnel/mstunnel-patch-2602.sh

3. Vérifiez l'intégrité du script en vérifiant le hash :
   

   sha256sum mstunnel-patch-2602.sh

4. Rendez le script exécutable :
   

   chmod +x mstunnel-patch-2602.sh

5. Arrêtez le service Microsoft Tunnel avant d'exécuter le correctif :
   

   sudo systemctl stop mstunnel

6. Exécutez le script de remédiation avec des privilèges sudo :
   

   sudo ./mstunnel-patch-2602.sh

7. Surveillez la sortie du script pour détecter d'éventuelles erreurs ou messages de fin
8. Redémarrez le service Tunnel après la réussite du correctif :
   

   sudo systemctl start mstunnel

Si le script de correctif n'est pas disponible, vérifiez et réinitialisez manuellement la configuration du service Tunnel.

1. Vérifiez la version actuelle de Tunnel et l'état du service :
   

   sudo mstunnel --version
   sudo systemctl status mstunnel

2. Vérifiez la version du paquet installé :
   

   dpkg -l | grep mstunnel

3. Vérifiez les fichiers de configuration corrompus :
   

   sudo find /etc/mstunnel -name "*.conf" -exec ls -la {} \;

4. Arrêtez tous les services liés à Tunnel :
   

   sudo systemctl stop mstunnel
   sudo systemctl stop mstunnel-agent

5. Effacez les fichiers temporaires de mise à niveau :
   

   sudo rm -rf /tmp/mstunnel-upgrade/*
   sudo rm -rf /var/cache/mstunnel/upgrade/*

6. Réinitialisez la configuration du service aux valeurs par défaut :
   

   sudo systemctl reset-failed mstunnel
   sudo systemctl daemon-reload

7. Redémarrez les services dans le bon ordre :
   

   sudo systemctl start mstunnel-agent
   sudo systemctl start mstunnel

Forcez manuellement la mise à niveau vers une version plus récente qui résout le problème connu.

1. Ajoutez le dépôt Microsoft Tunnel si ce n'est pas déjà configuré :
   

   curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   echo "deb [arch=amd64] https://packages.microsoft.com/repos/tunnel-prod/ focal main" | sudo tee /etc/apt/sources.list.d/mstunnel.list

2. Mettez à jour le dépôt de paquets :
   

   sudo apt update

3. Vérifiez les versions de Tunnel disponibles :
   

   apt list --upgradable | grep mstunnel

4. Arrêtez le service Tunnel actuel :
   

   sudo systemctl stop mstunnel

5. Forcez l'installation de la dernière version :
   

   sudo apt install --reinstall mstunnel=20260330.1-1

6. Reconfigurez le service Tunnel :
   

   sudo dpkg-reconfigure mstunnel

7. Démarrez le service mis à jour :
   

   sudo systemctl start mstunnel
   sudo systemctl enable mstunnel

8. Vérifiez que la mise à niveau s'est terminée avec succès :
   

   sudo mstunnel --version
   sudo systemctl status mstunnel

Si d'autres méthodes échouent, effectuez une réinstallation propre tout en préservant votre configuration existante.

1. Sauvegardez la configuration actuelle du Tunnel :
   

   sudo cp -r /etc/mstunnel /etc/mstunnel.backup
   sudo cp /var/lib/mstunnel/server.conf /var/lib/mstunnel/server.conf.backup

2. Exportez les fichiers de certificat et de clé actuels :
   

   sudo tar -czf mstunnel-certs-backup.tar.gz /etc/ssl/certs/mstunnel* /etc/ssl/private/mstunnel*

3. Arrêtez et désactivez le service Tunnel :
   

   sudo systemctl stop mstunnel
   sudo systemctl disable mstunnel

4. Supprimez complètement l'installation existante :
   

   sudo apt remove --purge mstunnel mstunnel-agent
   sudo rm -rf /etc/mstunnel /var/lib/mstunnel

5. Nettoyez le cache des paquets et les dépendances :
   

   sudo apt autoremove
   sudo apt autoclean

6. Réinstallez la dernière version de Tunnel :
   

   sudo apt update
   sudo apt install mstunnel

7. Restaurez la configuration sauvegardée :
   

   sudo cp -r /etc/mstunnel.backup/* /etc/mstunnel/
   sudo cp /var/lib/mstunnel/server.conf.backup /var/lib/mstunnel/server.conf

8. Restaurez les certificats :
   

   sudo tar -xzf mstunnel-certs-backup.tar.gz -C /

9. Démarrez et activez le service :
   

   sudo systemctl enable mstunnel
   sudo systemctl start mstunnel

Pour les problèmes persistants, analysez les journaux système et effectuez des diagnostics avancés.

1. Activez la journalisation détaillée pour le service Tunnel :
   

   sudo systemctl edit mstunnel

   Ajoutez les lignes suivantes :
   

   [Service]
   Environment="MSTUNNEL_LOG_LEVEL=debug"

2. Vérifiez les journaux système pour les erreurs liées à la mise à niveau :
   

   sudo journalctl -u mstunnel -f --since "1 hour ago"
   sudo tail -f /var/log/mstunnel/server.log

3. Analysez les journaux du gestionnaire de paquets :
   

   sudo grep -i mstunnel /var/log/dpkg.log
   sudo grep -i mstunnel /var/log/apt/history.log

4. Vérifiez l'espace disque et les permissions :
   

   df -h /var /tmp /etc
   sudo find /etc/mstunnel -type f -exec ls -la {} \;

5. Vérifiez la connectivité réseau aux services Microsoft :
   

   nslookup packages.microsoft.com
   curl -I https://packages.microsoft.com/repos/tunnel-prod/

6. Exécutez des diagnostics système :
   

   sudo systemd-analyze verify mstunnel.service
   sudo systemctl list-dependencies mstunnel

7. Générez un rapport de diagnostic complet :
   

   sudo mstunnel --diagnostic-report > tunnel-diagnostic-$(date +%Y%m%d).txt