ibdmsh - Daring di Awan

PROGRAM:

NAMA

ibdmsh MODEL DATA IB - Cangkang TCL yang diperluas

DESKRIPSI

ibdmsh adalah shell TCL yang diperluas dengan antarmuka untuk model data IB. Untuk menggunakan cangkang ini
Anda akan menulis kode TCL yang secara langsung mengakses objek dan fungsi model data IB.

Sub bagian berikut memberikan definisi terperinci untuk objek dan API tersebut.

IBMM Konstanta

Node jenis

Konstanta berikut digunakan oleh bidang tipe objek simpul:

[ Konstanta : int ] $IB_UNKNOWN_NODE_TYPE = IB_UNKNOWN_NODE_TYPE

[ Konstanta : int ] $IB_SW_NODE = IB_SW_NODE

[ Konstanta : int ] $IB_CA_NODE = IB_CA_NODE

Log Verbositas Flags

Konstanta berikut digunakan sebagai bit argumen untuk variabel global:
$FabricUtilsVerboseLevel

[ Konstanta : int ] $FABU_LOG_NONE = 0x0

[ Konstanta : int ] $FABU_LOG_ERROR = 0x1

[ Konstanta : int ] $FABU_LOG_INFO = 0x2

[ Konstanta : int ] $FABU_LOG_VERBOSE = 0x4

IBMM Global

Level log: setel ke nilai FABU_LOG*

[ Global : int ] $FabricUtilsVerboseLevel

IBMM benda

Bagian ini menjelaskan berbagai jenis objek yang diekspos oleh IBDM.

IBDM mengekspos beberapa objek internalnya. Pengidentifikasi objek dikembalikan oleh berbagai
panggilan fungsi diformat sesuai dengan aturan berikut:

kain: kain:

Sistem: sistem: :

SysPort: sysport: : :

simpul: simpul: :

Pelabuhan: Pelabuhan: : /

Objek IBDM adalah objek Swag-Tcl standar. Karena itu mereka memiliki dua rasa untuk penggunaannya:
Variabel, Objek.

Variabel/Penunjuk:
Untuk setiap atribut objek, metode "get" dan "set" disediakan.
Format metodenya adalah: _ _ .
Metode "set" hanya tersedia untuk atribut baca/tulis.

Contoh:
setel node [ibdm_get_nodes]
setel simpul [lindex $nodes 0]
IBNode_numPorts_dapatkan $node

Objek:
Diberikan penunjuk objek, seseorang dapat mengubahnya menjadi "Objek" Tcl
menggunakan perintah berikut:
-ini

Setelah dideklarasikan dapat digunakan bersama untuk
dengan perintah "configure" dan "cget" standar.

Contoh (mengikuti yang sebelumnya):
IBFabric VaTech - $kain ini
cget VaTech -NodeByName

Untuk menghapus simbol objek (dan mengaktifkan pemetaannya ke yang lain
penunjuk) gunakan:
ganti nama ""
misalnya:
ganti nama VaTech ""

kelas Pelabuhan IB

Berikut ini adalah berbagai bidang dan metode dari kelas Port IB yang menjelaskan sebuah
port fisik (chip) perangkat IB.

[ Data anggota: mengembalikan IBPort * ] -p_remotePort
Port terhubung di sisi lain tautan

[ Data anggota: mengembalikan IBSysPort * ] -p_sysPort
Port sistem (jika ada) terhubung ke

[ Data anggota: mengembalikan IBNode * ] -p_node
Node yang menjadi bagian dari port.

[ Data anggota: mengembalikan int ] -num
Port fisik diidentifikasi dengan nomor.

[ Data anggota: mengembalikan unsigned int ] -base_lid
Tutup dasar yang ditetapkan ke port.

[ Data anggota: mengembalikan IBLinkWidth * ] -lebar
Lebar tautan port

[ Data anggota: mengembalikan IBLinkSpeed ​​* ] -kecepatan
Kecepatan tautan port

[Data anggota: mengembalikan int yang tidak ditandatangani] -counter1
Nilai generik untuk digunakan oleh berbagai algoritma

[ Konstruktor: mengembalikan IBPort * ] Nama IBPort nomor p_nodePtr
konstruktor IBPort

