ibdmsh - Online in de cloud

PROGRAMMA:

NAAM

ibdmsh IB DATA MODEL - Uitgebreide TCL-shell

PRODUCTBESCHRIJVING

ibdmsh is een TCL-shell uitgebreid met een interface voor het IB-datamodel. Om deze schaal te gebruiken
je schrijft TCL-code die rechtstreeks toegang heeft tot de IB-datamodelobjecten en -functies.

De volgende subsecties bieden een gedetailleerde definitie van deze objecten en API.

IBDM constanten

Knooppunt Types

De volgende constanten worden gebruikt door het veld knooppuntobjecttype

[ Constante : int ] $IB_UNKNOWN_NODE_TYPE = IB_UNKNOWN_NODE_TYPE

[ Constante : int ] $IB_SW_NODE = IB_SW_NODE

[ Constante : int ] $IB_CA_NODE = IB_CA_NODE

Log Breedsprakigheid Vlaggen

De volgende constanten worden gebruikt als argumentbits voor de globale variabele
$FabricUtilsVerboseLevel

[Constante: int] $FABU_LOG_NONE = 0x0

[Constante: int] $FABU_LOG_ERROR = 0x1

[Constante: int] $FABU_LOG_INFO = 0x2

[ Constante : int ] $FABU_LOG_VERBOSE = 0x4

IBDM Globals

Logniveau: ingesteld op FABU_LOG*-waarden

[Globaal: int] $FabricUtilsVerboseLevel

IBDM Objecten

In deze sectie worden de verschillende objecttypen beschreven die door IBDM worden getoond.

IBDM legt enkele van zijn interne objecten bloot. De object-ID's die door de verschillende zijn geretourneerd
functieaanroepen worden opgemaakt volgens de volgende regels:

Stof: stof:

Systeem: systeem: :

SysPort: sysport: : :

Knooppunt: knooppunt: :

Poort: poort: : /

IBDM-objecten zijn standaard Swig-Tcl-objecten. Als zodanig hebben ze twee smaken voor hun gebruik:
Variabelen, objecten.

Variabelen/aanwijzers:
Voor elk objectattribuut zijn de methoden "get" en "set" beschikbaar.
Het formaat van de methoden is: _ _ .
De "set"-methode is alleen beschikbaar voor lees-/schrijfattributen.

Voorbeeld:
knooppunten instellen [ibdm_get_nodes]
knooppunt instellen [lindex $knooppunten 0]
IBNode_numPorts_get $node

Voorwerpen:
Gegeven een objectaanwijzer kan men deze converteren naar een Tcl "Object"
met behulp van de volgende opdracht:
-dit

Eenmaal verklaard de kan worden gebruikt in combinatie met
met de standaard "configure" en "cget" commando's.

Voorbeeld (na het vorige):
IBFabric VaTech -deze $stof
VaTech cget -NodeByName

Om een ​​objectsymbool te verwijderen (en de toewijzing ervan aan een ander symbool in te schakelen
aanwijzer) gebruik:
hernoemen ""
bijvoorbeeld:
hernoem VaTech ""

klasse IB-poort

Hieronder volgen de verschillende velden en methoden van de klasse IB Port die een
Fysieke poort van IB-apparaat (chip).

[ Lidgegevens: retourneert IBPort * ] -p_remotePort
Poort aangesloten aan de andere kant van de link

[ Lidgegevens: retourneert IBSysPort * ] -p_sysPort
De systeempoort (indien aanwezig) waarmee verbinding is gemaakt

[ Lidgegevens: retourneert IBNode * ] -p_node
Het knooppunt waarvan de poort deel uitmaakt.

[ Lidgegevens: retourneert int ] -num
Fysieke poorten worden geïdentificeerd aan de hand van een nummer.

[ Lidgegevens: retourneert niet-ondertekende int ] -base_lid
Het basisdeksel dat aan de poort is toegewezen.

[ Lidgegevens: retourneert IBLinkWidth * ] -breedte
De linkbreedte van de poort

[ Lidgegevens: retourneert IBLinkSpeed ​​* ] -snelheid
De verbindingssnelheid van de poort

[ Lidgegevens: retourneert niet-ondertekende int ] -counter1
Een generieke waarde die door verschillende algoritmen kan worden gebruikt

