Rechercher

14.5. Gestion des périphériques USB virtuels

download PDF

Lorsque vous utilisez une machine virtuelle (VM), vous pouvez accéder à un périphérique USB, tel qu'une clé USB ou une caméra Web, qui est connecté au système hôte, et le contrôler. Dans ce scénario, le système hôte transmet le contrôle du périphérique à la machine virtuelle. C'est ce que l'on appelle un USB-passthrough.

Les sections suivantes fournissent des informations sur l'utilisation de la ligne de commande pour :

14.5.1. Attacher des périphériques USB à des machines virtuelles

Pour attacher un périphérique USB à une machine virtuelle (VM), vous pouvez inclure les informations relatives au périphérique USB dans le fichier de configuration XML de la VM.

Conditions préalables

  • Assurez-vous que le périphérique que vous souhaitez transférer à la VM est connecté à l'hôte.

Procédure

  1. Localisez les valeurs de bus et de périphérique de l'USB que vous souhaitez connecter à la VM.

    Par exemple, la commande suivante affiche la liste des périphériques USB connectés à l'hôte. Le périphérique que nous utiliserons dans cet exemple est connecté au bus 001 en tant que périphérique 005.

    # lsusb
    [...]
    Bus 001 Device 003: ID 2567:0a2b Intel Corp.
    Bus 001 Device 005: ID 0407:6252 Kingston River 2.0
    [...]
  2. Utilisez l'utilitaire virt-xml avec l'argument --add-device.

    Par exemple, la commande suivante permet d'attacher une clé USB à la VM example-VM-1.

    # virt-xml example-VM-1 --add-device --hostdev 001.005
    Domain 'example-VM-1' defined successfully.
Note

Pour attacher un périphérique USB à une VM en cours d'exécution, ajoutez l'argument --update à la commande précédente.

Vérification

  • Exécutez la VM et vérifiez si l'appareil est présent et s'il fonctionne comme prévu.
  • Utilisez la commande virsh dumpxml pour vérifier si la définition XML du dispositif a été ajoutée à la section <devices> du fichier de configuration XML de la VM.

    # virsh dumpxml example-VM-1
    [...]
    <hostdev mode='subsystem' type='usb' managed='yes'>
      <source>
        <vendor id='0x0407'/>
        <product id='0x6252'/>
        <address bus='1' device='5'/>
      </source>
      <alias name='hostdev0'/>
      <address type='usb' bus='0' port='3'/>
    </hostdev>
    [...]

Ressources supplémentaires

14.5.2. Suppression des périphériques USB des machines virtuelles

Pour supprimer un périphérique USB d'une machine virtuelle (VM), vous pouvez supprimer les informations relatives au périphérique USB de la configuration XML de la VM.

Procédure

  1. Localisez les valeurs de bus et de périphérique de l'USB que vous souhaitez supprimer de la VM.

    Par exemple, la commande suivante affiche la liste des périphériques USB connectés à l'hôte. Le périphérique que nous utiliserons dans cet exemple est connecté au bus 001 en tant que périphérique 005.

    # lsusb
    [...]
    Bus 001 Device 003: ID 2567:0a2b Intel Corp.
    Bus 001 Device 005: ID 0407:6252 Kingston River 2.0
    [...]
  2. Utilisez l'utilitaire virt-xml avec l'argument --remove-device.

    Par exemple, la commande suivante supprime une clé USB, attachée à l'hôte en tant que périphérique 005 sur le bus 001, de la VM example-VM-1.

    # virt-xml example-VM-1 --remove-device --hostdev 001.005
    Domain 'example-VM-1' defined successfully.
Note

Pour supprimer un périphérique USB d'une VM en cours d'exécution, ajoutez l'argument --update à la commande précédente.

Vérification

  • Exécutez la VM et vérifiez si l'appareil a été supprimé de la liste des appareils.

Ressources supplémentaires

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.