[ Anggota : mengembalikan new_uint64_t ] guid_get
Dapatkan panduan pelabuhan

[ Anggota : mengembalikan batal ] panduan guid_set
Ubah panduan port

[Anggota: mengembalikan string_baru] getName
Dapatkan nama port: Port perangkat yang terhubung ke port sistem (panel depan) kembali
nama port panel depan.

[ Anggota : mengembalikan batal ] sambungkan p_otherPort ?lebar? ?kecepatan?
Hubungkan port ke port node lain dengan parameter lebar dan kecepatan opsional

[ Anggota : mengembalikan int ] putuskan
Putuskan sambungan port. Kembalikan 0 jika berhasil

kelas IBNode

Kelas IB Node mewakili satu Perangkat IB (chip)

[ Data anggota: mengembalikan string * ] -nama
Nama node (nama contoh chip)

[ Data anggota: mengembalikan IBNodeType ] -type
Baik $IB_SW_NODE atau $IB_CA_NODE

[ Data anggota: mengembalikan uint16_t * ] -devId
ID perangkat node

[ Data anggota: mengembalikan uint16_t * ] -revId
Id revisi perangkat.

[ Data anggota: mengembalikan uint16_t * ] -vendId
ID Vendor perangkat.

[ Data anggota: mengembalikan string * ] -atribut
String koma-sep dari atribut arbitrer k=v

[ Data anggota: mengembalikan uint8_t ] -peringkat
Rank dari node (0 adalah root)

[ Data anggota: mengembalikan IBSsystem * ] -p_system
Sistem apa yang kita miliki

[ Data anggota: mengembalikan IBFabric * ] -p_fabric
Kain apa yang kita miliki.

[Data anggota: mengembalikan int yang tidak ditandatangani] -numPorts
Jumlah port fisik

[ Data anggota: mengembalikan vec_pport * ] -Ports
Vektor dari semua port

[ Data anggota: mengembalikan vec_vec_byte * ] -MinHopsTable
Tabel jumlah hop yang diperlukan untuk mendapatkan dari setiap port ke setiap LID target

[ Data anggota: mengembalikan vec_byte * ] -LFT
LFT node ini (hanya untuk sakelar) yang merupakan vektor panjang dari port target -
indeks adalah LID

[ Anggota : mengembalikan new_uint64_t ] guid_get
Dapatkan node GUID

[ Anggota : mengembalikan batal ] panduan guid_set
Setel GUID simpul

[ Konstruktor: mengembalikan IBNode * ] Nama IBNode n p_fab p_sys t np
kontraktor

[ Anggota : mengembalikan IBPort * ] nomor makePort
Buat port baru dengan nomornya (jika diperlukan) kembalikan penunjuk port

[ Anggota : mengembalikan IBPort * ] getPort num
Dapatkan port dengan nomor num = 1..N:

[ Anggota : mengembalikan batal ] setHops p_port tutup hop
Atur min hop untuk pasangan tutup port (* adalah semua) yang diberikan

[ Anggota : mengembalikan int ] getHops p_port tutup
Dapatkan jumlah minimum hop yang ditentukan untuk port yang diberikan atau semuanya

[ Anggota : mengembalikan IBPort * ] tutup getFirstMinHopPort
Pindai port node dan temukan port pertama dengan min hop ke tutupnya

[Anggota: mengembalikan batal] setLFTPortForLid tutup portNum
Atur Tabel Penerusan Linear untuk LID yang diberikan

[ Anggota : mengembalikan int ] tutup getLFTPortForLid
Dapatkan LFT untuk LID yang diberikan

[ Anggota : mengembalikan batal ] repHopTable
Buang tabel min hop dari node

kelas IBSysPort

Kelas IBSysPort mewakili steker IB di panel depan atau belakang sistem

[ Data anggota: mengembalikan string * ] -nama
Nama panel depan (sutra) port

[ Data anggota: mengembalikan IBSysPort * ] -p_remoteSysPort
Jika terhubung ke port sys sisi lain

[ Data anggota: mengembalikan IBSsystem * ] -p_system
Sistem itu milik

[ Data anggota: mengembalikan IBPort * ] -p_nodePort
Port simpul yang terhubung dengannya.

[ Konstruktor: mengembalikan IBSysPort * ] Nama IBSysPort dan p_sys
Pembina

