Zusätzlich zu vordefinierten Runbooks unterstützt die ODS (Online Diagnostic System)-Funktion auch dynamische Runbooks zum Debuggen von NSX zur Laufzeit.

Dynamische Runbooks sind nicht von der NSX-Version abhängig und Sie können sie jederzeit installieren. Dynamische Runbooks beheben die folgenden Probleme:

  • Da Entwicklung und Wartung vordefinierter Runbooks dem NSX-Releasezyklus folgen, können Probleme, die auf Live-Sites zwischen Release-Zyklen auftreten, nicht debuggt werden. Mit dynamischen Runbooks können alle Debugging-Anforderungen zwischen Release-Zyklen implementiert werden, da dynamische Runbooks jederzeit entwickelt und installiert werden können.
  • Wenn Sie ein Teilupgrade von NSX durchführen, kann es zu einer Inkompatibilität zwischen einem Runbook und einer aufgerufenen API kommen. Nehmen wir an, Sie führen ein Upgrade des Transportknotens durch, ohne die Unified Appliance (UA) zu aktualisieren, und beim Upgrade wird eine neue Runbook-Version auf dem Transportknoten installiert. In diesem Fall kann UA die neuere Runbook-Version möglicherweise nicht mit der älteren API aufrufen, da die API möglicherweise veraltet ist.

Nur das VMware-Team kann dynamische Runbooks erstellen, die Sie zur Installation auf Ihrem System herunterladen können. Beachten Sie, dass Runbooks die Sicherung und Wiederherstellung von Daten nicht unterstützen.

Um die dynamischen Runbooks zu installieren, müssen Sie eine Gruppe definieren, die als dynamische Runbook-Instanz bezeichnet wird. Die dynamische Runbook-Instanz definiert alle Installationsknotengruppen, in denen Runbooks installiert werden sollen. Wird einer Gruppe ein neuer Knoten hinzugefügt, wird das Runbook automatisch auf dem neuen Knoten installiert.

Mit NSX 4.2 steht das folgende Runbook zum Download zur Verfügung. Um weitere Informationen zum Runbook zu erhalten, laden Sie das Paket von der folgenden VMware-Site herunter: https://support.broadcom.com/group/ecx/downloads.

Tabelle 1.
Runbook Beschreibung
Hyperbus-Runbook

Das dynamische Hyperbus-Runbook kann nach den folgenden Hyperbus-Problemen suchen und Lösungsvorschläge bieten:

  • Hyperbus-Verbindung
  • Konfigurationen der Hyperbus-Verbindung
  • vmknic
  • Status der Hyperbus-Verbindung

Dieses Runbook verwendet „vif-id“ als Eingabeargument.

Führen Sie zum Installieren dynamischer Runbooks die folgenden Aufgaben durch:

Voraussetzungen

Laden Sie das dynamische Paket von der VMware-Site https://support.broadcom.com/group/ecx/downloads herunter.

Prozedur

  1. Rufen Sie den Pfad der Transportknoten ab, die in die Installationsknotengruppe aufgenommen werden sollen.
    GET https://10.180.85.179/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. Erstellen Sie die Installationsknotengruppe. Die Gruppe kann eine Richtliniengruppe, eine Transportknotengruppe oder eine UA-Knotengruppe sein.
    PATCH https://<nsx-mgr>/policy/api/v1/infra/domains/default/groups/<group-name>
    {
        "expression": 
       [
            {
                "paths": [
                    "/infra/sites/default/enforcement-points/default/host-transport-nodes/TN1"
                ],
                "resource_type": "PathExpression"
            }
        ],
        "extended_expression": [],
        "reference": false,
        "group_type": [],
        "resource_type": "Group"
    }
    
  3. Erstellen Sie eine dynamische Runbook-Instanz, die alle Installationsknotengruppen enthält.
    POST https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>
    {
        "applied_to_group_paths": [
            "/infra/domains/default/groups/TNGroup1"  [Policy Group with node path]
        ],
        "applied_to_nodes": [
            "1e6314a2-a268-4a3a-bcae-4f23b2536ea8"  [The node id can be a host/edge/UA node id]
        ],
        "applied_to_all_appliances": true   [All UA cluster]
    }
    
  4. Laden Sie das Runbook-Paket in die dynamische Runbook-Instanz hoch.
    POST https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/file
    Die dynamischen Runbook-Daten werden auf die Zielknoten angewendet, die für diese Gruppe angegeben wurden.
  5. Fragen Sie den Installationsstatus ab.
    GET https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/state
    {
        "runbook_name": "Example",
        "management_state": "INSTALL_FINISHED",
        "install_state": [
            {
                "node_id": "084583fa-3ae7-4d0c-98f1-6fc4cb5044b1",
                "node_name": "TN301",
                "version": {
                    "major": 1,
                    "minor": 0
                },
                "status": "INSTALL_FINISHED"
            }
    }
    
  6. Überprüfen Sie die Details der installierten Runbooks mithilfe der folgenden API.
    GET https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbooks
  7. Rufen Sie das Runbook mithilfe der im Thema Debuggen von NSX zur Laufzeit beschriebenen Schritte auf.

Nächste Maßnahme

Um eine dynamische Runbook-Instanz auf zusätzliche Knoten zu erweitern, führen Sie die folgende API aus.

PATCH https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>
{
"applied_to_group_paths":["/infra/domains/default/groups/<tn-group-name>"],
"applied_to_nodes":["<target-edge-id>","<target-ua-id>"]
}

Um ein Runbook zu deinstallieren, führen Sie die folgende API aus.

DELETE https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/file

Um eine dynamische Runbook-Instanz zu deinstallieren, führen Sie die folgende API aus.

DELETE https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>