> 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/sriov-nics.md).

# SR-IOV-NICs

VergeOS bietet Unterstützung für SR-IOV-fähige Netzwerkkarten und ermöglicht, dass mehrere Geräteinstanzen (virtuelle Funktionen) von einem einzelnen PCIe-Netzwerkcontroller-Gerät an Tenants und VMs gemeinsam genutzt werden können.

{% hint style="info" %}
**VergeOS bietet integrierte, virtualisierte Netzwerkadapterfunktionen für virtuelle Maschinen. SR-IOV-virtuelle-Funktions-NICs werden unterstützt (Version 4.13 und höher) für Szenarien, in denen direktes NIC-Passthrough erforderlich ist. Wenn direktes NIC-Passthrough verwendet wird, wird das VergeOS-Netzwerk umgangen, wodurch die inhärente Portabilität, Redundanz und andere Netzwerkfunktionen verloren gehen.**
{% endhint %}

## 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 %}

Die folgenden Anweisungen konfigurieren das Passthrough virtueller Funktionen, indem die erforderlichen Ressourceregeln für jeden Satz virtueller Funktionen automatisch erstellt und die Regeln der ausgewählten Ressourcengruppe zugewiesen werden. Weitere Informationen dazu, wie Ressourcengruppen und Ressourceregeln funktionieren, finden Sie unter: [**Geräte-Passthrough - Ressourceregeln**](/run-the-platform/de/systemadministration/device-pass-overview.md#resource-rules).

1. Navigieren Sie zum **Dashboard des Ressourcenmanagers** (**Infrastruktur** > **Ressourcen**) **-ODER-** Navigieren Sie zu einem **spezifischen Knoten-Dashboard** (**Infrastruktur** > **Knoten** > Doppelklicken Sie auf den gewünschten Knoten in der Liste.)
2. Klicken Sie **SR-IOV-NICs**. Alle bereits konfigurierten SR-IOV-virtuellen Geräte werden in der angezeigten Liste angezeigt.
3. Klicken Sie **NIC-PCI-Geräte** im linken Menü. Die Liste kompatibler physischer Geräte wird angezeigt.
4. **Wählen Sie das/die gewünschte(n) Gerät(e)** in der Liste aus und klicken Sie auf **Ressource erstellen** im linken Menü.
5. **Wählen Sie eine SR-IOV-Ressourcengruppe aus** aus der Liste **-ODER-** **Erstellen Sie eine neue SR-IOV-Ressourcengruppe**.

### Erstellen einer SR-IOV-NIC-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. *SR-IOV-NIC vlan10*
2. **Typ**: ***SR-IOV-NIC***.
3. **Beschreibung**: optionales Feld, um zusätzliche administrative Texte zur Ressourcengruppe anzugeben.
4. **Klasse**: ***Netzwerk***. Dieses Feld wird nur verwendet, um der Ressourcengruppe ein zugehöriges Symbol zuzuweisen, und wirkt sich nicht auf die Funktionalität aus.

#### SR-IOV-NIC-Einstellungen

* Geben Sie die **Anzahl der VF-Geräte** (pro physischem Gerät) an. Die Gesamtzahl der zu erstellenden VF-Geräte ergibt sich aus der angegebenen Anzahl multipliziert mit der Anzahl der ausgewählten physischen Geräte.
* Aktivieren Sie das ***Benutzerdefiniert*** Option für Felder, bei denen ein VM-Benutzer die angegebene Einstellung überschreiben dürfen soll; Felder, bei denen die Option Benutzerdefiniert nicht aktiviert ist, können vom Benutzer beim Anhängen des Geräts an eine VM nicht geändert werden.
* **Native VLAN**: (optional) VLAN-Tag für das virtuelle Gerät.
* **VLAN-Protokoll**: *802.1Q* (Standard) ist am weitesten verbreitet. *802.1ad* bietet Unterstützung für QinQ (Verschachtelung von VLAN-Tags).
* **Minimale Übertragungsbandbreite (Mbps)**: (optional) kann festgelegt werden, um eine Übertragung von mindestens dem angegebenen Minimum zu gewährleisten (pro VF). Dies kann verwendet werden, um verschiedenen Ressourcengruppen unterschiedliche Anteile der Gesamtbandbreite zuzuweisen. Das Festlegen von 0 deaktiviert die Ratenbegrenzung. Die Einstellung für die minimale Übertragungsbandbreite muss auf einen niedrigeren Wert als die maximale Übertragungsbandbreite gesetzt werden.
* **Virtueller Link-Status**:\
  \&#xNAN;***Automatisch*** - der VF-Status spiegelt einfach den des zugehörigen physischen Geräts wider.\
  \&#xNAN;***Aktivieren Sie*** - ermöglicht dem virtuellen Gerät, mit anderen virtuellen Geräten auf demselben Host zu kommunizieren, selbst wenn das physische Gerät ausgefallen ist.\
  \&#xNAN;***Deaktivieren*** - Pakete, die vom virtuellen Gerät gesendet werden, werden von der Hardware verworfen.
* **Spoof-Überprüfung**: aktivieren/deaktivieren Sie die Mac-Spoof-Überprüfung für das virtuelle Gerät.
* **VLAN-QOS (Priorität)**: (optional) Wert 0-7; legt die QOS-Priorität für VF-Verkehr fest. Die QOS-Priorität hängt von Hardware-, Treiber- und Gastbetriebssystemunterstützung ab.
* **Maximale Übertragungsbandbreite (Mbps)**: kann festgelegt werden, um die Bandbreite zu begrenzen (pro VF). Dies kann verwendet werden, um verschiedenen Ressourcengruppen (d. h. Pools virtueller Funktionen) unterschiedliche Anteile der Gesamtbandbreite zuzuweisen.
* **Vertrauen**: wenn aktiviert, kann der VM-Nutzer bestimmte Funktionen festlegen, die Sicherheit und/oder Leistung beeinträchtigen können (z. B. Multicast-Promiscuous-Modus); bestimmte Anwendungsfälle, wie Layer-2-Dienste, erfordern, dass Vertrauen aktiviert ist.
* **RSS-Abfrageprüfung**: wenn aktiviert, können Konfigurationsinformationen des Geräts vom virtuellen Gerät innerhalb des Gastbetriebssystems abgerufen werden; einige Geräte verbieten dies standardmäßig, da Informationen beim Austausch zwischen virtuellem und physischem Gerät als vertraulich gelten können.

5. Klicken Sie **Senden** um das Erstellen der neuen Ressourcengruppe abzuschließen.

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.

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 %}

