ibdmsh - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

ibdmsh MÔ HÌNH DỮ LIỆU IB - Shell TCL mở rộng

MÔ TẢ

ibdmsh là TCL shell được mở rộng với giao diện cho mô hình dữ liệu IB. Để sử dụng vỏ này
bạn sẽ viết mã TCL truy cập trực tiếp vào các đối tượng và hàm của mô hình dữ liệu IB.

Các phần phụ sau đây cung cấp định nghĩa chi tiết cho các đối tượng và API đó.

IBDM Hằng số

Node Các loại

Các hằng số sau được sử dụng bởi trường loại đối tượng nút

[ Hằng số: int ] $IB_UNKNOWN_NODE_TYPE = IB_UNKNOWN_NODE_TYPE

[ Hằng số : int ] $IB_SW_NODE = IB_SW_NODE

[ Hằng số : int ] $IB_CA_NODE = IB_CA_NODE

Khúc gỗ Độ dài Flags

Các hằng số sau đây được sử dụng làm bit đối số cho biến toàn cục
$FabricUtilsVerboseLevel

[ Hằng số : int ] $FABU_LOG_NONE = 0x0

[ Hằng số : int ] $ FABU_LOG_ERROR = 0x1

[ Hằng số : int ] $ FABU_LOG_INFO = 0x2

[ Hằng số : int ] $ FABU_LOG_VERBOSE = 0x4

IBDM quả cầu

Cấp độ nhật ký: được đặt thành giá trị FABU_LOG*

[ Toàn cầu : int ] $FabricUtilsVerboseLevel

IBDM Đối tượng

Phần này mô tả các loại đối tượng khác nhau được IBDM thể hiện.

IBDM phơi bày một số đối tượng bên trong của nó. Các mã định danh đối tượng được trả về bởi các
các lệnh gọi hàm được định dạng theo các quy tắc sau:

Vải: vải:

Hệ thống: hệ thống: :

SysPort: sysport: : :

Nút: nút: :

Cảng: cổng: : /

Đối tượng IBDM là đối tượng Swig-Tcl tiêu chuẩn. Vì vậy, chúng có hai hương vị cho việc sử dụng:
Biến, đối tượng.

Biến/Con trỏ:
Đối với mỗi thuộc tính đối tượng, các phương thức "get" và "set" được cung cấp.
Định dạng của các phương thức là: _ _ .
Phương thức "set" chỉ khả dụng cho thuộc tính đọc/ghi.

Ví dụ:
đặt nút [ibdm_get_nodes]
đặt nút [lindex $nodes 0]
IBNode_numPorts_get nút $

Các đối tượng:
Cho một con trỏ đối tượng, người ta có thể chuyển đổi nó thành một "Đối tượng" Tcl
sử dụng lệnh sau:
-cái này

Một khi đã tuyên bố có thể được sử dụng kết hợp với
bằng các lệnh "configure" và "cget" tiêu chuẩn.

Ví dụ (tiếp theo ví dụ trước):
IBFabric VaTech -vải $this
VaTech cget -NodeByName

Để xóa một biểu tượng đối tượng (và cho phép ánh xạ của nó tới một biểu tượng khác
con trỏ) sử dụng:
đổi tên ""
ví dụ:
đổi tên VaTech ""

tốt nghiệp lớp XNUMX IBPort

Sau đây là các trường và phương thức khác nhau của lớp Cổng IB mô tả một
Cổng vật lý của thiết bị IB (chip).

[ Dữ liệu thành viên: trả về IBPort * ] -p_remotePort
Cổng được kết nối ở phía bên kia của liên kết

[ Dữ liệu thành viên: trả về IBSysPort * ] -p_sysPort
Cổng hệ thống (nếu có) được kết nối với

[ Dữ liệu thành viên: trả về IBNode * ] -p_node
Nút mà cổng là một phần của.

[ Dữ liệu thành viên: trả về int ] -num
Cổng vật lý được xác định bằng số.

[ Dữ liệu thành viên: trả về unsigned int ] -base_lid
Nắp đế được gán cho cổng.

[ Dữ liệu thành viên: trả về IBLinkWidth * ] -width
Độ rộng liên kết của cổng

[ Dữ liệu thành viên: trả về IBLinkSpeed ​​* ] -speed
Tốc độ liên kết của cổng

[ Dữ liệu thành viên: trả về unsigned int ] -counter1
Một giá trị chung được sử dụng bởi các thuật toán khác nhau