[ Anggota : mengembalikan batal ] sambungkan p_otherSysPort ?lebar? ?kecepatan?
Hubungkan dua SysPorts

[ Anggota : mengembalikan int ] putuskan
Putuskan sambungan SysPort (dan port). Kembalikan 0 jika berhasil

kelas Sistem IB

Kelas IBSytem mewakili seluruh sasis

[ Data anggota: mengembalikan string * ] -nama
Nama "host" dari sistem

[ Data anggota: mengembalikan string * ] -type
Apa jenisnya yaitu Cougar, Buffalo, MTS2400, dll. File IBNL yang sesuai
harus ada - mendefinisikan tipe sistem ini

[ Data anggota: mengembalikan IBFabric * ] -p_fabric
Kain milik sistem

[ Data anggota: mengembalikan map_str_pnode * ] -NodeByName
Berikan penunjuk simpul dengan namanya

[ Data anggota: mengembalikan map_str_psysport * ] -PortByName
Peta yang menyediakan penunjuk ke SysPort dengan nama

[ Konstruktor: mengembalikan IBSystem * ] Nama IBSsystem n p_fab t
kontraktor

[ Anggota : mengembalikan new_uint64_t ] guid_get
Dapatkan GUID citra sistem

[ Anggota : mengembalikan batal ] panduan guid_set
Setel GUID gambar sistem

[ Anggota : mengembalikan IBSysPort * ] makeSysPort pName
Pastikan kami mendapatkan port yang ditentukan (jadi tentukan jika tidak)

[ Anggota : mengembalikan IBPort * ] getSysPortNodePortByName sysPortName
Dapatkan port node untuk port sys yang diberikan dengan nama

[ Anggota : mengembalikan IBSysPort * ] getSysPort name
Dapatkan Port Sys dengan nama

kelas Kain IB

Mewakili seluruh subnet IB yang terbuat dari sistem

[ Data anggota: mengembalikan map_str_pnode * ] -NodeByName
Berikan daftar nama simpul dan pasangan penunjuk

[ Data anggota: mengembalikan map_str_psys * ] -SystemByName
Berikan daftar nama sistem dan pasangan penunjuk

[ Data anggota: mengembalikan vec_pport * ] -PortByLid
Menyediakan daftar nama port sistem dan pasangan penunjuk

[ Data anggota: mengembalikan map_guid_pnode * ] -NodeByGuid
Menyediakan daftar panduan simpul dan pasangan penunjuk simpul

[ Data anggota: mengembalikan map_guid_psys * ] -SystemByGuid
Menyediakan daftar panduan gambar sistem dan pasangan penunjuk sistem

[ Data anggota: mengembalikan map_guid_pport * ] -PortByGuid
Menyediakan daftar panduan port dan pasangan penunjuk port

[ Data anggota: mengembalikan int yang tidak ditandatangani] -minLid
Lacak min tutup yang digunakan.

[ Data anggota: mengembalikan int yang tidak ditandatangani] -maxLid
Lacak tutup maks yang digunakan.

[ Data anggota: mengembalikan int yang tidak ditandatangani] -lmc
Nilai LMC yang digunakan

[ Anggota : mengembalikan IBNode * ] makeNode n p_sys ketik numPorts
Dapatkan simpul dengan namanya (buat salah satu tidak ada)

[ Anggota : mengembalikan IBNode * ] getNode name
Dapatkan simpul dengan namanya

[ Anggota : mengembalikan list_pnode * ] getNodesByType type
Kembalikan daftar penunjuk simpul yang cocok dengan tipe yang diperlukan

[ Anggota : mengembalikan nama IBSystem * ] makeGenericSystem
Buat sistem generik baru - pada dasarnya wadah kosong untuk node...

[ Anggota : mengembalikan IBSSystem * ] jenis nama makeSystem
Buat sistem baru - jenisnya harus memiliki pabrik yang terdaftar.

[Anggota : mengembalikan IBSystem * ] getSystem name
Dapatkan sistem berdasarkan nama

[Anggota : mengembalikan IBSSystem *] panduan getSystemByGuid
dapatkan sistem dengan panduannya

[ Anggota : mengembalikan IBNode * ] panduan getNodeByGuid
dapatkan simpul dengan panduannya

