ibdmsh - En ligne dans le Cloud

PROGRAMME:

Nom

ibdmsh MODÈLE DE DONNÉES IB - Shell TCL étendu

DESCRIPTION

ibdmsh est un shell TCL étendu avec une interface pour le modèle de données IB. Pour utiliser cette coquille
vous allez écrire du code TCL qui accède directement aux objets et fonctions du modèle de données IB.

Les sous-sections suivantes fournissent une définition détaillée de ces objets et de l'API.

IBDM Constants

Nœud Types

Les constantes suivantes sont utilisées par le champ de type d'objet nœud

[ Constante : entier ] $IB_UNKNOWN_NODE_TYPE = IB_UNKNOWN_NODE_TYPE

[ Constante : entier ] $IB_SW_NODE = IB_SW_NODE

[ Constante : entier ] $IB_CA_NODE = IB_CA_NODE

Bûche Verbosité Drapeaux

Les constantes suivantes sont utilisées comme bits d'argument pour la variable globale
$FabricUtilsVerboseLevel

[ Constante : entier ] $FABU_LOG_NONE = 0x0

[ Constante : entier ] $FABU_LOG_ERROR = 0x1

[ Constante : entier ] $FABU_LOG_INFO = 0x2

[ Constante : entier ] $FABU_LOG_VERBOSE = 0x4

IBDM Globals

Niveau de journalisation : défini sur les valeurs FABU_LOG*

[ Global : int ] $FabricUtilsVerboseLevel

IBDM Objets

Cette section décrit les différents types d'objets exposés par IBDM.

IBDM expose certains de ses objets internes. Les identifiants d'objets renvoyés par les différents
les appels de fonction sont formatés selon les règles suivantes :

Tissu : tissu :

Système : système : :

SysPort : sysport : : :

Nœud : nœud : :

Port : port : : /

Les objets IBDM sont des objets Swig-Tcl standard. En tant que tels, ils ont deux saveurs pour leur utilisation :
Variables, Objets.

Variables/Pointeurs :
Pour chaque attribut d'objet, des méthodes "get" et "set" sont fournies.
Le format des méthodes est : _ _ .
La méthode "set" n'est disponible que pour les attributs de lecture/écriture.

Mise en situation :
définir les nœuds [ibdm_get_nodes]
définir le nœud [lindex $nodes 0]
IBNode_numPorts_get $noeud

Objets:
Étant donné un pointeur d'objet, on peut le convertir en un "Objet" Tcl
En utilisant la commande suivante:
-cette

Une fois déclaré le peut être utilisé conjointement à
avec les commandes standard "configure" et "cget".

Exemple (suivant le précédent) :
IBFabric VaTech -ce $ tissu
VaTech cget-NodeByName

Pour supprimer un symbole d'objet (et activer sa correspondance avec un autre
pointeur) utilisez :
Renommer ""
par exemple:
renommer VaTech ""

classe PortIB

Voici les différents champs et méthodes de la classe IB Port qui décrit un
Port physique du périphérique IB (puce).

[ Données de membre : renvoie IBPort * ] -p_remotePort
Port connecté de l'autre côté du lien

[ Données de membre : renvoie IBSysPort * ] -p_sysPort
Le port système (le cas échéant) connecté à

[ Données de membre : renvoie IBNode * ] -p_node
Le nœud dont fait partie le port.

[ Données du membre : renvoie un entier ] -num
Les ports physiques sont identifiés par un numéro.

[ Données de membre : renvoie un entier non signé ] -base_lid
Le couvercle de base affecté au port.

[ Données de membre : renvoie IBLinkWidth * ] -width
La largeur du lien du port

[ Données de membre : renvoie IBLinkSpeed ​​* ] -speed
La vitesse de liaison du port

[ Données du membre : renvoie un entier non signé ] -counter1
Une valeur générique à utiliser par divers algorithmes

[ Constructeur : renvoie IBPort * ] Nom IBPort numéro p_nodePtr
constructeur IBPort