[ Hàm tạo: trả về IBPort * ] Tên IBPort số p_nodePtr
Trình tạo IBPort

[ Thành viên : trả về new_uint64_t ] guid_get
Nhận hướng dẫn của cảng

[ Thành viên : trả về void ] guid_set guid
Sửa đổi hướng dẫn của cổng

[ Thành viên : trả về new_string ] getName
Lấy tên cổng: Cổng thiết bị kết nối với cổng hệ thống (pannel phía trước) trả về
tên cổng bảng điều khiển phía trước.

[ Member : trả về void ] kết nối p_otherPort ?width? ?tốc độ?
Kết nối cổng với cổng nút khác với các thông số tốc độ và chiều rộng tùy chọn

[ Thành viên : trả về int ] ngắt kết nối
Ngắt kết nối cổng. Trả về 0 nếu thành công

tốt nghiệp lớp XNUMX IBNode

Lớp Nút IB đại diện cho một Thiết bị IB (chip) duy nhất

[ Dữ liệu thành viên: trả về chuỗi * ] -name
Tên của nút (tên ví dụ của chip)

[ Dữ liệu thành viên: trả về IBNodeType ] -type
$IB_SW_NODE hoặc $IB_CA_NODE

[ Dữ liệu thành viên: trả về uint16_t * ] -devId
ID thiết bị của nút

[ Dữ liệu thành viên: trả về uint16_t * ] -revId
Id sửa đổi thiết bị.

[ Dữ liệu thành viên: trả về uint16_t * ] -vendId
ID nhà cung cấp thiết bị.

[ Dữ liệu thành viên: trả về chuỗi * ] -attributes
Chuỗi dấu phẩy-sep của các thuộc tính tùy ý k=v

[ Dữ liệu thành viên: trả về uint8_t ] -rank
Thứ hạng của nút (0 là nút gốc)

[ Dữ liệu thành viên: trả về IBSystem * ] -p_system
Chúng ta thuộc về hệ thống nào

[ Dữ liệu thành viên: trả về IBFabric * ] -p_fabric
Chúng ta thuộc về loại vải nào.

[ Dữ liệu thành viên: trả về unsigned int ] -numPorts
Số lượng cổng vật lý

[ Dữ liệu thành viên: trả về vec_pport * ] -Ports
Vector của tất cả các cổng

[ Dữ liệu thành viên: trả về vec_vec_byte * ] -MinHopsTable
Bảng số bước nhảy cần thiết để đi từ mỗi cổng đến từng LID mục tiêu

[ Dữ liệu thành viên: trả về vec_byte * ] -LFT
LFT của nút này (chỉ dành cho thiết bị chuyển mạch) là một vectơ dài của các cổng đích -
chỉ số là LID

[ Thành viên : trả về new_uint64_t ] guid_get
Lấy nút GUID

[ Thành viên : trả về void ] guid_set guid
Đặt nút GUID

[ Hàm tạo: trả về IBNode * ] Tên IBNode n p_fab p_sys t np
Nhà thầu

[ Member : trả về IBPort * ] makePort num
Tạo một cổng mới theo số của nó (nếu cần) trả về con trỏ cổng

[ Member : trả về IBPort * ] getPort num
Nhận một cổng theo số num = 1..N:

[ Member : return void ] setHops p_port lid hops
Đặt bước nhảy tối thiểu cho cặp nắp cổng (* là tất cả) đã cho

[ Member : trả về int ] getHops p_port lid
Lấy số bước nhảy tối thiểu được xác định cho cổng đã cho hoặc tất cả

[ Member : trả về IBPort * ] getFirstMinHopPort lid
Quét các cổng nút và tìm cổng đầu tiên có min hop tới nắp

[ Thành viên : trả về khoảng trống ] setLFTPortForLid lid portNum
Đặt Bảng chuyển tiếp tuyến tính cho LID đã cho

[ Thành viên : trả về int ] getLFTPortForLid lid
Nhận LFT cho một LID nhất định

[ Thành viên : trả về void ] RepHopTable
Loại bỏ bảng min hop của nút

tốt nghiệp lớp XNUMX IBSysPort

Lớp IBSysPort đại diện cho một phích cắm IB trên các bảng mặt trước hoặc mặt sau của hệ thống

[ Dữ liệu thành viên: trả về chuỗi * ] -name
Tên bảng mặt trước (lụa) của cổng

[ Dữ liệu thành viên: trả về IBSysPort * ] -p_remoteSysPort
Nếu được kết nối với cổng sys phía bên kia

