> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/usb-passthrough.md). # 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**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules). 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. {% hint style="success" %} **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.** {% endhint %} 3. **Sélectionnez** le(s) **périphérique(s) USB** dans la liste. {% hint style="info" %} **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.** {% endhint %} 4. Cliquez sur **Créer une ressource** dans le menu de gauche. 5. **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é. {% hint style="info" %} **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.** {% endhint %} 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). 6. **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. {% hint style="warning" %} **Suivez les** [**procédures du mode Maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) **lors du redémarrage d'un nœud afin d'éviter des perturbations de charge de travail.** {% endhint %} 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**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules) ## 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. {% hint style="success" %} **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.** {% endhint %} ### 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. 4. Cliquez sur **Soumettre** pour terminer l'ajout du nouveau périphérique. 5. Installez les pilotes client requis ; consultez la documentation matérielle du périphérique si nécessaire. 6. 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. {% hint style="info" %} **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.)** {% endhint %} 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é**](#vmguest-configuration) 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/administration-systeme/usb-passthrough.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.