Ausführen von Lese-/Schreibbefehlen

Mit dem Feature "Read Write (RW)" können Sie Gerätekonfigurationen remote ändern, ohne auf das Netzwerk-Fabric-Gerät zuzugreifen. Wenden Sie den RW-Konfigurationsbefehl auf der Geräteebene auf der Netzwerkstruktur an. Da der Konfigurationsbefehl auf Geräteebene erhalten bleibt, müssen Sie die Konfiguration, um sie auf alle Geräte anzuwenden, für jedes Gerät im Netzwerk konfigurieren.

Das Ausführen des RW-Befehls behält Ihre Konfiguration vor Änderungen bei, die über die Befehlszeilenschnittstelle (Command Line Interface, CLI) oder das Portal vorgenommen wurden. Um mehrere Konfigurationen über die RW-API einzuführen, fügen Sie neue Befehle an den vorhandenen RW-Befehl an. Schließen Sie beispielsweise nach dem Ändern mehrerer Geräteschnittstellen die vorherige Konfiguration mit allen neuen Änderungen ein, um das Überschreiben zu verhindern.

Stellen Sie die RW-Konfiguration nur während eines Upgradeszenarios zurück. Nach dem Upgrade müssen Sie die RW-Änderungen bei Bedarf erneut anwenden. Die folgenden Beispiele führen Sie schrittweise durch den PROZESS der RW-API.

Voraussetzungen

Stellen Sie sicher, dass die Nexus Network Fabric erfolgreich bereitgestellt wird.

Procedure

Wenn Sie einen RW-Konfigurationsbefehl ausführen und Änderungen am Gerät vornehmen, wird der Konfigurationsstatus des Geräts in das verzögerte Steuerelement verschoben. Dieser Status gibt an, dass die RW-Konfiguration auf diesem Gerät gepusht wurde. Wenn die angewendete RW-Konfiguration umgekehrt wird, wird die Konfiguration des Geräts auf den ursprünglichen erfolgreichen Zustand zurückgesetzt.

Netzwerkgerät auswählen

Melden Sie sich beim Azure-Portal

Zugreifen auf die Netzwerkgeräte:

Nachdem Sie sich angemeldet haben, verwenden Sie die Suchleiste oben, um nach Network Devices zu suchen oder navigieren Sie zu "Alle Dienste" und finden Sie "Netzwerkgeräte" unter der Kategorie "Netzwerke".

Klicken Sie auf Netzwerkgeräte, um die Liste der Netzwerkgeräte in Ihrem Abonnement zu öffnen.

Wählen Sie das Netzwerkgerät aus:

Suchen Und klicken Sie in der Liste der Netzwerkgeräte auf das Netzwerkgerät, das Sie konfigurieren möchten. Dadurch gelangen Sie zur Detailseite des ausgewählten Netzwerkgeräts.

Notieren Sie sich den Ressourcennamen und die Ressourcengruppe dieses Netzwerkgeräts, da Sie diese für den CLI-Befehl benötigen.

Oder

Um den Namen der Ressource abzurufen, klicken Sie auf die JSON-Ansicht (im Abschnitt "Eigenschaften" oder "Übersicht"), in der die detaillierten Eigenschaften des Geräts angezeigt werden, einschließlich des Ressourcennamens.

Examples

Die folgenden Abschnitte enthalten Beispiele für RW-Befehle, die zum Ändern der Konfiguration des Geräts verwendet werden können. Die Beispiele verwenden Ethernet-Schnittstellen 1, 2 und 3, um Ihnen zu zeigen, wie Sie den Schnittstellennamen anpassen und die Ergebnisse dieser Änderungen beobachten können.

Momentaufnahme des Network Fabric-Geräts, bevor Änderungen an der Konfiguration mithilfe der RW-API vorgenommen werden

show interfaces description  

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **"AR-Mgmt2:Et1 to Not-Connected"**          |
|Et2      | admin down        | down          | **"AR-Mgmt2:Et2 to Not-Connected"**         |
|Et3      | admin down        | down          | **"AR-Mgmt2:Et3 to Not-Connected"**         |
|Et4      | admin down        | down          | **"AR-Mgmt2:Et4 to Not-Connected"**       |