[ Dữ liệu thành viên: trả về IBSystem * ] -p_system
Hệ thống nó mang lại lợi ích cho

[ Dữ liệu thành viên: trả về IBPort * ] -p_nodePort
Cổng nút mà nó kết nối tới.

[ Hàm tạo: trả về IBSysPort * ] Tên IBSysPort n p_sys
xây dựng

[ Thành viên : trả về void ] kết nối p_otherSysPort ?width? ?tốc độ?
Kết nối hai SysPorts

[ Thành viên : trả về int ] ngắt kết nối
Ngắt kết nối SysPort (và các cổng). Trả về 0 nếu thành công

tốt nghiệp lớp XNUMX Hệ thống IB

Lớp IBSystem đại diện cho toàn bộ khung

[ Dữ liệu thành viên: trả về chuỗi * ] -name
Tên "máy chủ" của hệ thống

[ Dữ liệu thành viên: trả về chuỗi * ] -type
Loại gì là Cougar, Buffalo, MTS2400, v.v. Tệp IBNL tương ứng
nên tồn tại - xác định loại hệ thống này

[ Dữ liệu thành viên: trả về IBFabric * ] -p_fabric
Vải thuộc về hệ thống

[ Dữ liệu thành viên: trả về map_str_pnode * ] -NodeByName
Cung cấp con trỏ nút theo tên của nó

[ Dữ liệu thành viên: trả về map_str_psysport * ] -PortByName
Bản đồ cung cấp con trỏ tới SysPort theo tên

[ Hàm tạo: trả về IBSystem * ] Tên IBSystem n p_fab t
Nhà thầu

[ Thành viên : trả về new_uint64_t ] guid_get
Lấy GUID hình ảnh hệ thống

[ Thành viên : trả về void ] guid_set guid
Đặt GUID hình ảnh hệ thống

[ Member : trả về IBSysPort * ] makeSysPort pName
Hãy chắc chắn rằng chúng tôi đã xác định được cổng (vì vậy hãy xác định nó nếu không)

[ Thành viên : trả về IBPort * ] getSysPortNodePortByName sysPortName
Nhận cổng nút cho cổng sys đã cho theo tên

[ Member : trả về IBSysPort * ] tên getSysPort
Nhận cổng Sys theo tên

tốt nghiệp lớp XNUMX IBVải

Đại diện cho toàn bộ mạng con IB được tạo thành từ các hệ thống

[ Dữ liệu thành viên: trả về map_str_pnode * ] -NodeByName
Cung cấp danh sách tên nút và cặp con trỏ

[ Dữ liệu thành viên: trả về map_str_psys * ] -SystemByName
Cung cấp danh sách tên hệ thống và cặp con trỏ

[ Dữ liệu thành viên: trả về vec_pport * ] -PortByLid
Cung cấp danh sách tên cổng hệ thống và các cặp con trỏ

[ Dữ liệu thành viên: trả về map_guid_pnode * ] -NodeByGuid
Cung cấp danh sách các cặp hướng dẫn nút và con trỏ nút

[ Dữ liệu thành viên: trả về map_guid_psys * ] -SystemByGuid
Cung cấp danh sách các cặp hướng dẫn hình ảnh hệ thống và con trỏ hệ thống

[ Dữ liệu thành viên: trả về map_guid_pport * ] -PortByGuid
Cung cấp danh sách các cặp hướng dẫn cổng và con trỏ cổng

[ Dữ liệu thành viên: trả về unsigned int ] -minLid
Theo dõi nắp tối thiểu được sử dụng.

[ Dữ liệu thành viên: trả về unsigned int ] -maxLid
Theo dõi nắp tối đa được sử dụng.

[ Dữ liệu thành viên: trả về unsigned int ] -lmc
Giá trị LMC được sử dụng

[ Member : trả về IBNode * ] makeNode n p_sys gõ numPorts
Lấy nút theo tên của nó (tạo một nút không tồn tại)

[ Thành viên : trả về IBNode * ] tên getNode
Lấy nút theo tên của nó

[Thành viên: trả về list_pnode *] loại getNodesByType
Trả về danh sách các con trỏ nút khớp với loại được yêu cầu

[ Thành viên : trả về IBSystem * ] tên makeGenericSystem
Tạo một hệ thống chung mới - về cơ bản là một vùng chứa trống cho các nút...

[ Thành viên : trả về IBSystem * ] loại tên makeSystem
Tạo hệ thống mới - loại phải có nhà máy đăng ký.