[ Constructor: retourneert IBPort * ] IBPort-naam p_nodePtr-nummer
IBPort-constructor

[ Lid: retourneert new_uint64_t ] guid_get
Verkrijg de gids van de haven

[ Lid: retourneert ongeldig ] guid_set guid
Wijzig de gids van de poort

[ Lid: retourneert nieuwe_string ] getName
Haal de poortnaam op: Een apparaatpoort die is aangesloten op de systeempoort (voorpaneel) keert terug
de poortnaam op het voorpaneel.

[ Lid: retourneert ongeldig ] connect p_otherPort ?width? ?snelheid?
Verbind de poort met een andere knooppuntpoort met optionele breedte- en snelheidsparameters

[ Lid : retourneert int ] verbreek de verbinding
Koppel de poort los. Retourneert 0 indien succesvol

klasse IBNod

De IB Node-klasse vertegenwoordigt een enkel IB-apparaat (chip)

[ Lidgegevens: retourneert string * ] -naam
Naam van het knooppunt (instantienaam van de chip)

[ Lidgegevens: retourneert IBNodeType ] -type
Ofwel een $IB_SW_NODE of $IB_CA_NODE

[ Lidgegevens: retourneert uint16_t * ] -devId
De apparaat-ID van het knooppunt

[ Lidgegevens: retourneert uint16_t * ] -revId
De revisie-ID van het apparaat.

[ Lidgegevens: retourneert uint16_t * ] -vendId
De leverancier-ID van het apparaat.

[ Lidgegevens: retourneert string * ] -attributen
Komma-sep-reeks van willekeurige attributen k=v

[ Lidgegevens: retourneert uint8_t ] -rang
De rang van het knooppunt (0 is een wortel)

[ Lidgegevens: retourneert IBSystem * ] -p_system
Tot welk systeem wij behoren

[ Lidgegevens: retourneert IBFabric * ] -p_fabric
Tot welke stof wij behoren.

[ Lidgegevens: retourneert niet-ondertekende int ] -numPorts
Aantal fysieke poorten

[ Lidgegevens: retourneert vec_pport * ] -Poorten
Vector van alle poorten

[ Lidgegevens: retourneert vec_vec_byte * ] -MinHopsTable
Een tabel met het aantal hops dat nodig is om van elke poort naar elke doel-LID te komen

[ Lidgegevens: retourneert vec_byte * ] -LFT
De LFT van dit knooppunt (alleen voor schakelaars), een lange vector van doelpoorten -
index is het deksel

[ Lid: retourneert new_uint64_t ] guid_get
Haal de knooppunt-GUID op

[ Lid: retourneert ongeldig ] guid_set guid
Stel de knooppunt-GUID in

[ Constructor: retourneert IBNode * ] IBNode-naam n p_fab p_sys t np
Aannemer

[ Lid : retourneert IBPort * ] makePort num
Maak een nieuwe poort aan op basis van het nummer (indien nodig) en retourneer de poortaanwijzer

[ Lid : retourneert IBPort * ] getPort num
Verkrijg een poort op nummer num = 1..N:

[ Lid: retourneert ongeldig ] setHops p_port lid hop
Stel de min hop in voor het gegeven poortdekselpaar (* is alles).

[ Lid: retourneert int ] getHops p_port lid
Haal het minimale aantal hops op dat is gedefinieerd voor de gegeven poort of allemaal

[ Lid: retourneert IBPort * ] getFirstMinHopPort-deksel
Scan de knooppuntpoorten en vind de eerste poort met min hop naar het deksel

[ Lid: retourneert ongeldig ] setLFTPortForLid deksel portNum
Stel de lineaire doorstuurtabel in voor het gegeven LID

[ Lid: retourneert int ] getLFTPortForLid deksel
Haal de LFT op voor een bepaald LID

[ Lid: retourneert ongeldig ] repHopTable
Dump de min-hop-tabel van het knooppunt

klasse IBSysPort

De IBSysPort-klasse vertegenwoordigt een IB-stekker op de voor- of achterpanelen van het systeem

[ Lidgegevens: retourneert string * ] -naam
De naam op het voorpaneel (zijde) van de poort

[ Lidgegevens: retourneert IBSysPort * ] -p_remoteSysPort
Indien aangesloten op de systeempoort aan de andere kant