Das Dashboard der Ressourcengruppe enthält die Ressourceregeln, die automatisch für Ihre ausgewählten Geräte generiert wurden. Sie können auf eine einzelne Regel klicken, um die Konfigurationsdetails anzuzeigen. Eine vom System erstellte Regel kann bei Bedarf angepasst werden; zum Beispiel kann der *Knoten* Filter zu *-- Keine --* geändert werden, um übereinstimmende Geräte von allen Knoten einzuschließen. Informationen zu Ressourceregeln finden Sie unter: [**Übersicht über das Geräte-Passthrough - Ressourceregeln**](/run-the-platform/de/systemadministration/device-pass-overview.md#resource-rules)

## VM/Gast-Konfiguration

1. Navigieren Sie zum **VM-Dashboard** (über das obere Menü: 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 einer VM auch über den Ressourcen-Manager zuweisen: vom Dashboard der Ressourcengruppe aus > doppelklicken Sie auf die gewünschte SR-IOV-Gruppe > Geräte der Maschine anzeigen > Neu; wählen Sie die VM aus der Dropdown-Liste Maschine aus.**
{% endhint %}

### Felder des Geräte-Eintragsformulars

* **Namen**: geben Sie einen Namen an, um das Gerät zu identifizieren, z. B. "Intel xl710 sriov", oder lassen Sie das Feld leer, damit das System automatisch einen Gerätenamen generiert.
* **Typ**: wählen Sie ***SR=IOV NIC***;
* **Beschreibung**(optional): Hier kann zusätzlicher Text für administrative Zwecke eingegeben werden.
* **Ressourcengruppe**: wählen Sie die passende SR-IOV-Ressourcengruppe aus der Dropdown-Liste aus
* **Anzahl**: geben Sie die Anzahl der SR-IOV-VF-Geräte an, die der VM hinzugefügt werden sollen (aus dieser Ressourcengruppe).
* **SR-IOV-NIC-Einstellungen**: die hier verfügbaren Optionen hängen von den *Benutzerdefiniert* umschaltbaren Einstellungen ab, die in den SR-IOV-Einstellungen der Ressourcengruppe definiert sind (siehe **SR-IOV-Einstellungen** oben.)

4. Klicken Sie **Senden** um das Hinzufügen des neuen Geräts abzuschließen.
5. 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ü.
6. Installieren Sie alle erforderlichen Client- **NIC-Treiber**. Erforderliche Treiber variieren je nach spezifischem SR-IOV-NIC-Hersteller/Modell und Gastbetriebssystem; konsultieren Sie die Dokumentation des Hardwareherstellers.
7. **Neustart** die VM.

## SR-IOV-Geräte an einen Tenant weitergeben

SR-IOV-Geräte können an einen Tenant weitergegeben werden, damit der Tenant sie an seine eigenen VMs weiterreichen kann. Wenn Sie SR-IOV-virtuelle Funktions-NICs 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**: festlegen auf ***SR-IOV-NIC***.
8. **Beschreibung**: bietet einen Ort zum Speichern zusätzlicher administrativer Informationen über den Gerätepool.
9. **Anzahl**: Anzahl der virtuellen Funktions-NICs, die an die Tenant-Ressourcengruppe weitergereicht werden sollen.
10. Ein bestimmter **MAC-Adresse** kann eingetragen werden oder das Feld leer gelassen werden, damit das System automatisch eine MAC-Adresse generiert (Es wird empfohlen, dieses Feld leer zu lassen, damit einzigartige, vom System generierte MAC-Adressen verwendet werden und unbeabsichtigt doppelte MAC-Adressen im selben Netzwerk vermieden werden.)
11. Wenn die Felder ausgefüllt sind, klicken Sie auf **Senden** um das Durchreichen an den Tenant abzuschließen.
12. 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/sriov-nics.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.