Ändern der Beschreibung einer Schnittstelle

Das Beispiel zeigt, wie die Schnittstellenbeschreibung des Geräts in RW-Test geändert wird.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test"

Erwartete Ausgabe:

{}

Befehl mit --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test" **--no-wait --debug**

Abgeschnittene Ausgabe erwartet:

cli.knack.cli: __init__ debug log: 
cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c= 
telemetry.main: Begin creating telemetry upload process. 
telemetry.process: Return from creating process 
telemetry.main: Finish creating telemetry upload process. 

Sie können den Status des Vorgangs programmgesteuert überprüfen, indem Sie den folgenden Befehl ausführen:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Beispiel für die Azure-AsyncOperation Endpunkt-URL, die aus der abgeschnittenen Ausgabe extrahiert wurde.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Der Status sollte angeben, ob die API erfolgreich war oder fehlgeschlagen ist.

Erwartete Ausgabe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "DeferredControl", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkRacks/NFResourceName", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
}

Wenn die RW-Konfiguration erfolgreich ist, wechselt der Gerätekonfigurationsstatus in einen verzögerten Steuerungszustand . Wenn die Konfiguration fehlschlägt, tritt keine Änderung des Zustands auf.

show interfaces description  

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **RW-test1**         |
|Et2      | admin down        | down          | "AR-Mgmt2:Et2 to Not-Connected"        |
|Et3      | admin down        | down          | "AR-Mgmt2:Et3 to Not-Connected"          |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Ändern von drei Beschreibungen der Schnittstelle

In diesem Beispiel wird gezeigt, wie Sie drei verschiedene Schnittstellen auf einer Gerätebeschreibung in RW-test1, RW-test2, RW-test3 ändern.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3"

Erwartete Ausgabe:

{}

Befehl mit --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 1\n description RW-test1\n interface Ethernet 2\n description RW-test2\n interface Ethernet 3\n description RW-test3" --no-wait --debug

Abgeschnittene Ausgabe erwartet:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', 'interface Ethernet 1\\\\n description RW-test1\\\\n interface Ethernet 2\\\\n description RW-test2\\\\n interface Ethernet 3\\\\n description RW-test3', '--debug'\]
cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Sie können den Status des Vorgangs programmgesteuert überprüfen, indem Sie den folgenden Befehl ausführen:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Beispiel für die Azure-AsyncOperation Endpunkt-URL, die aus der abgeschnittenen Ausgabe extrahiert wurde.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Der Status sollte angeben, ob die API erfolgreich war oder fehlgeschlagen ist.

Erwartete Ausgabe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**DeferredControl**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
} 

show interfaces description  

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **RW-test1**         |
|Et2      | admin down        | down          | **RW-test2**         |
|Et3      | admin down        | down          | **RW-test3**         |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Vorherige Konfiguration überschreiben

In diesem Beispiel wird gezeigt, wie die vorherige Konfiguration überschrieben wird, wenn Sie die alte RW-Konfiguration nicht anfügen:

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 3\n description RW-test3"

Erwartete Ausgabe:

{}

Befehl mit --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command "interface Ethernet 3\n description RW-test3" --no-wait --debug 

Abgeschnittene Ausgabe erwartet:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', \`interface Ethernet 3\\n description RW-test3\`, '--debug'\]cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Sie können den Status des Vorgangs programmgesteuert überprüfen, indem Sie den folgenden Befehl ausführen:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Beispiel für die Azure-AsyncOperation Endpunkt-URL, die aus der abgeschnittenen Ausgabe extrahiert wurde.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Erwartete Ausgabe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**DeferredControl**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 

  "type": "microsoft.managednetworkfabric/networkdevices" 

} 

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | "AR-Mgmt2:Et1 to Not-Connected"          |
|Et2      | admin down        | down          | "AR-Mgmt2:Et2 to Not-Connected"        |
|Et3      | admin down        | down          | **RW-test3**         |
|Et4      | admin down        | down          | "AR-Mgmt2:Et4 to Not-Connected"     |

