Résolution d'écran bloquée à 1024x768 sur une machine virtuelle KVM Pardus.

Pourquoi une machine virtuelle Pardus KVM peut-elle rester bloquée à une résolution de 1024x768 ?

Une machine virtuelle Pardus qui ne propose jamais une résolution supérieure à 1024x768 ne souffre généralement pas d'un simple problème de configuration d'affichage. La question essentielle est de savoir si la machine virtuelle reçoit effectivement un affichage virtuel plus large de la part de KVM/QEMU et si la session de bureau réagit aux redimensionnements.

Le résultat souhaité est simple : après redimensionnement de la fenêtre d’affichage ou sélection d’un mode plus large, Pardus doit proposer des résolutions telles que 1366x768, 1600x900 ou 1920x1080 au lieu d’afficher 1024x768 comme résolution maximale. L’intégration du presse-papiers et la fluidité du pointeur sont des indices secondaires utiles lors des tests SPICE, mais la résolution reste le critère principal.

Ce guide s'applique principalement aux machines virtuelles Pardus exécutées sous KVM/QEMU avec libvirt et une console SPICE ou graphique. Pardus 25.0 est sorti en novembre 2025, et le dépôt de téléchargement officiel de Pardus propose également des images de Pardus 25.1 depuis mars 2026. Les menus du bureau pouvant différer entre les éditions XFCE et GNOME, les vérifications ci-dessous utilisent des commandes et des paramètres de virtualisation indépendants de tout environnement de bureau. Consultez le dépôt de téléchargement officiel de Pardus 25 pour obtenir les images d'installation les plus récentes.

1. Vérifiez que 1024x768 correspond bien au mode maximum du système invité.

Démarrez dans Pardus. Ouvrez un terminal et identifiez le type de session et le matériel d'affichage virtuel :

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'

Si la session est X11, exécutez également :

xrandr --current

Veuillez prêter attention à deux points. Premièrement, vérifiez si le GPU virtuel est un QXL, un GPU Virtio, une carte VGA générique ou autre. Deuxièmement, consultez la liste des modes. Si la résolution 1920x1080 y figure déjà, la pile de virtualisation est probablement compatible avec cette résolution supérieure et le problème provient vraisemblablement de la configuration du bureau ou d'un problème lié au redimensionnement. Si xrandrla résolution maximale est fixée à 1024x768, modifier la résolution du bureau ne suffira probablement pas.

Sur une session Wayland, cet xrandroutil n'est pas un outil de configuration officiel pour le compositeur ; utilisez-le uniquement à titre d'information complémentaire. Le type de session est important car QXL a historiquement été associé aux flux de travail X.Org/SPICE, tandis que Virtio GPU est le périphérique graphique paravirtualisé plus moderne de QEMU.

2. Vérifiez les périphériques vidéo et d'affichage de la machine virtuelle sur l'hôte KVM.

Arrêtez complètement la machine virtuelle avant de modifier son matériel vidéo virtuel. Dans le Gestionnaire de machines virtuelles, ouvrez les détails matériels de la machine virtuelle et examinez le périphérique d'affichage et le périphérique vidéo. Une configuration SPICE courante utilise un écran SPICE associé à une carte vidéo QXL ou Virtio.

Libvirt documente plusieurs types de modèles vidéo pris en charge, notamment qxlet virtio. QEMU décrit le GPU VirtIO comme un contrôleur GPU/affichage paravirtualisé pour les machines virtuelles Linux et recommande généralement les périphériques VirtIO lorsqu'il n'est pas nécessaire d'émuler un matériel physique particulier. Vous pouvez consulter la documentation relative aux périphériques vidéo de libvirt et la documentation relative au GPU VirtIO de QEMU .

Si la machine virtuelle utilise déjà QXL et SPICE, ne modifiez pas tout d'un coup. Conservez cette configuration et installez d'abord l'agent invité SPICE. Cela vous permettra d'effectuer un test concluant : si la résolution dynamique fonctionne, il est inutile de modifier le GPU virtuel.

Si la machine virtuelle utilise un ancien modèle VGA générique ou Cirrus, il est généralement plus approprié de passer à QXL ou Virtio pour un poste de travail Linux moderne. Si vous optez ultérieurement pour Virtio, commencez par désactiver l'accélération 3D. La documentation de QEMU indique que les modes GPU Virtio accélérés nécessitent des prérequis supplémentaires au niveau de l'hôte, du noyau, de Mesa et du moteur de rendu. Une configuration GPU Virtio 2D de base constitue donc une base de dépannage plus sûre.

3. Installez l'agent invité SPICE dans Pardus

Lorsque la machine virtuelle utilise un affichage SPICE, la solution la plus utile et la moins risquée consiste à s'assurer que le logiciel spice-vdagentest installé dans la machine virtuelle invitée :

sudo apt update
sudo apt install spice-vdagent

Déconnectez-vous puis reconnectez-vous, ou redémarrez la machine virtuelle. La description du paquet Debian spice-vdagentmentionne spécifiquement l'ajustement automatique de la résolution de la session X à la résolution du client parmi ses fonctions. Pardus étant basé sur Debian, ce paquet est disponible dans l'écosystème de paquets dérivés de Debian utilisé par les versions actuelles de Pardus. La version stable de Debian inclut actuellement la version spice-vdagent0.22.1-4.1. Consultez la page du paquet spice-vdagent pour Debian .

Après l'installation, vérifiez le démon et le processus côté utilisateur :

systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent

Un processus système en cours d'exécution est utile, mais la session utilisateur a également son importance. La documentation des paquets Debian indique que la gestion automatique de la résolution dépend d'une session graphique active exécutant le processus agent.

Si la machine virtuelle utilise QXL sous X.Org et que le pilote graphique semble manquant, vérifiez si le package de pilotes QXL X.Org est installé :