[ Thành viên : trả về IBSystem * ] getSystem tên
Nhận hệ thống theo tên

[ Thành viên : trả về IBSystem * ] hướng dẫn getSystemByGuid
lấy hệ thống theo hướng dẫn của nó

[ Thành viên : trả về IBNode * ] hướng dẫn getNodeByGuid
lấy nút theo hướng dẫn của nó

[ Member : trả về IBPort * ] hướng dẫn getPortByGuid
lấy cổng theo hướng dẫn của nó

[ Thành viên : trả về void ] addCable t1 n1 p1 t2 n2 p2 ?width? ?tốc độ?
Thêm cáp có hai bộ loại nút, tên nút và số cổng. Tùy chọn
sử dụng chiều rộng và tốc độ nhất định cho kết nối

[Thành viên: trả về int] parsCables fn
Phân tích tệp cáp và xây dựng kết cấu

[ Thành viên : trả về int ] phân tích cú pháp fn
Phân tích tệp cấu trúc liên kết và xây dựng kết cấu

[ Thành viên : trả về int ] addLink type1 numPorts1 sysGuid1 nodeGuid1 portGuid1 vend1
devId1 rev1 desc1 lid1 portNum1 type2 numPorts2 sysGuid2 nodeGuid2 portGuid2 vend2 devId2
rev2 desc2 lid2 portNum2 ?chiều rộng? ?tốc độ?
Thêm một liên kết vào vải - điều này sẽ tạo ra hệ thống và các nút theo yêu cầu.

[ Thành viên : trả về int ] parsSubnetLinks fn
Phân tích tệp subnet.lst OpenSM và xây dựng kết cấu từ nó.

[Thành viên: trả về int] parfFdbFile fn
Phân tích tệp kết xuất OpenSM FDB và điền vào các bảng LFT của switch

[ Thành viên : trả về int ] phân tích cú phápMCFdbFile fn
Phân tích tệp OpenSM MCFDBs và đặt bảng MFT tương ứng

[ Thành viên : trả về int ] parpsPSLFile fn
Phân tích đường dẫn tới tệp ánh xạ SL. Mỗi dòng có: src_node_guid DLID SL

Được sử dụng bởi kiểm tra vòng tín dụng

[ Thành viên : trả về int ] phân tíchSLVLFile fn
Phân tích tệp bảng SLVL. Mỗi dòng chứa: sw_node_guid in_port out_port 0x(sl0)(sl1)
0x(sl2)(sl3)...

[ Thành viên : trả về void ] setLidPort lid p_port
Đặt cổng nắp

[ Member : trả về IBPort * ] getPortByLid lid
Nhận một cổng bằng nắp

[ trả về IBFabric * ] new_IBFabric
Xây dựng một loại vải mới

[ trả về void ] xóa_IBFabric p_fabric
Phá hủy một loại vải

IBDM Chức năng

Phần này cung cấp thông tin chi tiết về các chức năng mà IBDM cung cấp. Trình tự tuân theo
thứ tự dự kiến ​​trong luồng IBDM thông thường. Tất cả đều trả về 0 khi thành công.

Mạng con Tiện ích

Tệp chứa một bộ tiện ích sẽ chạy trên mạng con để bắt chước quá trình khởi tạo OpenSM
và phân tích kết quả:

[ trả về int ] ibdmAssignLids p_smNodePort ?lmc?
Gán LID bằng LMC tùy chọn (nhiều LID trên mỗi cổng)

[trả về int] ibdmCalcMinHopTables p_fabric
Tính toán và điền MinHopTables cần thiết để chạy định tuyến kiểu OpenSM.

[trả về int] ibdmCalcUpDnMinHopTbls p_fabric rootNodesNameRex
Tính toán và điền MinHopTables theo quy tắc Lên/Xuống.

[trả về int] ibdmOsmRoute p_fabric
Định tuyến vải theo định tuyến kiểu OpenSM

[trả về int] ibdmEnhancedRoute p_fabric
Định tuyến vải với định tuyến kiểu OpenSM được cải tiến với khả năng hỗ trợ tốt hơn cho LMC > 0

[trả về int] ibdmFatTreeRoute p_fabric rootNodes
Định tuyến vải bằng thuật toán chỉ phù hợp với cây đầy đủ chất béo

[ trả về int ] ibdmFatTreeAnalysis p_fabric
Phân tích vải xem có phải là cây mập không và định tuyến nếu có