[ Anggota : mengembalikan IBPort * ] panduan getPortByGuid
dapatkan port dengan panduannya

[ Anggota : mengembalikan batal ] addCable t1 n1 p1 t2 n2 p2 ?lebar? ?kecepatan?
Menambahkan kabel yang diberikan dua set tipe node, nama node dan nomor port. Opsional
gunakan lebar dan kecepatan tertentu untuk koneksi

[ Anggota : mengembalikan int ] parseCables fn
Parsing file kabel dan buat kainnya

[ Anggota : mengembalikan int ] parseTopology fn
Parsing Topology File dan buat fabricnya

[Anggota: mengembalikan int] addLink type1 numPorts1 sysGuid1 nodeGuid1 portGuid1 vend1
devId1 rev1 desc1 tutup1 portNum1 type2 numPorts2 sysGuid2 nodeGuid2 portGuid2 vend2 devId2
rev2 desc2 lid2 portNum2 ?lebar? ?kecepatan?
Tambahkan tautan ke dalam fabric - ini akan membuat sistem dan node sesuai kebutuhan.

[ Anggota : mengembalikan int ] parseSubnetLinks fn
Parsing file subnet.lst OpenSM dan buat fabric darinya.

[ Anggota : mengembalikan int ] parseFdbFile fn
Parsing file dump FDB OpenSM dan isi tabel LFT switch

[ Anggota : mengembalikan int ] parseMCFdbFile fn
Parsing file OpenSM MCFDBs dan atur tabel MFT yang sesuai

[ Anggota : mengembalikan int ] parsePSLFile fn
Parse Path ke file pemetaan SL. Setiap baris dengan: src_node_guid DLID SL

Digunakan oleh pemeriksaan loop kredit

[ Anggota : mengembalikan int ] parseSLVLFile fn
Parsing file tabel SVL. Setiap baris berisi: sw_node_guid in_port out_port 0x(sl0)(sl1)
0x(sl2)(sl3)...

[Anggota: mengembalikan batal] setLidPort tutup p_port
Setel port penutup

[ Anggota : mengembalikan IBPort * ] getPortByLid tutup
Dapatkan port dengan penutup

[ mengembalikan IBFabric * ] new_IBFabric
Bangun kain baru

[ mengembalikan batal ] delete_IBFabric p_fabric
Hancurkan kain

IBMM Fungsi

Bagian ini memberikan perincian tentang fungsi-fungsi yang diekspos oleh IBDM. Urutannya mengikuti
urutan yang diharapkan dalam aliran IBDM reguler. Mereka semua kembali 0 pada keberhasilan.

Subnet Utilitas

File tersebut menyimpan seperangkat utilitas untuk dijalankan pada subnet untuk meniru inisialisasi OpenSM
dan menganalisis hasilnya:

[ mengembalikan int ] ibdmAssignLids p_smNodePort ?lmc?
Tetapkan LID dengan LMC opsional (beberapa LID per port)

[ mengembalikan int ] ibdmCalcMinHopTables p_fabric
Hitung dan isi MinHopTables yang diperlukan untuk menjalankan perutean gaya OpenSM.

[ mengembalikan int ] ibdmCalcUpDnMinHopTbls p_fabric rootNodesNameRex
Hitung dan isi MinHopTables mengikuti aturan Atas/Bawah.

[ mengembalikan int ] ibdmOsmRoute p_fabric
Rutekan fabric dengan perutean gaya OpenSM

[ mengembalikan int ] ibdmEnhancedRoute p_fabric
Rutekan fabric dengan perutean gaya OpenSM yang ditingkatkan dengan dukungan yang lebih baik untuk LMC > 0

[ mengembalikan int ] ibdmFatTreeRoute p_fabric rootNodes
Rutekan kain menggunakan algoritme yang hanya cocok untuk pohon yang penuh lemak

[ mengembalikan int ] ibdmFatTreeAnalysis p_fabric
Analisis kain untuk melihat apakah itu pohon yang gemuk dan rutekan jika itu

[ mengembalikan int ] ibdmVerifyCAtoCARoutes p_fabric
Pastikan semua (H)CA terhubung satu sama lain berdasarkan pengaturan LFT