dpkg -l xserver-xorg-video-qxl
sudo apt install xserver-xorg-video-qxl

N'effectuez cette opération que si la machine virtuelle utilise effectivement QXL. Ce paquet existe spécifiquement pour les périphériques QXL dans les environnements KVM/QEMU compatibles SPICE ; il n'est pas nécessaire simplement parce que la machine virtuelle s'exécute sous KVM. Les paquets Debian stables incluent actuellement les xserver-xorg-video-qxlversions 0.1.6 à 1.1, documentées sur la page du pilote QXL de Debian .

4. Testez à nouveau le redimensionnement dynamique avant de modifier le GPU virtuel.

Après vous être reconnecté, ouvrez la console graphique et redimensionnez sa fenêtre. Si votre client propose une option d'adaptation à la fenêtre ou de redimensionnement automatique, activez celle qui redimensionne la fenêtre invitée plutôt que celle qui se contente d'étirer l'image affichée.

Pour X11, relancez le processus xrandr --current. En cas de succès, la résolution maximale devrait être plus élevée et des modes supplémentaires devraient s'afficher ; le mode actuel devrait également changer automatiquement lorsque la taille de la fenêtre de visualisation est modifiée. Vous pouvez aussi ouvrir les paramètres d'affichage de Pardus et vérifier que des résolutions natives plus élevées sont disponibles.

Ne jugez pas le succès uniquement à l'aune de la taille apparente de la fenêtre de la console. Un visualiseur peut redimensionner une image tampon de 1024x768 pour remplir une grande fenêtre, ce qui agrandit l'affichage sans augmenter la résolution du système invité. Les indicateurs fiables sont le mode déclaré par le système invité et la surface d'affichage réellement disponible.

Si la résolution QXL reste limitée à 1024x768, passez à la vidéo Virtio.

Si l'agent SPICE est installé et actif, mais que la machine virtuelle invitée n'affiche toujours qu'une résolution de 1024x768, modifiez les paramètres un par un. Éteignez la machine virtuelle, ouvrez les paramètres matériels vidéo et remplacez le modèle vidéo QXL ou VGA par Virtio. Conservez l'affichage SPICE, sauf si vous avez une raison particulière de modifier également le protocole d'affichage distant.

Démarrez Pardus et répétez les vérifications matérielles et de mode :

lspci -nnk | grep -A3 -E 'VGA|Display'
lsmod | grep virtio_gpu

Dans une session X11, exécutez également la commande suivante xrandr --current. QEMU indique que le GPU Virtio nécessite la prise en charge de cette fonctionnalité par le noyau Linux invitéCONFIG_DRM_VIRTIO_GPU ; les noyaux des distributions courantes la fournissent généralement, mais ce n'est pas toujours le cas des noyaux personnalisés. Si le système invité affiche un écran noir au démarrage après la modification, éteignez-le depuis l'hôte et rétablissez le modèle vidéo d'origine plutôt que de continuer à le modifier à l'aveugle.

Quand xrandr peut aider, et quand c'est la mauvaise solution.

Si xrandrla résolution souhaitée est déjà affichée, la sélectionner peut constituer une étape de diagnostic utile :

xrandr --output Virtual-1 --mode 1920x1080

Remplacez Virtual-1par le nom de sortie réel affiché par xrandr. Cette commande s'applique uniquement à X11 et seulement si ce mode est déjà disponible pour la sortie.

Si le mode souhaité est absent et que la taille maximale du framebuffer reste à 1024x768, l'injection manuelle d'une ligne de mode ne fait généralement que masquer le problème. Dans une machine virtuelle KVM, le GPU virtuel et l'intégration de l'affichage devraient normalement proposer des modes utilisables. Commencez par résoudre ce problème. La documentation X.Org RandR est la référence principale pour la configuration dynamique de l'affichage X11.

Comment déterminer si la réparation est complète

Commandes de dépannage utiles

Si le résultat reste incohérent, veuillez rassembler ces commandes avant d'apporter une autre modification :

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'
systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent
journalctl -b -u spice-vdagentd.service --no-pager

Sur X11, ajoutez :

xrandr --current

Ces contrôles permettent de distinguer quatre classes d'échec différentes : l'hôte expose le mauvais périphérique vidéo virtuel, Pardus ne dispose pas de l'intégration invitée appropriée, l'agent est installé mais n'est pas exécuté dans la session graphique, ou la session de bureau utilise une pile d'affichage qui ne répond pas au mécanisme de redimensionnement attendu.

Limites de cette solution

Il n'existe pas de solution unique, parmi QXL et Virtio, optimale pour toutes les installations KVM. La version de QEMU/libvirt de l'hôte, le client console, la session de bureau, le noyau et l'activation ou non de l'accélération 3D influent tous sur le résultat. Les étapes décrites ci-dessus commencent volontairement par la modification la moins perturbatrice et se basent sur la résolution signalée par la machine virtuelle invitée comme critère de réussite.

Si la machine virtuelle est accessible via un autre chemin d'affichage (VNC simple, transfert GPU, RDP vers la machine virtuelle ou console cloud), les étapes spécifiques à SPICE peuvent ne pas s'appliquer. De même, un noyau personnalisé sans le pilote DRM approprié peut nécessiter une configuration du noyau plutôt qu'un paquetage de bureau.

Le point d'arrêt pratique est atteint lorsque Pardus prend en charge les modes supérieurs souhaités, que le redimensionnement est possible sans se limiter à une simple mise à l'échelle d'une image tampon 1024x768, et que le résultat est conservé après un redémarrage. Si ces conditions sont remplies, aucun ajout de lignes de mode, de fichiers de configuration X.Org ou de modifications de l'accélération 3D n'est nécessaire.