[ Lidgegevens: retourneert IBSystem * ] -p_system
Systeem waar het om draait

[ Lidgegevens: retourneert IBPort * ] -p_nodePort
De knooppuntpoort waarmee het verbinding maakt.

[ Constructor: retourneert IBSysPort * ] IBSysPort-naam n p_sys
Constructeur

[ Lid: retourneert ongeldig ] connect p_otherSysPort ?width? ?snelheid?
Sluit twee SysPorts aan

[ Lid : retourneert int ] verbreek de verbinding
Koppel de SysPort (en poorten) los. Retourneert 0 indien succesvol

klasse IB-systeem

De IBSystem-klasse vertegenwoordigt een volledig chassis

[ Lidgegevens: retourneert string * ] -naam
De "host"-naam van het systeem

[ Lidgegevens: retourneert tekenreeks * ] -type
Wat is het type dwz Cougar, Buffalo, MTS2400, etc. Een bijbehorend IBNL-bestand
zou moeten bestaan ​​- dit systeemtype definiëren

[ Lidgegevens: retourneert IBFabric * ] -p_fabric
Fabric waartoe het systeem behoort

[ Lidgegevens: retourneert map_str_pnode * ] -NodeByName
Geef de knooppuntaanwijzer op bij de naam

[ Lidgegevens: retourneert map_str_psysport * ] -PortByName
Een kaartverstrekkingsaanwijzer naar de SysPort op naam

[ Constructor: retourneert IBSystem * ] IBSystem-naam n p_fab t
Aannemer

[ Lid: retourneert new_uint64_t ] guid_get
Verkrijg de systeemimage-GUID

[ Lid: retourneert ongeldig ] guid_set guid
Stel de systeemimage-GUID in

[ Lid: retourneert IBSysPort * ] makeSysPort pName
Zorg ervoor dat we de poort hebben gedefinieerd (dus definieer deze als dat niet het geval is)

[ Lid: retourneert IBPort * ] getSysPortNodePortByName sysPortName
Haal de knooppuntpoort voor de opgegeven systeempoort op naam op

[ Lid : retourneert IBSysPort * ] getSysPort-naam
Verkrijg een Sys-poort op naam

klasse IBStof

Vertegenwoordigt een volledig IB-subnet dat uit systemen bestaat

[ Lidgegevens: retourneert map_str_pnode * ] -NodeByName
Geef een lijst met knooppuntnamen en aanwijzerparen op

[ Lidgegevens: retourneert map_str_psys * ] -SystemByName
Geef een lijst met systeemnamen en aanwijzerparen op

[ Lidgegevens: retourneert vec_pport * ] -PortByLid
Biedt een lijst met systeempoortnamen en pointerparen

[ Lidgegevens: retourneert map_guid_pnode * ] -NodeByGuid
Biedt een lijst met knooppunt-GUID- en knooppuntaanwijzerparen

[ Lidgegevens: retourneert map_guid_psys * ] -SystemByGuid
Biedt een lijst met systeemimage-GUID en systeemaanwijzerparen

[ Lidgegevens: retourneert map_guid_pport * ] -PortByGuid
Biedt een lijst met poort-GUID- en poortaanwijzerparen

[ Lidgegevens: retourneert niet-ondertekende int ] -minLid
Track min-deksel gebruikt.

[ Lidgegevens: retourneert niet-ondertekende int ] -maxLid
Track max-deksel gebruikt.

[ Lidgegevens: retourneert niet-ondertekende int ] -lmc
LMC-waarde gebruikt

[ Lid: retourneert IBNode * ] makeNode n p_sys type numPorts
Haal het knooppunt op bij zijn naam (maak er een aan die niet bestaat)

[ Lid : retourneert IBNode * ] getNode-naam
Haal het knooppunt op de naam ervan

[ Lid: retourneert list_pnode * ] getNodesByType type
Retourneert de lijst met knooppuntaanwijzers die overeenkomen met het vereiste type

[ Lid : retourneert IBSystem * ] makeGenericSystem-naam
Creëer een nieuw generiek systeem - in feite een lege container voor knooppunten...

[ Lid : retourneert IBSystem * ] makeSystem-naamtype
Maak een nieuw systeem aan - het type moet een geregistreerde fabriek hebben.