Bereinigen der Lese-/Schreibkonfiguration

In diesem Beispiel wird gezeigt, wie die RW-Konfiguration bereinigt wird. Wenn Sie die Bereinigung ausführen, wird die Konfiguration auf die ursprüngliche Konfiguration zurückgesetzt.

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command " " 

Erwartete Ausgabe:

{}

Befehl mit --no-wait--debug

az networkfabric device run-rw --resource-name <ResourceName> --resource-group <ResourceGroupName> --rw-command " " --no-wait --debug

Abgeschnittene Ausgabe erwartet:

cli.knack.cli: Command arguments: \['networkfabric', 'device', 'run-rw', '--resource-name', 'nffab100g-5-3-AggrRack-MgmtSwitch2', '--resource-group', 'Fab100GLabNF-5-3', '--rw-command', ' ' '--debug'\]cli.knack.cli: \_\_init\_\_ debug log:
cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': 'https://eastus.management.azure.com/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/e239299a-8c71-426e-8460-58d4c0b470e2\*BF225A07F7F4850DA565ABE0036AB?api-version=2022-01-15-privatepreview&t=638479088323069839&c=
telemetry.main: Begin creating telemetry upload process.
telemetry.process: Creating upload process: "C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\python.exe C:\\Program Files (x86)\\Microsoft SDKs\\Azure\\CLI2\\Lib\\site-packages\\azure\\cli\\telemetry\\\_\_init\_\_.pyc \\.azure"
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

Sie können den Status des Vorgangs programmgesteuert überprüfen, indem Sie den folgenden Befehl ausführen:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

Beispiel für die Azure-AsyncOperation Endpunkt-URL, die aus der abgeschnittenen Ausgabe extrahiert wurde.

<https://eastus.management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx>

Der Status gibt an, ob die API erfolgreich war oder fehlgeschlagen ist.

Erwartete Ausgabe:

{ 
  "id": "/subscriptions/XXXXXXXXXXXX/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ResourceName", 
  "location": "eastus", 
  "name": "ResourceName", 
  "properties": { 
    "administrativeState": "Enabled", 
    "configurationState": "**Succeeded**", 
    "hostName": "<Hostname>", 
    "networkDeviceRole": "Management", 
    "networkDeviceSku": "DefaultSku", 
    "networkRackId": "/subscriptions/ XXXXXXXXXXXX /resourceGroups/ ResourceGroupName /providers/Microsoft.ManagedNetworkFabric/networkRacks/ NFResourceName ", 
    "provisioningState": "Succeeded", 
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX", 
    "version": "3.0.0" 
  }, 
  "systemData": { 
    "createdAt": "2024-XX-XXT13:41:13.8558264Z", 
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "createdByType": "Application", 
    "lastModifiedAt": "2024-XX-XXT10:44:21.3736554Z", 
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx", 
    "lastModifiedByType": "Application" 
  }, 
  "type": "microsoft.managednetworkfabric/networkdevices" 
} 

Wenn die RW-Konfiguration wieder auf die ursprüngliche Konfiguration zurückgesetzt wird, ändert sich der Konfigurationsstatus des Geräts von Deferred Control auf "Erfolgreich".

show interfaces description

|Interface  |Status  |Protocol  |Description  |
|---------|---------|---------|---------|
|Et1      | admin down        | down          | **"AR-Mgmt2:Et1 to Not-Connected"**         |
|Et2      | admin down        | down          | **"AR-Mgmt2:Et2 to Not-Connected"**         |
|Et3      | admin down        | down          | **"AR-Mgmt2:Et3 to Not-Connected"**      |
|Et4      | admin down        | down          |  **"AR-Mgmt2:Et4 to Not-Connected"**    |

Befehlseinschränkungen

Das RW-Befehlsfeature ist geöffnet, und es gibt keine Einschränkungen. Fahren Sie jedoch mit Vorsicht fort, da die falsche Verwendung der Konfiguration das System herabsetzen kann.

