Installer des manuels d'exécution dynamiques

Outre les manuels d'exécution prédéfinis, la fonctionnalité du système de diagnostic en ligne (ODS) prend également en charge les manuels d'exécution dynamiques pour déboguer NSX lors de l'exécution.

Les manuels d'exécution dynamiques ne dépendent pas de version NSX et vous pouvez les installer à tout moment. Les manuels d'exécution dynamiques résolvent les problèmes suivants :

Comme le développement et la maintenance de manuels d'exécution prédéfinis suivent le cycle de publication NSX, cela empêche le débogage des problèmes émergeant sur les sites en direct entre les cycles de publication. Avec les manuels d'exécution dynamiques, toutes les exigences de débogage peuvent être mises en œuvre entre les cycles de publication, car ils peuvent être développés et installés à tout moment.
Si vous mettez à niveau NSX partiellement, il peut y avoir une incompatibilité entre un manuel d'exécution et l'API qui l'appelle. Par exemple, vous mettez à niveau le nœud de transport, sans mettre à niveau Unified Appliance (UA), et la mise à niveau installe une nouvelle version du manuel d'exécution sur le nœud de transport. Dans ce cas, UA peut ne pas être en mesure d'appeler la nouvelle version du manuel d'exécution avec l'ancienne API, car l'API peut être obsolète.

Seule l'équipe VMware peut créer des manuels d'exécution dynamiques et vous pouvez les télécharger pour les installer sur votre système. Notez que les manuels d'exécution ne prennent pas en charge la sauvegarde et la restauration des données.

Pour installer les manuels d'exécution dynamiques, vous devez définir un groupe appelé instance de manuel d'exécution dynamique. L'instance de manuel d'exécution dynamique définit tous les groupes de nœuds d'installation dans lesquels les manuels d'exécution doivent être installés. Si un nouveau nœud est ajouté à un groupe, le manuel d'exécution sera automatiquement installé sur le nouveau nœud.

Avec NSX 4.2, le manuel d'exécution suivant est disponible au téléchargement. Pour plus d'informations sur le manuel d'exécution, téléchargez le module sur le site VMware https://support.broadcom.com/group/ecx/downloads.

Tableau 1.
Manuel d'exécution	Description
Manuel d'exécution Hyperbus	Le manuel d'exécution Hyperbus dynamique peut vérifier les problèmes Hyperbus suivants et fournir une suggestion de correction : Connexion Hyperbus Configurations de la connexion Hyperbus vmknic État de la connexion Hyperbus Ce manuel d'exécution prend vif-id comme argument d'entrée.

Pour installer des manuels d’exécution dynamiques, procédez comme suit :

Conditions préalables

Télécharger le paquet dynamique à partir du site de VMware https://support.broadcom.com/group/ecx/downloads.

Procédure

Obtenez le chemin des nœuds de transport à inclure dans le groupe de nœuds d'installation.
GET https://10.180.85.179/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes

Créez le groupe de nœuds d'installation. Le groupe peut être un groupe de stratégies, un groupe de nœuds de transport ou un groupe de nœuds UA.

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

Créez une instance de manuel d’exécution dynamique qui inclut tous les groupes de nœuds d'installation.

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

Téléchargez le paquet du manuel d'exécution vers l'instance du manuel d'exécution dynamique.
POST https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/file

Les données du manuel d'exécution dynamique sont appliquées aux nœuds cibles spécifiés dans ce groupe.

Interrogez l'état d'installation.

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

Vérifiez les détails des manuels d'exécution installés à l'aide de l'API suivante.
GET https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbooks
Appelez le manuel d'exécution en suivant les étapes mentionnées dans la rubrique Débogage de NSX lors de l'exécution.

Que faire ensuite

Pour étendre une instance de manuel d'exécution dynamique à des nœuds supplémentaires, exécutez l'API suivante.

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>"]
}

Pour désinstaller un manuel d'exécution, exécutez l'API suivante.

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

Pour désinstaller une instance de manuel d'exécution dynamique, exécutez l'API suivante.

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