[ Lid : retourneert IBSystem * ] getSystem-naam
Systeem op naam ophalen

[ Lid: retourneert IBSystem * ] getSystemByGuid guid
verkrijg het systeem door zijn gids

[ Lid: retourneert IBNode * ] getNodeByGuid guid
haal het knooppunt op via zijn gids

[ Lid: retourneert IBPort * ] getPortByGuid guid
verkrijg de haven door zijn gids

[ Lid: retourneert ongeldig ] addCable t1 n1 p1 t2 n2 p2 ?breedte? ?snelheid?
Voegt een kabel toe met twee sets knooppunttype, knooppuntnaam en poortnummer. Optioneel
gebruik een bepaalde breedte en snelheid voor de verbinding

[ Lid: retourneert int ] parseCables fn
Parseer het kabelsbestand en bouw de structuur

[Lid: retourneert int] parseTopology fn
Parseer het topologiebestand en bouw de structuur

[ Lid: retourneert int ] addLink type1 numPorts1 sysGuid1 nodeGuid1 portGuid1 vend1
devId1 rev1 desc1 lid1 poortNum1 type2 numPorts2 sysGuid2 knooppuntGuid2 poortGuid2 vend2 devId2
rev2 desc2 lid2 poortNum2 ?breedte? ?snelheid?
Voeg een link toe aan de fabric - hierdoor worden indien nodig systemen en knooppunten gemaakt.

[ Lid: retourneert int ] parseSubnetLinks fn
Parseer het OpenSM subnet.lst-bestand en bouw er de fabric van.

[ Lid: retourneert int ] parseFdbFile fn
Parseer het OpenSM FDB-dumpbestand en vul de LFT-tabellen van de schakelaars in

[ Lid: retourneert int ] parseMCFdbFile fn
Parseer een OpenSM MCFDBs-bestand en stel de MFT-tabel dienovereenkomstig in

[Lid: retourneert int] parsePSLFile fn
Parseer het pad naar het SL-toewijzingsbestand. Elke regel met: src_node_guid DLID SL

Gebruikt bij kredietcontrole

[Lid: retourneert int] parseSLVLFile fn
Parseer het SLVL-tabellenbestand. Elke regel bevat: sw_node_guid in_port out_port 0x(sl0)(sl1)
0x(sl2)(sl3)...

[ Lid: retourneert ongeldig ] setLidPort lid p_port
Stel een dekselpoort in

[ Lid: retourneert IBPort * ] getPortByLid-deksel
Koop een poort per deksel

[ retourneert IBFabric * ] new_IBFabric
Maak een nieuwe stof

[ retourneert ongeldig ] delete_IBFabric p_fabric
Vernietig een stof

IBDM Functies

In deze sectie vindt u details over de functies die IBDM beschikbaar stelt. De volgorde volgt de
verwachte volgorde in een reguliere IBDM-stroom. Ze retourneren allemaal 0 bij succes.

subnet Nutsbedrijven

Het bestand bevat een reeks hulpprogramma's die op het subnet moeten worden uitgevoerd om de OpenSM-initialisatie na te bootsen
en analyseer de resultaten:

[ retourneert int ] ibdmAssignLids p_smNodePort?lmc?
LID's toewijzen met een optionele LMC (meerdere LID's per poort)

[ retourneert int ] ibdmCalcMinHopTables p_fabric
Bereken en vul de MinHopTables in die nodig zijn voor het uitvoeren van OpenSM-routering.

[ retourneert int ] ibdmCalcUpDnMinHopTbls p_fabric rootNodesNameRex
Bereken en vul de MinHopTables in volgens de Up/Down-regel.

[ retourneert int ] ibdmOsmRoute p_fabric
Leid de stof met routering in OpenSM-stijl

[ retourneert int] ibdmEnhancedRoute p_fabric
Leid de stof met routering in OpenSM-stijl, verbeterd met betere ondersteuning voor LMC > 0

[ retourneert int ] ibdmFatTreeRoute p_fabric rootNodes
Leid de stof met behulp van een algoritme dat alleen op volvette bomen past

[ retourneert int ] ibdmFatTreeAnalysis p_fabric
Analyseer de stof om te zien of het een dikke boom is en leid deze als dat het geval is

[ retourneert int ] ibdmVerifyCAtoCARoutes p_fabric
Zorg ervoor dat alle (H)CA's met elkaar zijn verbonden op basis van de LFT-instellingen