• Die Erstellung von vLANs zwischen 1 und 500 und 3000 bis 4095 wird nicht empfohlen, da dieser Bereich für Infrastrukturzwecke reserviert ist.

• Manipulieren Sie die vLAN-Verwaltung nicht.

• Es ist unbedingt darauf zu achten, die Network-to-Network Interconnect (NNI) Ingress- und Egress-Zugriffssteuerungslisten (ACLs) nicht zu manipulieren, da Änderungen möglicherweise zu einem Verlust der Konnektivität mit der Azure Operator Nexus-Instanz führen könnten.

• Für RW-Befehle werden keine Schema- oder Syntaxüberprüfungen ausgeführt. Sie müssen sicherstellen, dass die Konfiguration vor der Ausführung überprüft wird.

• Die RW-Konfigurationsbefehle sollten ein absoluter Befehl sein; kurze Formulare und Eingabeaufforderungen werden nicht unterstützt. Beispiel: Eingabe router bgp <ASN>\n vrf <name>\n neighbor <IPaddress> shutdown nicht router bgp <ASN>\n vrf <name>\n nei <IPaddress> sh or shut

• Es ist wichtig, die Konfiguration der Routingrichtlinie vor der Implementierung gründlich zu überprüfen, da jeder Fehler die bestehende Konfiguration der Routingrichtlinie potenziell beeinträchtigen könnte.

• Wenn Sie die BGP-Konfiguration des Routers ändern und den Router ausschalten, wird dadurch die Stabilität des Geräts beeinträchtigt.

Abrufen der RunRW-Konfiguration

Um die zuletzt erfolgreich angewendete RunRW-Konfiguration abzurufen, sehen Sie sich die rwDeviceConfig-Eigenschaft an. Diese Eigenschaft speichert die zuletzt erfolgreich angewendete RW-Konfiguration für das Gerät. Um darauf zuzugreifen, führen Sie eine GET-Anforderung für die Geräteressource aus.

az networkfabric device show --resource-group "example-rg" --resource-name "example-device"

Erwartete Ausgabe

{
  "id": "/subscriptions/xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkDevices/example-device-name",
  "location": "uaenorth",
  "name": "example-device-name",
  "properties": {
    "administrativeState": "Enabled",
    "configurationState": "DeferredControl",
    "hostName": "AR-CE1",
    "networkDeviceRole": "CE",
    "networkDeviceSku": "DefaultSku",
    "networkRackId": "/subscriptions/xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkRacks/example-rack-name",
    "provisioningState": "Succeeded",
    "rwDeviceConfig": "interface Ethernet 1/1\n description RW-test1",
    "serialNumber": "Arista;CCS-720DT-XXXX;11.07;WTW2248XXXX",
    "version": "4.0.0"
  },
  "systemData": {
    "createdAt": "2025-02-23T04:57:13.6113277Z",
    "createdBy": "xxxxxxxx-xxxx-xxxx-xxxxxx",
    "createdByType": "Application",
    "lastModifiedAt": "2025-02-27T08:27:46.3818706Z",
    "lastModifiedBy": "xxxxxxxx-xxxx-xxxx-xxxxxx",
    "lastModifiedByType": "Application"
  },
  "type": "microsoft.managednetworkfabric/networkdevices"
}

Persistente RW-Konfiguration während Geräteupgrades

In Azure Operator Nexus werden Read-Write (RW)-Konfigurationen auf Netzwerkgeräten jetzt für Gerätesoftwareupgrades beibehalten. Dadurch wird sichergestellt, dass benutzerdefinierte RW-Änderungen nach einem Upgrade erhalten bleiben, Konsistenz beibehalten und das Risiko von Konfigurationsabweichungen verringern.

Funktionsweise

Der Upgradeprozess folgt einem zweistufigen Ansatz:

• Upgrade des Geräts: Die EOS-Software des Geräts wird aktualisiert und initialisiert.