[ Member : renvoie new_uint64_t ] guid_get
Obtenir le guide du port

[ Membre : renvoie void ] guid_set guid
Modifier le guide du port

[ Member : renvoie new_string ] getName
Obtenir le nom du port : un port de périphérique connecté au port système (panneau avant) renvoie
le nom du port du panneau avant.

[ Member : return void ] connect p_otherPort ?width? ?la vitesse?
Connectez le port à un autre port de nœud avec des paramètres de largeur et de vitesse facultatifs

[ Membre : renvoie un entier ] déconnecter
Déconnectez le port. Renvoie 0 en cas de succès

classe IBNœud

La classe IB Node représente un seul périphérique IB (puce)

[ Données de membre : renvoie la chaîne * ] -name
Nom du nœud (nom d'instance de la puce)

[ Données de membre : renvoie IBNodeType ] -type
Soit un $IB_SW_NODE soit un $IB_CA_NODE

[ Données de membre : renvoie uint16_t * ] -devId
L'ID de périphérique du nœud

[ Données de membre : renvoie uint16_t * ] -revId
L'ID de révision de l'appareil.

[ Données de membre : renvoie uint16_t * ] -vendId
L'ID du fournisseur de l'appareil.

[ Données de membre : renvoie la chaîne * ] -attributes
Chaîne séparée par des virgules d'attributs arbitraires k=v

[ Données de membre : renvoie uint8_t ] -rank
Le rang du nœud (0 est une racine)

[ Données membres : renvoie IBSystem * ] -p_system
À quel système appartenons-nous

[ Données de membre : renvoie IBFabric * ] -p_fabric
À quel tissu nous appartenons.

[ Données de membre : renvoie un entier non signé ] -numPorts
Nombre de ports physiques

[ Données membres : renvoie vec_pport * ] -Ports
Vecteur de tous les ports

[ Données de membre : renvoie vec_vec_byte * ] -MinHopsTable
Un tableau du nombre de sauts requis pour obtenir de chaque port à chaque LID cible

[ Données de membre : renvoie vec_byte * ] -LFT
Le LFT de ce nœud (pour les commutateurs uniquement) qui est un long vecteur de ports cibles -
l'index est le LID

[ Member : renvoie new_uint64_t ] guid_get
Obtenir le GUID du nœud

[ Membre : renvoie void ] guid_set guid
Définir le GUID du nœud

[ Constructeur : renvoie IBNode * ] Nom IBNode n p_fab p_sys t np
Entrepreneur

[ Membre : renvoie IBPort * ] makePort num
Créer un nouveau port par son numéro (si nécessaire) retourner le pointeur de port

[ Membre : renvoie IBPort * ] getPort num
Obtenez un port par numéro num = 1..N :

[ Member : return void ] setHops p_port lid hops
Définir le saut minimum pour le port donné (* est tout) paire de couvercles

[ Member : return int ] getHops p_port lid
Obtenir le nombre minimum de sauts définis pour le port donné ou tous

[ Membre : renvoie IBPort * ] couvercle getFirstMinHopPort
Scannez les ports du nœud et trouvez le premier port avec un saut minimum jusqu'au couvercle

[ Member : return void ] setLFTPortForLid couvercle portNum
Définir la table de transfert linéaire pour le LID donné

[ Member : return int ] getLFTPortForLid couvercle
Obtenir le LFT pour un LID donné

[ Member : renvoie void ] repHopTable
Vider la table de sauts min du nœud

classe IBSysPort

La classe IBSysPort représente une prise IB sur les panneaux avant ou arrière du système

[ Données de membre : renvoie la chaîne * ] -name
Le nom du panneau avant (soie) du port

[ Données de membre : renvoie IBSysPort * ] -p_remoteSysPort
Si connecté à l'autre port sys

[ Données membres : renvoie IBSystem * ] -p_system
Système auquel il appartient

[ Données de membre : renvoie IBPort * ] -p_nodePort
Le port de nœud auquel il se connecte.

[ Constructeur : renvoie IBSysPort * ] Nom IBSysPort n p_sys
Constructeur

[ Member : return void ] connect p_otherSysPort ?width? ?la vitesse?
Connectez deux SysPort

[ Membre : renvoie un entier ] déconnecter
Déconnectez le SysPort (et les ports). Renvoie 0 en cas de succès

classe SystèmeIB

La classe IBSystem représente un châssis entier

[ Données de membre : renvoie la chaîne * ] -name
Le nom « hôte » du système

[ Données de membre : renvoie la chaîne * ] -type
Quel est le type, c'est-à-dire Cougar, Buffalo, MTS2400, etc. Un fichier IBNL correspondant
devrait exister - définition de ce type de système

[ Données de membre : renvoie IBFabric * ] -p_fabric
Tissu auquel appartient le système

[ Données de membre : renvoie map_str_pnode * ] -NodeByName
Fournir le pointeur de nœud par son nom

[ Données du membre : renvoie map_str_psysport * ] -PortByName
Une carte fournissant un pointeur vers le SysPort par nom

[ Constructeur : renvoie IBSystem * ] Nom IBSystem n p_fab t
Entrepreneur

[ Member : renvoie new_uint64_t ] guid_get
Obtenir le GUID de l'image système

[ Membre : renvoie void ] guid_set guid
Définir le GUID de l'image système

[ Membre : renvoie IBSysPort * ] makeSysPort pName
Assurez-vous que le port est défini (donc définissez-le sinon)

[ Membre : renvoie IBPort * ] getSysPortNodePortByName sysPortName
Obtenez le port de nœud pour le port sys donné par nom

[ Member : renvoie IBSysPort * ] getSysPort name
Obtenir un port Sys par nom

classe IBFabric

Représente un sous-réseau IB entier composé de systèmes

[ Données de membre : renvoie map_str_pnode * ] -NodeByName
Fournir une liste de paires de nom de nœud et de pointeur

[ Données de membre : renvoie map_str_psys * ] -SystemByName
Fournir une liste de paires de nom de système et de pointeur

[ Données de membre : renvoie vec_pport * ] -PortByLid
Fournit une liste de noms de port système et de paires de pointeurs

[ Données de membre : renvoie map_guid_pnode * ] -NodeByGuid
Fournit une liste de paires de guides de nœuds et de pointeurs de nœuds

[ Données de membre : renvoie map_guid_psys * ] -SystemByGuid
Fournit une liste de paires de guides d'images système et de pointeurs système

[ Données de membre : renvoie map_guid_pport * ] -PortByGuid
Fournit une liste de paires de guide de port et de pointeur de port

[ Données de membre : renvoie un entier non signé ] -minLid
Couvercle min de piste utilisé.

[ Données de membre : renvoie un entier non signé ] -maxLid
Track max couvercle utilisé.

[ Données de membre : renvoie un entier non signé ] -lmc
Valeur LMC utilisée

[ Member : renvoie IBNode * ] makeNode n p_sys type numPorts
Obtenez le nœud par son nom (créez-en un qui n'existe pas)

[ Member : renvoie IBNode * ] getNode name
Obtenir le nœud par son nom

[ Member : renvoie list_pnode * ] type getNodesByType
Renvoie la liste des pointeurs de nœuds correspondant au type requis

[ Member : renvoie IBSystem * ] makeGenericSystem name
Créez un nouveau système générique - essentiellement un conteneur vide pour les nœuds...

[ Member : renvoie IBSystem * ] makeSystem name type
Créez un nouveau système - le type doit avoir une usine enregistrée.

[ Member : renvoie IBSystem * ] getSystem name
Obtenir le système par nom

[ Member : renvoie IBSystem * ] getSystemByGuid guid
obtenir le système par son guid

[ Member : renvoie IBNode * ] getNodeByGuid guid
obtenir le nœud par son guid

[ Membre : renvoie IBPort * ] getPortByGuid guid
récupérer le port par son guide

[ Membre : renvoie void ] addCable t1 n1 p1 t2 n2 p2 ?width? ?la vitesse?
Ajoute un câble en fonction de deux ensembles de type de nœud, de nom de nœud et de numéro de port. En option
utiliser une largeur et une vitesse données pour la connexion

[ Membre : renvoie un entier ] parseCables fn
Analyser le fichier de câbles et construire le tissu

[ Membre : renvoie un entier ] parseTopology fn
Analyser le fichier de topologie et créer le tissu

[ Membre : renvoie un entier ] addLink type1 numPorts1 sysGuid1 nodeGuid1 portGuid1 vend1
devId1 rev1 desc1 couvercle1 portNum1 type2 numPorts2 sysGuid2 nodeGuid2 portGuid2 vend2 devId2
rev2 desc2 lid2 portNum2 ?largeur ? ?la vitesse?
Ajoutez un lien dans la structure - cela créera le système et les nœuds selon les besoins.

[ Membre : renvoie un entier ] parseSubnetLinks fn
Analysez le fichier OpenSM subnet.lst et créez la structure à partir de celui-ci.

[ Membre : renvoie un entier ] parseFdbFile fn
Analyser le fichier de vidage OpenSM FDB et remplir les tables LFT des commutateurs

[ Membre : renvoie un entier ] parseMCFdbFile fn
Analyser un fichier OpenSM MCFDBs et définir la table MFT en conséquence

[ Membre : renvoie un entier ] parsePSLFile fn
Analyser le chemin vers le fichier de mappage SL. Chaque ligne avec : src_node_guid DLID SL

Utilisé par le contrôle de boucle de crédit

[ Membre : renvoie un entier ] parseSLVLFile fn
Analyser le fichier de tables SLVL. Chaque ligne contient : sw_node_guid in_port out_port 0x(sl0)(sl1)
0x(sl2)(sl3)...

[ Membre : renvoie void ] setLidPort couvercle p_port
Définir un port de couvercle

[ Membre : renvoie IBPort * ] couvercle getPortByLid
Obtenez un port par couvercle

[ renvoie IBFabric * ] new_IBFabric
Construire un nouveau tissu

[ renvoie void ] delete_IBFabric p_fabric
Détruire un tissu

IBDM Les fonctions

Cette section fournit des détails sur les fonctions exposées par IBDM. L'ordre suit le
ordre attendu dans un flux IBDM régulier. Ils renvoient tous 0 en cas de succès.

Sous-réseau Utilitaires

Le fichier contient un ensemble d'utilitaires à exécuter sur le sous-réseau pour imiter l'initialisation OpenSM
et analyser les résultats :

[ renvoie un entier ] ibdmAssignLids p_smNodePort ?lmc?
Attribuez des LID avec un LMC en option (plusieurs LID par port)

[ renvoie un entier ] ibdmCalcMinHopTables p_fabric
Calculez et remplissez les MinHopTables requis pour exécuter le routage de style OpenSM.

[ renvoie un entier ] ibdmCalcUpDnMinHopTbls p_fabric rootNodesNameRex
Calculez et remplissez les MinHopTables en suivant la règle Up/Down.

[ renvoie un entier ] ibdmOsmRoute p_fabric
Router le tissu avec un routage de style OpenSM

[ renvoie un entier ] ibdmEnhancedRoute p_fabric
Routez le tissu avec un routage de style OpenSM amélioré avec une meilleure prise en charge de LMC > 0

[ renvoie un entier ] ibdmFatTreeRoute p_fabric rootNodes
Routez le tissu à l'aide d'un algorithme qui s'adapte uniquement aux arbres pleins de graisse

[ renvoie un entier ] ibdmFatTreeAnalysis p_fabric
Analysez le tissu pour voir s'il s'agit d'un gros arbre et acheminez-le s'il est

[ renvoie un entier ] ibdmVerifyCAtoCARoutes p_fabric
Assurez-vous que tous les (H)CA sont connectés les uns aux autres en fonction des paramètres LFT

[ renvoie un entier ] ibdmVerifyAllPaths p_fabric
Assurez-vous que tous les commutateurs et (H)CA sont connectés les uns aux autres en fonction du LFT
Paramétres

[ renvoie un entier ] ibdmAnalyzeLoops p_fabric
Un contrôle rigoureux des boucles de crédit. Cet algorithme effectue une vérification complète et précise
mais son rapport sur les chemins de la boucle de crédit est difficile à interpréter. Si tu connais les racines
de l'arbre (ou l'arbre est symétrique) il est préférable d'utiliser le
ibdmReportNonUpDownCa2CaPaths

[ renvoie list_pnode ] ibdmFindSymmetricalTreeRoots p_fabric
Analyser la topologie de l'arbre et trouver les racines de l'arbre en fonction de sa symétrie

[ renvoie list_pnode ] ibdmFindRootNodesByMinHop p_fabric
Sur la base du MinHopTable, trouvez les racines de l'arbre. Une asymétrie de 5% est autorisée

[ renvoie un entier ] ibdmRankFabricByRoots p_fabric rootNodes
Étant donné la liste des nœuds racines (noms), classez les nœuds (racine = 0)

[ renvoie un entier ] ibdmReportNonUpDownCa2CaPaths p_fabric rootNodes
Analyser les routes pour s'assurer que la règle Up/Down est maintenue

[ renvoie un entier ] ibdmCheckMulticastGroups p_fabric
Vérifier la connectivité du routage multidiffusion

[ renvoie un entier ] ibdmCheckFabricMCGrpsForCreditLoopPotential p_fabric rootNodes
Analyser le routage multicast pour s'assurer qu'il obéit à la règle Up/Down

[ renvoie un entier ] ibdmLinkCoverageAnalysis p_fabric rootNodes
Préparez un programme de transmission à partir d'un ensemble de sources vers des destinations telles que
à chaque étape, il n'y a pas de liens surabonnés et après toutes les étapes, tous
les maillons du tissu ont été excisés

Traçant Utilitaires

Ces fonctions permettent de tracer les chemins en rapportant les nœuds visités

[ renvoie un entier ] ibdmTraceDRPathRoute p_smNodePort drPathPortNums
Tracer un chemin de route dirigé à partir du port donné

[ renvoie un entier ] ibdmTraceRouteByMinHops p_fabric slid dlid
Tracez un chemin le long du MinHop de la source aux LID de destination

[ renvoie un entier ] ibdmTraceRouteByLFT p_fabric slid dlid saute p_nodesList
Tracer un chemin suivant la LFT mettant à jour les variables de liste de sauts et de nœuds

topologie Des Utilitaires

Les utilitaires suivants correspondent à deux matrices fournissant à la fois des messages de non-concordance et un
tissu unifié

[ renvoie un entier ] ibdmMatchFabrics p_spec_fabric p_discovered_fabric anchorNodeName
ancrePortNum ancrePortGuid
Faire correspondre une structure basée sur la topologie avec une structure découverte en commençant au port d'ancrage

[ renvoie un entier ] ibdmBuildMergedFabric p_spec_fabric p_discovered_fabric p_merged_fabric
Après la correspondance à l'aide d'ibdmMatchFabrics, remplissez le "tissu fusionné" avec des informations
fusionné pour les nœuds appariés

Congestion Utilitaires

Offrir la possibilité de suivre et de signaler le surabonnement aux liens

[ renvoie un entier ] ibdmCongInit p_fabric
Initialiser le système de suivi

[ renvoie un entier ] ibdmCongCleanup p_fabric
Nettoyer les compteurs et désallouer

[ renvoie un entier ] ibdmCongClear p_fabric
Compteurs de nettoyage

[ renvoie un entier ] ibdmCongTrace p_fabric srcLid dstLid
Tracer un chemin entre les LID mettant à jour les informations d'utilisation du lien

[ renvoie un entier ] ibdmCongReport p_fabric
Signaler les informations de congestion résultantes

[ renvoie un entier ] ibdmCongDump p_fabric
Vider toutes les informations de suivi de congestion

Utiliser ibdmsh en ligne à l'aide des services onworks.net