[trả về int] ibdmVerifyCAtoCARoutes p_fabric
Đảm bảo tất cả (H)CA được kết nối với nhau dựa trên cài đặt LFT

[trả về int] ibdmVerifyAllPaths p_fabric
Đảm bảo tất cả các Switch và (H)CA được kết nối với nhau dựa trên LFT
thiết lập

[trả về int] ibdmAnalyzeLoops p_fabric
Kiểm tra nghiêm ngặt các vòng tín dụng. Thuật toán này thực hiện kiểm tra đầy đủ và chính xác
nhưng báo cáo về đường dẫn vòng tín dụng của nó rất khó diễn giải. Nếu bạn biết cội nguồn
của cây (hoặc cây đối xứng), tốt nhất nên sử dụng
ibdmReportNonUpDownCa2CaPaths

[trả về list_pnode] ibdmFindSymmetricalTreeRoots p_fabric
Phân tích cấu trúc liên kết của cây và tìm ra gốc của cây dựa trên tính đối xứng của nó

[trả về list_pnode] ibdmFindRootNodesByMinHop p_fabric
Dựa vào MinHopTable tìm rễ của cây. Cho phép độ bất đối xứng 5%

[trả về int] ibdmRankFabricByRoots p_fabric rootNodes
Đưa ra danh sách các nút gốc (tên) xếp hạng các nút (root = 0)

[trả về int] ibdmReportNonUpDownCa2CaPaths p_fabric rootNodes
Phân tích các tuyến đường để đảm bảo quy tắc Lên/Xuống được duy trì

[trả về int] ibdmCheckMulticastGroups p_fabric
Xác minh kết nối của định tuyến multicast

[ trả về int ] ibdmCheckFabricMCGrpsForCreditLoopPotential p_fabric rootNodes
Phân tích định tuyến multicast để đảm bảo nó tuân theo quy tắc Lên/Xuống

[ trả về int ] ibdmLinkCoverageAnalysis p_fabric rootNodes
Chuẩn bị một lịch trình truyền từ một tập hợp các nguồn tới các đích sao cho
trong mỗi giai đoạn không có liên kết nào được đăng ký quá mức và sau tất cả các giai đoạn
các liên kết của vải đã bị cắt bỏ

Truy tìm Tiện ích

Các chức năng này cho phép theo dõi các đường dẫn báo cáo lại các nút đã truy cập

[trả về int] ibdmTraceDRPathRoute p_smNodePort drPathPortNums
Theo dõi đường dẫn tuyến đường được chỉ dẫn từ cổng đã cho

[ trả về int ] ibdmTraceRouteByMinHops p_fabric trượt dlid
Theo dõi đường dẫn dọc theo MinHop từ LID nguồn đến LID đích

[ trả về int ] ibdmTraceRouteByLFT p_fabric trượt dlid hops p_nodesList
Theo dõi đường dẫn theo LFT cập nhật các biến danh sách nút và bước nhảy

topology Phù hợp Tiện ích

Các tiện ích sau đây khớp với hai loại vải cung cấp cả thông báo không khớp và
vải thống nhất

[trả về int] ibdmMatchFabrics p_spec_fabric p_discovered_fabric AnchorNodeName
neoPortNum neoPortGuid
Ghép kết cấu dựa trên cấu trúc liên kết với kết cấu được phát hiện bắt đầu từ cổng enchor

[trả về int] ibdmBuildMergedFabric p_spec_fabric p_discovered_fabric p_merged_fabric
Sau khi đối sánh bằng cách sử dụng ibdmMatchFabrics, hãy điền thông tin vào "vải đã hợp nhất"
được hợp nhất cho các nút phù hợp

Tắc nghẽn nghiên cứu Tiện ích

Cung cấp khả năng theo dõi và báo cáo việc đăng ký vượt mức liên kết

[trả về int] ibdmCongInit p_fabric
Khởi tạo hệ thống theo dõi

[trả về int] ibdmCongCleanup p_fabric
Dọn dẹp quầy và phân bổ

[trả về int] ibdmCongClear p_fabric
quầy dọn dẹp

[trả về int] ibdmCongTrace p_fabric srcLid dstLid
Theo dõi đường dẫn giữa các LID cập nhật thông tin sử dụng liên kết

[trả về int] ibdmCongReport p_fabric
Báo cáo thông tin tắc nghẽn kết quả

[trả về int] ibdmCongDump p_fabric
Kết xuất tất cả thông tin theo dõi tắc nghẽn

Sử dụng ibdmsh trực tuyến bằng dịch vụ onworks.net