[ mengembalikan int ] ibdmVerifyAllPaths p_fabric
Pastikan semua Sakelar dan (H)CA terhubung satu sama lain berdasarkan LFT
pengaturan

[ mengembalikan int ] ibdmAnalyzeLoops p_fabric
Pemeriksaan ketat untuk putaran kredit. Algoritma ini melakukan pemeriksaan yang lengkap dan akurat
tetapi pelaporan jalur loop kreditnya sulit untuk ditafsirkan. Jika Anda tahu akarnya
dari pohon (atau pohonnya simetris) lebih baik menggunakan
ibdmReportNonUpDownCa2CaPaths

[ mengembalikan list_pnode ] ibdmFindSymmetricalTreeRoots p_fabric
Analisis topologi pohon dan temukan akar pohon berdasarkan simetrinya

[ mengembalikan list_pnode ] ibdmFindRootNodesByMinHop p_fabric
Berdasarkan MinHopTable temukan akar pohon. Asimetri 5% diperbolehkan

[ mengembalikan int ] ibdmRankFabricByRoots p_fabric rootNodes
Mengingat daftar node root (nama) peringkat node (root = 0)

[ mengembalikan int ] ibdmReportNonUpDownCa2CaPaths p_fabric rootNodes
Analisis rute untuk memastikan aturan Naik/Turun dipertahankan

[ mengembalikan int ] ibdmCheckMulticastGroups p_fabric
Verifikasi konektivitas perutean multicast

[ mengembalikan int ] ibdmCheckFabricMCGrpsForCreditLoopPotential p_fabric rootNodes
Analisis perutean multicast untuk memastikannya mematuhi aturan Naik/Turun

[ mengembalikan int ] ibdmLinkCoverageAnalysis p_fabric rootNodes
Siapkan jadwal untuk transmisi dari satu set sumber ke tujuan sedemikian rupa sehingga:
di setiap tahap tidak ada tautan yang berlangganan berlebihan dan setelah semua tahap semuanya
tautan dari kain itu dibesar-besarkan

jiplakan Utilitas

Fungsi-fungsi ini memungkinkan pelacakan jalur yang melaporkan kembali node yang dikunjungi

[ mengembalikan int ] ibdmTraceDRPathRoute p_smNodePort drPathPortNums
Lacak jalur rute yang diarahkan dari port yang diberikan

[ mengembalikan int ] ibdmTraceRouteByMinHops p_fabric slid dlid
Lacak jalur di sepanjang MinHop dari sumber ke LID tujuan

[ mengembalikan int ] ibdmTraceRouteByLFT p_fabric slid dlid hop p_nodesList
Lacak jalur mengikuti LFT memperbarui hop dan variabel daftar node

Topologi Sesuai Utilitas

Utilitas berikut cocok dengan dua fabric yang menyediakan pesan ketidakcocokan dan a
kain terpadu

[ mengembalikan int ] ibdmMatchFabrics p_spec_fabric p_discovered_fabric anchorNodeName
jangkarPortNum jangkarPortGuid
Cocokkan kain berbasis topologi dengan yang ditemukan mulai dari port enchor

[ mengembalikan int ] ibdmBuildMergedFabric p_spec_fabric p_discovered_fabric p_merged_fabric
Setelah mencocokkan menggunakan ibdmMatchFabrics, isi "kain gabungan" dengan informasi
digabungkan untuk node yang cocok

Kemacetan Analisis Utilitas

Memberikan kemampuan untuk melacak dan melaporkan kelebihan langganan tautan

[ mengembalikan int ] ibdmCongInit p_fabric
Inisialisasi sistem pelacakan

[ mengembalikan int ] ibdmCongCleanup p_fabric
Bersihkan penghitung dan dealokasi

[ mengembalikan int ] ibdmCongClear p_fabric
Penghitung pembersihan

[ mengembalikan int ] ibdmCongTrace p_fabric srcLid dstLid
Lacak jalur antara LID yang memperbarui info penggunaan tautan

[ mengembalikan int ] ibdmCongReport p_fabric
Laporkan informasi kemacetan yang dihasilkan

[ mengembalikan int ] ibdmCongDump p_fabric
Buang semua info pelacakan kemacetan

Gunakan ibdmsh online menggunakan layanan onworks.net