Passage USB

Comment configurer le passage de périphériques USB dans VergeOS, y compris la configuration de l’hôte, la création de groupes de ressources, la configuration du système invité de la VM et le passage de périphériques USB aux locataires.

Les périphériques USB connectés à un hôte peuvent être transmis aux VM (et aux locataires pour qu'ils les transmettent à leurs VM), ce qui permet à un périphérique d'apparaître et de fonctionner comme s'il était directement connecté dans la VM.

Voici des exemples de périphériques USB en passthrough :

• des lecteurs contenant des clés de licence logicielle
• caméras de sécurité/équipements de surveillance
• clavier/souris (prise en charge d'une utilisation entre plusieurs VM ; souvent plus pratique que des configurations VM à double/multi-amorçage pour du matériel spécialisé)

Installation/configuration de l'hôte

Les instructions suivantes configureront le passage de périphériques en créant automatiquement une nouvelle règle pour chaque périphérique sélectionné et en attachant le(s) périphérique(s) au groupe de ressources. Pour plus d'informations sur le fonctionnement des groupes de ressources et des règles de ressources, voir : Passage de périphérique - Règles de ressources.

1. Accédez au tableau de bord du Gestionnaire de ressources (Infrastructure > Ressources) -OU- Accédez à un nœud spécifique où les périphériques USB sont branchés. (Infrastructure > Nœuds > double-cliquez sur le nœud souhaité dans la liste.)
2. Cliquez sur Périphériques USB. La liste des périphériques USB détectés s'affichera.

Un périphérique USB affichant une valeur dans les Groupe de ressources et Règles de ressources colonnes est déjà configuré pour le passthrough.

1. Sélectionnez le(s) périphérique(s) USB dans la liste.

Tous les périphériques sélectionnés seront ajoutés au même groupe de ressources (pool de ressources), mais une règle de ressources distincte sera créée pour chacun.

1. Cliquez sur Créer une ressource dans le menu de gauche.
2. Créer un nouveau groupe de ressources USB -OU- Sélectionner un groupe de ressources USB dans la liste.

Champs du groupe de ressources USB

• Nom : libellé utilisé pour identifier le groupe de ressources (c.-à-d. le pool de périphériques) ; utilisez un nom descriptif afin que les utilisateurs puissent facilement identifier le type de périphérique(s) dans ce groupe.
• Type: USB.
• Description : champ facultatif permettant de fournir des informations administratives supplémentaires sur le groupe de ressources.
• Classe : permet de sélectionner une classification générale des périphériques pour le groupe ; par exemple, périphérique USB générique, périphérique d'entrée humaine, média, etc. Ce champ est uniquement utilisé pour appliquer une icône associée et n'affecte pas les fonctionnalités.

Paramètres USB

• Autoriser la réinitialisation par l'invité : lorsque cette case est cochée, l'utilisateur de la VM peut réinitialiser le périphérique USB.
• Autoriser la réinitialisation de tout par l'invité : lorsque cette case est cochée, l'utilisateur de la VM peut réinitialiser le concentrateur USB auquel le périphérique est branché.

L'action de réinitialisation d'un périphérique USB dépend du pilote du périphérique ; certains périphériques la prennent en charge et d'autres non.

Une fois le groupe de ressources sélectionné ou un nouveau créé, un *Succès message devrait apparaître, indiquant que des règles de ressources ont été créées pour le(s) périphérique(s).

1. Un redémarrage du ou des nœuds associés peut être nécessaire ; un message apparaîtra en haut du tableau de bord du Gestionnaire de ressources.

Suivez les procédures du mode Maintenance lors du redémarrage d'un nœud afin d'éviter des perturbations de charge de travail.

Le tableau de bord du groupe de ressources contient les règles de ressources générées automatiquement pour les périphériques sélectionnés. Vous pouvez cliquer sur une règle individuelle pour afficher ses détails de configuration. Une règle créée par le système peut être modifiée si nécessaire ; par exemple, le Nœud filtre peut être modifié en -- Aucun -- pour inclure les périphériques correspondants de tous les nœuds. Des informations sur les règles de ressources sont disponibles à : Aperçu du passage de périphérique - Règles de ressources

Configuration de la VM/de l'invité

1. Accédez au tableau de bord de la VM (depuis le menu supérieur : Machines virtuelles > Liste > double-cliquez sur la VM souhaitée dans la liste)
2. Cliquez sur Périphériques dans le menu de gauche.
3. Cliquez sur Nouveau dans le menu de gauche.

Vous pouvez également attacher des périphériques à une VM via le Gestionnaire de ressources : depuis le tableau de bord du Groupe de ressources > double-cliquez sur le groupe SR-IOV souhaité > Afficher les périphériques de la machine > Nouveau ; sélectionnez la VM dans la liste déroulante Machine.

Champs du formulaire d'ajout de périphérique

• Nom : fournissez un nom pour identifier le périphérique, par ex. "exapp license key" ou laissez vide pour permettre au système de générer automatiquement un nom de périphérique.
• Type: USB
• Description (facultatif) : un texte supplémentaire peut être saisi ici à des fins administratives.
• Groupe de ressources : sélectionnez le groupe de ressources USB approprié dans la liste déroulante
• Paramètres USB : voir ci-dessus.

1. Cliquez sur Soumettre pour terminer l'ajout du nouveau périphérique.
2. Installez les pilotes client requis ; consultez la documentation matérielle du périphérique si nécessaire.
3. La VM aura besoin d'un redémarrage pour pouvoir attacher le périphérique. Depuis le tableau de bord de la VM, cliquez sur le Redémarrer lien dans le message qui apparaît en haut du tableau de bord, ou cliquez sur Redémarrer dans le menu de gauche.

Passage d'un périphérique USB à un locataire

Les périphériques USB peuvent être transmis à un locataire afin que celui-ci les transmette à ses propres VM. Lorsque vous transmettez des périphériques USB au locataire, un nouveau groupe de ressources est créé au sein du locataire.

Lorsque des périphériques sont partagés avec un locataire, ils sont alloués en mode thick provisioned (c.-à-d. que le locataire en devient propriétaire, ils ne peuvent donc pas être attribués à d'autres VM ou locataires, même lorsqu'ils ne sont pas utilisés.)

1. Accédez au tableau de bord du locataire (depuis le menu supérieur : Locataires > Liste > double-cliquez sur le locataire dans la liste.)
2. Cliquez sur Nœuds dans le menu de gauche.
3. Double-cliquez sur l'un des nœuds du locataire.
4. Cliquez sur Périphériques dans le menu de gauche.
5. Cliquez sur Nouveau dans le menu de gauche.
6. Entrez un Nom ou laissez vide pour permettre au système de créer automatiquement un nom ; ce nom sera utilisé pour le groupe de ressources créé dans le locataire.
7. Type: USB.
8. Description : fournit un emplacement pour stocker des informations administratives supplémentaires sur le périphérique/le pool de périphériques.
9. Paramètres USB : voir ci-dessus.
10. Une fois les champs renseignés, cliquez sur Soumettre pour terminer la transmission au locataire.
11. Le(s) périphérique(s) sera/seront désormais disponible(s) sous forme de groupe de ressources à attacher aux VM du locataire. Suivez les Configuration de la VM/de l'invité instructions ci-dessus. Pour utiliser le périphérique en passthrough, la VM doit s'exécuter sur le nœud du locataire auquel le périphérique est attaché.

Dépannage

La VM ne parvient pas à démarrer après un redémarrage du nœud

Symptôme : Une VM avec un périphérique USB en passthrough ne parvient pas à démarrer après le redémarrage de son nœud hôte (par exemple, après une mise à jour de VergeOS). La VM tente de démarrer à plusieurs reprises, mais ne peut pas ouvrir le périphérique USB.

Cause : La règle de ressources générée automatiquement identifie le périphérique à l'aide de son adresse physique de bus (le filtre de chemin). Cette adresse est attribuée à chaque fois que le périphérique USB s'énumère. Les changements dans la topologie matérielle du serveur — comme l'ajout ou la suppression de périphériques PCI — peuvent modifier la façon dont le contrôleur USB présente ses ports, ce qui entraîne un chemin différent. Sur une petite minorité de systèmes, le micrologiciel de la carte mère peut réénumérer les ports USB différemment après une réinitialisation du contrôleur, ce qui change le chemin même sans aucune modification matérielle. Lorsque le périphérique apparaît à une nouvelle adresse, la règle ne correspond plus à un périphérique actif, empêchant la VM de démarrer.

Correctif : Modifiez la règle de ressources afin qu'elle corresponde au périphérique grâce à ses identifiants matériels stables plutôt qu'à son adresse physique :

1. Accédez à Infrastructure > Ressources.
2. Dans la section Règles section, localisez la règle générée automatiquement pour le périphérique USB.
3. Double-cliquez sur la règle pour l'ouvrir en modification.
4. Activez les ID fournisseur (vendor_id) et ID de modèle (model_id) champs de filtre. L'ID de modèle est l'ID produit USB.
5. Activez les Série champ (périphériques pris en charge uniquement) pour lier la règle à un périphérique spécifique. La plupart des clés USB, disques durs/SSD externes, webcams et imprimantes/scanners de marques reconnues incluent un numéro de série unique programmé en usine.
6. Désactivez les champs de filtre de localisation physique (chemin et périphérique) si votre serveur n'attribue pas un chemin PCI cohérent entre les démarrages. Vous pouvez également désactiver ces champs si vous souhaitez que la règle corresponde au périphérique quel que soit le port USB auquel il est branché.
7. Cliquez sur Soumettre pour enregistrer la règle.
8. Démarrez la VM.

Le fournisseur, l'ID de modèle et le numéro de série sont stables entre les redémarrages, donc la règle correspond au périphérique quelle que soit sa réénumération.