> 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/de/systemadministration/generic-pci-passthrough.md).

# 1:1-PCI-Passthrough

Ein One-to-One-PCI-Passthrough bedeutet, einer einzelnen VM jeweils Zugriff auf ein PCI-Gerät zu geben, das physisch an einen Host-Knoten angeschlossen ist. Das Gastbetriebssystem der VM verwendet das Gerät, als wäre es direkt angeschlossen.

## Host-Installation/Konfiguration

{% hint style="danger" %}
**Es ist wichtig, Folgendes zu lesen und damit vertraut zu sein** [**Risiken und Vorsichtsmaßnahmen beim PCI-Passthrough**](/run-the-platform/de/systemadministration/device-pass-overview.md#pci-passthrough-risksprecautions) **bevor Passthrough-Konfigurationen vorgenommen werden.**
{% endhint %}

1. Navigieren Sie zum **Dashboard des Ressourcenmanagers** (**Infrastruktur** > **Ressourcen** im oberen Menü **-ODER-** Haupt-Dashboard > Ressourcen) **-ODER-** Navigieren Sie zu einem **spezifischen Knoten-Dashboard** (**Infrastruktur** > **Knoten** über das obere Menü \*-ODER-**Haupt-Dashboard > Knoten**, und doppelklicken Sie dann in der Liste auf den gewünschten Knoten.)
2. Klicken Sie **PCI-Geräte**.
3. Wählen Sie das gewünschte Gerät bzw. die gewünschten Geräte in der Liste aus und klicken Sie auf **Ressource erstellen** im linken Menü.
4. **Wählen Sie eine vorhandene PCI-Geräteressourcengruppe aus** aus der Liste **-ODER-** **Erstellen Sie eine neue PCI-Ressourcengruppe**.

### Erstellen einer PCI-Geräte-Ressourcengruppe

1. **Namen**: Bezeichnung zur Identifizierung der Ressourcengruppe (d. h. des Gerätepools); verwenden Sie einen aussagekräftigen Namen, damit Benutzer die Art der Geräte in dieser Gruppe leicht identifizieren können, z. B. *PCI-GPUs*
2. **Typ**: ***PCI***
3. **Beschreibung**: optionales Feld, um zusätzliche administrative Texte zur Ressourcengruppe anzugeben.
4. **Klasse**: wählen Sie die am besten passende Klassifizierung aus der Dropdown-Liste aus. Dieses Feld wird nur verwendet, um der Ressourcengruppe ein zugehöriges Symbol zuzuweisen, und hat keine Auswirkungen auf die Funktionalität.
5. Klicken Sie **Senden** um das Erstellen der neuen Ressourcengruppe abzuschließen.
6. **Ein Neustart des/der zugehörigen Knoten(s) kann erforderlich sein**; oben im Dashboard des Ressourcenmanagers wird eine Nachricht angezeigt.

{% hint style="warning" %}
**Befolgen Sie die korrekten** [**Wartungsmodus**](/run-the-platform/de/betrieb/maintenance-mode.md) **Verfahren beim Neustarten eines Knotens, um Unterbrechungen der Workloads zu vermeiden.**
{% endhint %}

Nachdem die Ressourcengruppe ausgewählt/erstellt wurde, sollte eine *Erfolgsmeldung* angezeigt werden, die darauf hinweist, dass Ressourceregeln für das/die Gerät(e) erstellt wurden.

## VM/Gast-Konfiguration

1. Navigieren Sie zum Dashboard der gewünschten VM (**Virtuelle Maschinen** > **Liste** > doppelklicken Sie in der Liste auf die gewünschte VM).
2. Klicken Sie **Geräte** im linken Menü.
3. Klicken Sie **Neu** im linken Menü.

{% hint style="success" %}
**Sie können Geräte auch über den Ressourcenmanager an eine VM anhängen; mit dieser Methode können mehrere Geräte auf einmal zur VM hinzugefügt werden. Im Dashboard der Ressourcengruppe > doppelklicken Sie auf die gewünschte PCI-Gruppe > Maschinengeräte anzeigen > Neu; wählen Sie die VM aus der Dropdown-Liste „Maschine“ aus.**
{% endhint %}

4. Felder des Formulars für Geräteeinträge:

* **Namen**: geben Sie einen Namen an, um die Art des/der Geräte(s) angemessen zu identifizieren, oder lassen Sie das Feld leer, damit das System automatisch einen Gerätenamen generiert.
* **Typ**: ***PCI***
* **Beschreibung**(optional): Hier kann zusätzlicher Text für administrative Zwecke eingegeben werden.
* **Ressourcengruppe**: wählen Sie die passende PCI-Ressourcengruppe aus der Dropdown-Liste aus
* **Anzahl**: geben Sie die Anzahl der PCI-Geräte an, die an die VM angehängt werden sollen (aus dieser Ressourcengruppe).

5. Klicken Sie **Senden** um das Hinzufügen des neuen Geräts abzuschließen.
6. Die VM benötigt einen **Neustart** um das Gerät anzuhängen. Klicken Sie im VM-Dashboard auf den *Neustart* Link in der Nachricht, die oben im Dashboard angezeigt wird, oder klicken Sie auf **Neustart** im linken Menü.
7. Installieren Sie alle erforderlichen Client- **Treiber**. Konsultieren Sie die Dokumentation des Hardwareherstellers.
8. **Starten Sie die VM neu**.

## PCI-Gerät an einen Tenant durchreichen

PCI-Geräte können an einen Tenant durchgereicht werden, damit der Tenant sie an seine eigenen VMs weiterreichen kann. Wenn Sie PCI-Geräte an den Tenant durchreichen, wird innerhalb des Tenants eine neue Ressourcengruppe erstellt.

{% hint style="info" %}
**Wenn Geräte einem Tenant bereitgestellt werden, sind sie dick provisioniert (d. h. der Tenant besitzt die Geräte dann, sodass sie selbst dann keinen anderen VMs oder Tenants zugewiesen werden können, wenn sie nicht verwendet werden.)**
{% endhint %}

1. Navigieren Sie zum gewünschten **Mandanten-Dashboard** (über das obere Menü: Tenants > Liste > doppelklicken Sie auf den Tenant in der Liste.)
2. Klicken Sie **Knoten** im linken Menü.
3. **Doppelklicken Sie auf einen der Tenant-Knoten**.
4. Klicken Sie **Geräte** im linken Menü.
5. Klicken Sie **Neu** im linken Menü.
6. Geben Sie einen **Namen** oder lassen Sie das Feld leer, damit das System automatisch einen Namen erstellt; dieser Name wird für die im Tenant erstellte Ressourcengruppe verwendet.
7. **Typ**: ***PCI***
8. **Beschreibung**: bietet einen Ort zum Speichern zusätzlicher administrativer Informationen über den Gerätepool.
9. **Anzahl**: Anzahl der Geräte, die in die Tenant-Ressourcengruppe durchgereicht werden sollen.
10. Wenn die Felder ausgefüllt sind, klicken Sie auf **Senden** um das Durchreichen an den Tenant abzuschließen.
11. Das/Die Gerät(e) werden nun als Ressourcengruppe verfügbar sein, die an Tenant-VMs angehängt werden kann. Befolgen Sie die obigen Anweisungen. Um das Passthrough-Gerät zu verwenden, muss die VM auf dem Tenant-Knoten ausgeführt werden, an den das Gerät angeschlossen ist. [**VM/Gast-Konfiguration**](#vmguest-configuration) Anweisungen oben. Damit das Passthrough-Gerät verwendet werden kann, muss die VM auf dem Tenant-Knoten ausgeführt werden, an den das Gerät angeschlossen ist.


---

# 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/de/systemadministration/generic-pci-passthrough.md?ask=<question>&goal=<endgoal>
```

`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.