• RW Reapplication: Nach Abschluss des Upgrades wendet das System automatisch alle zuvor konfigurierten RW-Befehle auf das Gerät an.

Diese Wiederverwendung stellt sicher, dass persistente Konfigurationen wiederhergestellt und nach einem Geräteneustart oder Versionsübergang wirksam bleiben.

Fehlerbehandlung

Wenn während der Erneuterstellung eine RW-Konfiguration fehlschlägt, tritt das Gerät in einen fehlerhaften Zustand ein, und der Upgradevorgang wird nicht abgeschlossen.

Benutzer erhalten die Fehlerausgabe über Azure CLI.

In solchen Fällen:

Öffnen Sie ein Supportticket mit der aktualisierten und korrigierten RW-Konfiguration.

Das Supportteam wird mit Ihnen zusammenarbeiten, um die neue RW-Konfiguration erneut über eine Lockbox-aktivierte Administratoraktion anzuwenden.

Wenn die erneute Anwendung immer noch fehlschlägt, muss die Administratoraktion möglicherweise mit weiteren Korrekturen erneut ausgeführt werden.

Zusammenfassung

Einschränkungen

Allgemeine Fragen:

• Kann ich mehrere Befehle gleichzeitig ausführen?

  Ja, Sie können mehrere Befehle gleichzeitig ausführen. In den Beispielen wird erläutert, wie mehrere Befehle gleichzeitig ausgeführt werden.

• Wie kann ich überprüfen, ob die Konfiguration erfolgreich war?

  Sie können die Konfiguration entweder überprüfen:

  • Ausführen einer Read-Only-API und Ausführen der erforderlichen show Befehle zum Überprüfen der erfolgreichen Konfiguration,

  • Führen Sie das Feature "Config difference" aus, um das Delta zwischen den Konfigurationen anzuzeigen.

  Die RW POST-Nachricht gibt an, ob die Ausführung erfolgreich war oder nicht.

• Was geschieht, wenn ich den RW-Konfigurationsbefehl falsch ausführt?

  Die RW POST-Nachricht gibt eine Fehlermeldung zurück, wie im beispiel in diesem Artikel gezeigt. Auf das Gerät werden keine Konfigurationsänderungen angewendet. Sie müssen den Konfigurationsbefehl erneut ausführen.

• Wie kann ich den RW-Konfigurationsbefehl mehrmals beibehalten?

  Wenn Sie versuchen, die Konfiguration über eine bereits beibehaltene Konfiguration zu ändern und zu aktualisieren, müssen Sie alle geänderten beibehaltenen Konfigurationen bereitstellen, andernfalls wird die Konfiguration mit der neuesten RW-Konfiguration überschrieben.

  Zum Beispiel

  Wenn Sie ein Vlan 505 erfolgreich erstellt haben und versuchen, eine andere Gruppe von Vlans (vlan 510) zu erstellen, müssen Sie hinzufügen vlan 505\\n vlan 510. Wenn Sie es nicht tun, wird der neueste RW-Konfigurationsbefehl das VLAN 505 überschreiben.

• Wie lösche ich die Konfiguration?

  Sie müssen den NULL-Wert " "angeben. Weitere Informationen finden Sie im Abschnitt "Beispiele" in diesem Artikel.

• Ist der RW-Befehl in der Netzwerk-Fabric persistent?

  Der RW-Konfigurationsbefehl ist persistent, die API ermöglicht ihnen jedoch die Ausführung auf Geräteebene. Wenn Sie den RW-Befehl über die Fabric ausführen möchten, müssen Sie die RW-API über die erforderlichen Fabric-Geräte hinweg ausführen.

Bekanntes Problem

Das folgende Problem ist für die RW-Konfiguration bekannt:

• Ein Fehler wird gemeldet, da ein interner Fehler oder ein gNMI-Satzfehler nicht mit Fehlerantworten unterschieden werden kann.

Verwandte Inhalte

• Network-Fabric-Controller
• Ressourcen des Netzwerkgeflechts aktualisieren und commiten
• Read-only-Befehle für Network Fabric zur Problembehandlung