[ retourneert int] ibdmVerifyAllPaths p_fabric
Zorg ervoor dat alle Switches en (H)CA’s op basis van de LFT met elkaar zijn verbonden
settings

[ retourneert int] ibdmAnalyzeLoops p_fabric
Een strenge controle op kredietlussen. Dit algoritme voert een volledige en nauwkeurige controle uit
maar de rapportage over kredietlooppaden is moeilijk te interpreteren. Als je de wortels kent
van de boom (of als de boom symmetrisch is), verdient het de voorkeur om de
ibdmRapportNonUpDownCa2CaPaths

[ retourneert list_pnode ] ibdmFindSymmetricalTreeRoots p_fabric
Analyseer de boomtopologie en vind de wortels van de boom op basis van zijn symmetrie

[ retourneert list_pnode ] ibdmFindRootNodesByMinHop p_fabric
Zoek op basis van de MinHopTable de wortels van de boom. Een asymmetrie van 5% is toegestaan

[ retourneert int ] ibdmRankFabricByRoots p_fabric rootNodes
Gegeven de lijst met wortelknooppunten (namen), rangschikt u de knooppunten (wortel = 0)

[ retourneert int ] ibdmReportNonUpDownCa2CaPaths p_fabric rootNodes
Analyseer de routes om er zeker van te zijn dat de Up/Down-regel wordt gehandhaafd

[ retourneert int ] ibdmCheckMulticastGroups p_fabric
Controleer de connectiviteit van multicast-routering

[ retourneert int ] ibdmCheckFabricMCGrpsForCreditLoopPotential p_fabric rootNodes
Analyseer multicast-routering om er zeker van te zijn dat deze voldoet aan de Up/Down-regel

[ retourneert int ] ibdmLinkCoverageAnalysis p_fabric rootNodes
Bereid een schema voor voor verzending van een reeks bronnen naar bestemmingen, zodat
in elke fase zijn er geen links die overbelast zijn en tenslotte allemaal
de schakels van de stof werden geoefend

Tracing Nutsbedrijven

Met deze functies kunnen paden worden gevolgd die de bezochte knooppunten rapporteren

[ retourneert int ] ibdmTraceDRPAthRoute p_smNodePort drPathPortNums
Traceer een gericht routepad vanaf de gegeven haven

[ retourneert int ] ibdmTraceRouteByMinHops p_fabric slid dlid
Traceer een pad langs de MinHop van de bron- naar de bestemmings-LID's

[ retourneert int ] ibdmTraceRouteByLFT p_fabric gleed dlid hop p_nodesList
Traceer een pad dat de LFT volgt en de hop- en knooppuntlijstvariabelen bijwerkt

topologie Bijpassende Nutsbedrijven

De volgende hulpprogramma's matchen twee fabrics die zowel mismatch-berichten leveren als a
uniforme stof

[ retourneert int ] ibdmMatchFabrics p_spec_fabric p_discovered_fabric anchorNodeName
anchorPortNum anchorPortGuid
Match een op topologie gebaseerd weefsel met een ontdekt weefsel dat begint bij de ankerpoort

[ retourneert int ] ibdmBuildMergedFabric p_spec_fabric p_discovered_fabric p_merged_fabric
Na het matchen met ibdmMatchFabrics vult u de "merged fabric" in met informatie
samengevoegd voor de overeenkomende knooppunten

Congestie Analyse Nutsbedrijven

Bied de mogelijkheid om overabonnement op links bij te houden en te rapporteren

[ retourneert int ] ibdmCongInit p_fabric
Initialiseer het volgsysteem

[ retourneert int ] ibdmCongCleanup p_fabric
Ruim de tellers op en maak de toewijzing ongedaan

[ retourneert int ] ibdmCongClear p_fabric
Tellers opruimen

[ retourneert int ] ibdmCongTrace p_fabric srcLid dstLid
Traceer een pad tussen de LID's en update de gebruiksinformatie van de link

[ retourneert int ] ibdmCongReport p_fabric
Rapporteer de resulterende congestie-informatie

[ retourneert int ] ibdmCongDump p_fabric
Dump alle informatie over het volgen van congestie

Gebruik ibdmsh online met behulp van onworks.net-services