ibdmsh: en línea en la nube

PROGRAMA:

NOMBRE

ibdmsh MODELO DE DATOS IB - Carcasa TCL extendida

DESCRIPCIÓN

ibdmsh es un shell TCL ampliado con interfaz para el modelo de datos IB. Para usar este caparazón
escribirá código TCL que acceda directamente a los objetos y funciones del modelo de datos IB.

Las siguientes subsecciones proporcionan una definición detallada para esos objetos y API.

IBDM Constantes

Nodo Tipos

El campo de tipo de objeto de nodo utiliza las siguientes constantes

[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 Verbosidad Banderas

Las siguientes constantes se utilizan como bits de argumento para la variable global
$ 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 Globales

Nivel de registro: establecido en valores FABU_LOG *

[Global: int] $ FabricUtilsVerboseLevel

IBDM Objetos

Esta sección describe los diversos tipos de objetos expuestos por IBDM.

IBDM expone algunos de sus objetos internos. Los identificadores de objetos devueltos por los distintos
Las llamadas a funciones se formatean de acuerdo con las siguientes reglas:

Tejido: tejido:

Sistema: sistema: :

SysPort: sysport: : :

Nodo: nodo: :

Puerto: puerto: : /

Los Objetos IBDM son objetos Swig-Tcl estándar. Como tal, tienen dos sabores para su uso:
Variables, Objetos.

Variables / Punteros:
Para cada atributo de objeto, se proporcionan los métodos "get" y "set".
El formato de los métodos es: _ _ .
El método "set" solo está disponible para atributos de lectura / escritura.

Ejemplo:
establecer nodos [ibdm_get_nodes]
establecer nodo [lindex $ nodos 0]
IBNode_numPorts_get $ nodo

Objetos:
Dado un puntero de objeto, uno puede convertirlo en un "Objeto" Tcl
usando el siguiente comando:
-esta

Una vez declarado el se puede utilizar junto con
con los comandos estándar "configure" y "cget".

Ejemplo (siguiendo al anterior):
IBFabric VaTech -este $ tejido
VaTech cget -NodoPorNombre

Para eliminar un símbolo de objeto (y habilitar su mapeo a otro
puntero) uso:
rebautizar ""
por ejemplo:
cambiar el nombre de VaTech ""

clase Puerto IB

Los siguientes son los diferentes campos y métodos de la clase de puerto IB que describe un
Puerto físico del dispositivo IB (chip).

[Datos del miembro: devuelve IBPort *] -p_remotePort
Puerto conectado al otro lado del enlace

[Datos del miembro: devuelve IBSysPort *] -p_sysPort
El puerto del sistema (si lo hay) conectado a

[Datos del miembro: devuelve IBNode *] -p_node
El nodo del que forma parte el puerto.

[Datos del miembro: devuelve int] -num
Los puertos físicos se identifican por número.

[Datos del miembro: devuelve un int sin firmar] -base_lid
La tapa de la base asignada al puerto.

[Datos del miembro: devuelve IBLinkWidth *] -width
El ancho del enlace del puerto.

[Datos del miembro: devuelve IBLinkSpeed ​​*] -speed
La velocidad de enlace del puerto.

[Datos del miembro: devuelve el int sin firmar] -counter1
Un valor genérico para ser utilizado por varios algoritmos.

[Constructor: devuelve IBPort *] Nombre de IBPort p_nodePtr número
Constructor de IBPort

[Miembro: devuelve new_uint64_t] guid_get
Obtén la guía del puerto

[Miembro: devuelve void] guid_set guid
Modificar la guía del puerto.

[Miembro: devuelve new_string] getName
Obtener el nombre del puerto: devuelve un puerto de dispositivo conectado al puerto del sistema (panel frontal)
el nombre del puerto del panel frontal.

[Miembro: devuelve vacío] conectar p_otherPort? Width? ?¿velocidad?
Conecte el puerto a otro puerto de nodo con parámetros opcionales de ancho y velocidad

[Miembro: devuelve int] desconectar
Desconecte el puerto. Devuelve 0 si tiene éxito

clase IBNodo

La clase de nodo IB representa un solo dispositivo IB (chip)

[Datos del miembro: devuelve cadena *] -name
Nombre del nodo (nombre de instancia del chip)

[Datos del miembro: devuelve IBNodeType] -type
Ya sea un $ IB_SW_NODE o $ IB_CA_NODE

[Datos del miembro: devuelve uint16_t *] -devId
El ID de dispositivo del nodo

[Datos del miembro: devuelve uint16_t *] -revId
El Id. De revisión del dispositivo.

[Datos del miembro: devuelve uint16_t *] -vendId
El ID del proveedor del dispositivo.

[Datos del miembro: devuelve cadena *] -attributes
Cadena de coma-sep de atributos arbitrarios k = v

[Datos del miembro: devuelve uint8_t] -rank
El rango del nodo (0 es una raíz)

[Datos del miembro: devuelve IBSystem *] -p_system
A que sistema pertenecemos

[Datos del miembro: devuelve IBFabric *] -p_fabric
A qué tejido pertenecemos.

[Datos del miembro: devuelve int sin firmar] -numPorts
Cantidad de puertos físicos

[Datos de miembros: devuelve vec_pport *] -Ports
Vector de todos los puertos

[Datos del miembro: devuelve vec_vec_byte *] -MinHopsTable
Una tabla de la cantidad de saltos necesarios para llegar de cada puerto a cada LID de destino

[Datos del miembro: devuelve vec_byte *] -LFT
La LFT de este nodo (solo para conmutadores), que es un vector largo de puertos de destino:
el índice es la TAPA

[Miembro: devuelve new_uint64_t] guid_get
Obtenga el GUID del nodo

[Miembro: devuelve void] guid_set guid
Establecer el GUID del nodo

[Constructor: devuelve IBNode *] IBNode nombre n p_fab p_sys t np
contratista

[Miembro: devuelve IBPort *] makePort num
Cree un nuevo puerto por su número (si es necesario) devuelva el puntero del puerto

[Miembro: devuelve IBPort *] getPort num
Obtener un puerto por número num = 1..N:

[Miembro: devuelve void] setHops p_port lid hops
Establezca el salto mínimo para el par de tapas de puerto dado (* es todo)

[Miembro: devuelve int] getHops p_port lid
Obtenga el número mínimo de saltos definido para el puerto dado o todos

[Miembro: devuelve IBPort *] getFirstMinHopPort tapa
Escanee los puertos del nodo y encuentre el primer puerto con min hop a la tapa

[Miembro: devuelve vacío] setLFTPortForLid lid portNum
Establecer la tabla de reenvío lineal para la LID dada

[Miembro: devuelve int] getLFTPortForLid lid
Obtenga el LFT para una LID determinada

[Miembro: devuelve vacío] repHopTable
Vaciar la tabla de min hop del nodo

clase IBSysPort

La clase IBSysPort representa un conector IB en los paneles frontal o posterior del sistema

[Datos del miembro: devuelve cadena *] -name
El nombre del panel frontal (seda) del puerto.

[Datos del miembro: devuelve IBSysPort *] -p_remoteSysPort
Si está conectado al otro puerto del sistema lateral

[Datos del miembro: devuelve IBSystem *] -p_system
Sistema al que pertenece

[Datos del miembro: devuelve IBPort *] -p_nodePort
El puerto de nodo al que se conecta.

[Constructor: devuelve IBSysPort *] Nombre de IBSysPort n p_sys
Constructor

[Miembro: devuelve vacío] conectar p_otherSysPort? Width? ?¿velocidad?
Conecte dos SysPorts

[Miembro: devuelve int] desconectar
Desconecte el SysPort (y los puertos). Devuelve 0 si tiene éxito

clase Sistema IB

La clase IBSystem representa un chasis completo

[Datos del miembro: devuelve cadena *] -name
El nombre de "host" del sistema

[Datos del miembro: devuelve el tipo de cadena *]
¿De qué tipo es, es decir, Cougar, Buffalo, MTS2400, etc. Un archivo IBNL correspondiente?
debería existir - definiendo este tipo de sistema

[Datos del miembro: devuelve IBFabric *] -p_fabric
Tejido al que pertenece el sistema

[Datos del miembro: devuelve map_str_pnode *] -NodeByName
Proporcione el puntero de nodo por su nombre

[Datos del miembro: devuelve map_str_psysport *] -PortByName
Un mapa que proporciona un puntero al SysPort por nombre

[Constructor: devuelve IBSystem *] IBSystem nombre n p_fab t
contratista

[Miembro: devuelve new_uint64_t] guid_get
Obtenga el GUID de la imagen del sistema

[Miembro: devuelve void] guid_set guid
Establecer el GUID de la imagen del sistema

[Miembro: devuelve IBSysPort *] makeSysPort pName
Asegúrese de que tenemos el puerto definido (así que defínalo si no es así)

[Miembro: devuelve IBPort *] getSysPortNodePortByName sysPortName
Obtenga el puerto de nodo para el puerto del sistema dado por nombre

[Miembro: devuelve IBSysPort *] nombre de getSysPort
Obtener un puerto del sistema por nombre

clase IBFábrica

Representa una subred IB completa compuesta por sistemas

[Datos del miembro: devuelve map_str_pnode *] -NodeByName
Proporcionar una lista de pares de punteros y nombres de nodo

[Datos del miembro: devuelve map_str_psys *] -SystemByName
Proporcionar una lista de pares de punteros y nombres del sistema

[Datos del miembro: devuelve vec_pport *] -PortByLid
Proporciona una lista de pares de punteros y nombres de puertos del sistema

[Datos del miembro: devuelve map_guid_pnode *] -NodeByGuid
Proporciona una lista de pares de punteros de nodo y guid de nodo

[Datos del miembro: devuelve map_guid_psys *] -SystemByGuid
Proporciona una lista de pares de punteros de sistema y guid de imagen del sistema

[Datos del miembro: devuelve map_guid_pport *] -PortByGuid
Proporciona una lista de pares de puntero de puerto y guid de puerto

[Datos del miembro: devuelve unsigned int] -minLid
Seguimiento mínimo de la tapa utilizada.

[Datos del miembro: devuelve un int sin firmar] -maxLid
Seguimiento de la tapa máxima utilizada.

[Datos del miembro: devuelve un int sin firmar] -lmc
Valor de LMC utilizado

[Miembro: devuelve IBNode *] makeNode n p_sys tipo numPorts
Obtener el nodo por su nombre (crear uno de no existe)

[Miembro: devuelve IBNode *] nombre getNode
Obtenga el nodo por su nombre

[Miembro: devuelve list_pnode *] tipo getNodesByType
Devuelve la lista de punteros de nodo que coinciden con el tipo requerido

[Miembro: devuelve IBSystem *] nombre makeGenericSystem
Cree un nuevo sistema genérico, básicamente un contenedor vacío para nodos ...

[Miembro: devuelve IBSystem *] makeSystem tipo de nombre
Cree un nuevo sistema: el tipo debe tener una fábrica registrada.

[Miembro: devuelve IBSystem *] getSystem name
Obtener sistema por nombre

[Miembro: devuelve IBSystem *] getSystemByGuid guid
obtener el sistema por su guía

[Miembro: devuelve IBNode *] getNodeByGuid guid
obtener el nodo por su guid

[Miembro: devuelve IBPort *] getPortByGuid guid
obtener el puerto por su guía

[Miembro: devuelve vacío] addCable t1 n1 p1 t2 n2 p2? Width? ?¿velocidad?
Agrega un cable con dos conjuntos de tipo de nodo, nombre de nodo y número de puerto. Opcionalmente
utilizar un ancho y una velocidad determinados para la conexión

[Miembro: devuelve int] parseCables fn
Analice el archivo de cables y construya la tela

[Miembro: devuelve int] parseTopology fn
Analizar el archivo de topología y crear la estructura

[Miembro: devuelve int] addLink type1 numPorts1 sysGuid1 nodeGuid1 portGuid1 vend1
devId1 rev1 desc1 lid1 portNum1 tipo2 numPorts2 sysGuid2 nodeGuid2 portGuid2 vend2 devId2
rev2 desc2 lid2 portNum2? ancho? ?¿velocidad?
Agregue un enlace a la estructura: esto creará el sistema y los nodos según sea necesario.

[Miembro: devuelve int] parseSubnetLinks fn
Analice el archivo OpenSM subnet.lst y cree el tejido a partir de él.

[Miembro: devuelve int] parseFdbFile fn
Analizar el archivo de volcado de OpenSM FDB y completar las tablas LFT de los conmutadores

[Miembro: devuelve int] parseMCFdbFile fn
Analice un archivo OpenSM MCFDBs y configure la tabla MFT en consecuencia

[Miembro: devuelve int] parsePSLFile fn
Analizar la ruta al archivo de mapeo SL. Cada línea con: src_node_guid DLID SL

Utilizado por verificación de ciclo de crédito

[Miembro: devuelve int] parseSLVLFile fn
Analizar archivo de tablas SLVL. Cada línea contiene: sw_node_guid in_port out_port 0x (sl0) (sl1)
0x (sl2) (sl3) ...

[Miembro: devuelve vacío] setLidPort lid p_port
Establecer un puerto de tapa

[Miembro: devuelve IBPort *] getPortByLid lid
Consigue un puerto por tapa

[devuelve IBFabric *] new_IBFabric
Construye una nueva tela

[devuelve vacío] delete_IBFabric p_fabric
Destruye una tela

IBDM Clave

Esta sección proporciona los detalles sobre las funciones que expone IBDM. El orden sigue el
orden esperado en un flujo IBDM regular. Todos devuelven 0 en caso de éxito.

Subred Departamento de Servicios Públicos

El archivo contiene un conjunto de utilidades que se ejecutarán en la subred para imitar la inicialización de OpenSM.
y analizar los resultados:

[devuelve int] ibdmAssignLids p_smNodePort? lmc?
Asignar LID con un LMC opcional (múltiples LID por puerto)

[devuelve int] ibdmCalcMinHopTables p_fabric
Calcule y complete las MinHopTables necesarias para ejecutar el enrutamiento de estilo OpenSM.

[devuelve int] ibdmCalcUpDnMinHopTbls p_fabric rootNodesNameRex
Calcule y complete las MinHopTables siguiendo la regla Arriba / Abajo.

[devuelve int] ibdmOsmRoute p_fabric
Enrute la tela con enrutamiento estilo OpenSM

[devuelve int] ibdmEnhancedRoute p_fabric
Enrute el tejido con enrutamiento estilo OpenSM mejorado con mejor soporte para LMC> 0

[devuelve int] ibdmFatTreeRoute p_fabric rootNodes
Enrute la tela utilizando un algoritmo que se ajusta solo a árboles completos

[devuelve int] ibdmFatTreeAnalysis p_fabric
Analice la tela para ver si es un árbol gordo y enrute si es

[devuelve int] ibdmVerifyCAtoCARoutes p_fabric
Asegúrese de que todas las CA (H) estén conectadas entre sí según la configuración de LFT

[devuelve int] ibdmVerifyAllPaths p_fabric
Asegúrese de que todos los conmutadores y CA (H) estén conectados entre sí según la LFT
ajustes

[devuelve int] ibdmAnalyzeLoops p_fabric
Una verificación rigurosa de los bucles de crédito. Este algoritmo realiza una verificación completa y precisa
pero es difícil interpretar su información sobre las rutas del circuito de crédito. Si conoces las raíces
del árbol (o el árbol es simétrico) es preferible utilizar el
ibdmReportNonUpDownCa2CaPaths

[devuelve list_pnode] ibdmFindSymmetricalTreeRoots p_fabric
Analizar la topología del árbol y encontrar las raíces del árbol según su simetría.

[devuelve list_pnode] ibdmFindRootNodesByMinHop p_fabric
Con base en MinHopTable, encuentre las raíces del árbol. Se permite una asimetría del 5%

[devuelve int] ibdmRankFabricByRoots p_fabric rootNodes
Dada la lista de nodos raíz (nombres), clasifique los nodos (raíz = 0)

[devuelve int] ibdmReportNonUpDownCa2CaPaths p_fabric rootNodes
Analice las rutas para asegurarse de que se mantenga la regla Arriba / Abajo

[devuelve int] ibdmCheckMulticastGroups p_fabric
Verificar la conectividad del enrutamiento de multidifusión

[devuelve int] ibdmCheckFabricMCGrpsForCreditLoopPotential p_fabric rootNodes
Analice el enrutamiento de multidifusión para asegurarse de que obedezca la regla Arriba / Abajo

[devuelve int] ibdmLinkCoverageAnalysis p_fabric rootNodes
Prepare un cronograma para la transmisión desde un conjunto de fuentes a destinos de manera que
en cada etapa no hay enlaces que estén suscritos en exceso y, después de todas las etapas, todos
los eslabones de la tela fueron extraídos

Rastreo Departamento de Servicios Públicos

Estas funciones permiten rastrear rutas informando los nodos visitados

[devuelve int] ibdmTraceDRPathRoute p_smNodePort drPathPortNums
Rastrear una ruta de ruta dirigida desde el puerto dado

[devuelve int] ibdmTraceRouteByMinHops p_fabric slid dlid
Trazar una ruta a lo largo del MinHop desde las LID de origen a destino

[devuelve int] ibdmTraceRouteByLFT p_fabric slid dlid hops p_nodesList
Trazar una ruta siguiendo la LFT actualizando los saltos y las variables de la lista de nodos

topología Coincidencia de Departamento de Servicios Públicos

Las siguientes utilidades coinciden con dos tejidos que proporcionan tanto mensajes de coincidencia como un
tejido unificado

[devuelve int] ibdmMatchFabrics p_spec_fabric p_discovered_fabric anchorNodeName
anclaPortNum anclaPortGuid
Haga coincidir un tejido basado en topología con uno descubierto comenzando en el puerto de enchor

[devuelve int] ibdmBuildMergedFabric p_spec_fabric p_discovered_fabric p_merged_fabric
Después de hacer coincidir el uso de ibdmMatchFabrics, complete el "tejido combinado" con información
combinado para los nodos emparejados

Congestión ECONOMÉTRICOS Departamento de Servicios Públicos

Proporcionar la capacidad de rastrear e informar sobre la suscripción excesiva de enlaces

[devuelve int] ibdmCongInit p_fabric
Inicializar el sistema de seguimiento

[devuelve int] ibdmCongCleanup p_fabric
Limpiar los contadores y desasignar

[devuelve int] ibdmCongClear p_fabric
Contadores de limpieza

[devuelve int] ibdmCongTrace p_fabric srcLid dstLid
Rastrear una ruta entre los LID que actualizan la información de uso del enlace

[devuelve int] ibdmCongReport p_fabric
Informar la información de congestión resultante

[devuelve int] ibdmCongDump p_fabric
Volcar toda la información de seguimiento de congestión

Utilice ibdmsh en línea utilizando los servicios de onworks.net