跳到主要內容

第一次寫MIB就上手

SNMP(Simple Network Management Protocol)是用來管理網路設備的一種Protocol,我對它的認識也是從工作接觸開始。雖說是管理網路設備,但是主機、電源供應器、RAID等也都可以透過它來做管理。如果你做了一個應用程式,當然所有的操作也都可以透過SNMP來完成,不過可能會很痛苦。前陣子遇到一個學弟,它告訴我說:「我可能不會想寫程式。」為什麼? 因為這是他痛苦的根源。

在這篇文章中,不是要告訴你SNMP是什麼,會看這篇文章的大哥們,應該已經對SNMP有些認識了。

是的!主題是MIB(Management information base)! 對於一個3th-party的SNMP oid,有MIB可以幫助你去了解它所提供的資訊是什麼,且可以對它做什麼操作。最近我運氣很好剛好做到關於修改MIB的工作,也讓我順便了解一下它的語法,接下來我要交給大家MIB的基礎認識。

smidump

我並非使用什麼高強的Editor去編寫MIB,我僅透過Nodepad++編輯和smidump編譯而已。smidump是Kay教我使用的一個將MIB module轉成樹狀結構或oid列表的工具,唯一的缺點是不會告訴你哪一行打錯。當然有錢直接買編輯樹狀結構的工具就可以不需要了解語法了!

安裝

在Ubuntu上可先輸入smidump確認是否安裝,如果沒安裝可透過apt-get install libsmi2ldbl安裝。(CentOS可以透過yum install libsmi)

root@tonylin:~/multi-boot-server# smidump
The program 'smidump' is currently not installed.  You can install it by typing:
apt-get install libsmi2ldbl

使用

透過下面兩行指令,就可以將mib file產生出對應的tree與oid列表的檔案。也可以透過這個結果確認MIB是不是你想要的。

smidump -f tree example1.mib > xtree.txt
smidump -f identifiers example1.mib > xiden.txt

如果有參考其它檔案要加上p的參數:

smidump -f tree -p example1.mib example2.mib > xtree.txt
smidump -f identifiers -p example1.mib example2.mib > xiden.txt

MIB HelloWorld!

一個MIB要怎麼寫,就看你要提供的資料結構是怎樣。舉例來說,如果要提供一個神盾局(S.H.I.E.L.D)的MIB,以下是我的一個簡易範例(xtree):

--shieldMIB(1.3.6.1.4.1.135)
  |
  +-- rwn DisplayString directorName(1)
  |  
  +--staffObjects(2)
  |  |
  |  +--heroTable(1)
  |     |
  |     +--heroEntry(1) [heroIndex]
  |        |
  |        +-- --- Integer32         heroIndex(1)
  |        +-- r-n DisplayString     heroName(2)
  |        +-- rwn DisplayString     heroSex(3)
  |        +-- rwn Integer32         heroPower(4)
  |        +-- rwn DisplayString     wellknown(5)
  |
  +--enemyObjects(3)

(各oid中的名稱必須是小寫開頭)

對應的意義即:

  • 1.3.6.1.4.1.135.1: 局長姓名,Nick Fury。
  • 1.3.6.1.4.1.135.2: 雇員物件。我有列出來其下的heroTable。
  • 1.3.6.1.4.1.135.2.1: heroTable,放置各個英雄資訊。
    • 1.3.6.1.4.1.135.2.1: 英雄資訊。
      • 1.3.6.1.4.1.135.2.1.1: 識別號。
      • 1.3.6.1.4.1.135.2.1.2: 姓名,浩克。
      • 1.3.6.1.4.1.135.2.1.3: 性別,男。
      • 1.3.6.1.4.1.135.2.1.4: 攻擊力,65535。
      • 1.3.6.1.4.1.135.2.1.4: 名言,「好弱的神」。
  • 1.3.6.1.4.1.135.3: 敵人物件。與雇員物件雷同,不贅述。

像上面的範例我們該怎麼寫MIB呢? 

結構

以我觀察smidump的結果,共有node、table、row、column、scala、type、notification、compliance、group這幾個種類。在這個範例中會使用到的有node、table、row、column與scala。

彼此的關係如下:

  • node > table > row > column,一個node可能會有多個table,table下會有多個row,row下會有多個column。用於重複的屬性,如heroTable。
  • node > scala。用於不重複的屬性,如generalName。
  • node > node,把node當分支就對了,如staffObjects和enemyObjects。

Init MIB

一個初始的MIB file就長的像下面這個樣子,ModuleName就是這個MIB名稱;ImportsList就像是import library或package,包含所有會使用到的形態與物件的宣告,基本上也是使用到什麼就匯入什麼;AssignmentsList就是那堆oid結構宣告。

ModuleName DEFINITIONS ::= BEGIN
?ImportsList?
?AssignmentsList?
END

以這個範例來說,基本的雛形會長這個樣子:

SHIELDMIB DEFINITIONS ::= BEGIN
IMPORTS
	MODULE-IDENTITY,
	OBJECT-IDENTITY,
        OBJECT-TYPE,
	Integer32,
	enterprises
		FROM SNMPv2-SMI
	DisplayString
		FROM SNMPv2-TC;

?AssignmentsList?
END

MODULE-IDENTITY、OBJECT-IDENTITY、OBJECT-TYPE是用來描述結構與節點的;Integer32與DisplayString是會使用到的形態;enterprise代表1.3.6.1.4.1,SHIELDMIB是1.3.6.1.4.1.135,其中135必須與IANA註冊,也代表著你的ID,這是用來代表私人企業的意思。這些宣告後都有FROM XXXX,是要告訴smidump這些宣告的來源,你也可以將你寫過的MIB弄進來重複使用。(假如是一個很大的組織,可能都會有類似Common Library的MIB file)透過設定SMIPATH,可以把參考的路徑設定進去。

MODULE-IDENTITY

一個MIB Module就是需要一個MODULE-IDENTITY的宣告,裡面的內容就是記錄這個MIB Module的資訊。

shieldMIB MODULE-IDENTITY
    LAST-UPDATED "201208200000Z"
    ORGANIZATION "S.H.I.E.L.D"
    CONTACT-INFO "shield@shield.gov.us"
    DESCRIPTION  "復仇者聯盟"
    REVISION     "201005200000Z"
    DESCRIPTION  "神盾局創立"
    REVISION     "201102140000Z"
    DESCRIPTION  "浩克加入"
::= { enterprises 135 }   

依樣畫葫蘆,revision+description是用來描述這個module有做過什麼修改,如果不喜歡也可以在整個MIB file最上方用兩個減號(註解)做說明;::=之後是接OID。

OBJECT-IDENTITY

OBJECT-IDENTITY又叫branch node,用來做分類。以我們例子而言包含了staffObjects和enemyObjects,它們的oid宣告就是接在shieldMIB之後。

staffObjects OBJECT-IDENTIFIER ::= { shieldMIB 2 }
enemyObjects OBJECT-IDENTIFIER ::= { shieldMIB 3 }

OBJECT-TYPE

OBJECT-TYPE可表示scala、table、row與column。

scala

oid是接在node下,而且已經是leaf就是scala。以我們範例而言,就是神盾局局長,總不會同時會有兩個局長吧?其中SYNTAX代表著OBJECT-TYPE的型態;MAX-ACCESS代表著存取權限,可以參考這裡;STATUS代表這個oid目前的狀態,可以參考這裡

directorName OBJECT-TYPE
    SYNTAX      DisplayString
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION "The director's name for the S.H.I.E.L.D."
    ::= { shieldMIB 1 }

table&row

與scala最大的不同就在於SYNTAX的描述。以我們的範例而言,heroTable是一個table包含多個heroEntry row代表著不同英雄,而heroEntry中又會有個別的column去描述英雄屬性。你可以把HeroEntry(大寫的)當做一種資料結構,裡面就是描述英雄屬性,而heroEntry(小寫的)的型態就是這個結構。而heroTable的SYNTAX就是代表著很多個HeroEntry。另外要注意的是oid,heroEntry一定是在heroTable之下,而heroTable則是在staffObjects之下。

heroTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF HeroEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A table of hero entries."
    ::= { staffObjects 1 }

heroEntry OBJECT-TYPE
    SYNTAX        HeroEntry 
    MAX-ACCESS    not-accessible
    STATUS        current
    DESCRIPTION
        "An entry in the hero table."
    INDEX        { heroIndex }
    ::= { heroTable 1 }

HeroEntry ::=
    SEQUENCE {
        heroIndex      Integer32,
        heroName       DisplayString,
        heroSex        DisplayString,
        heroPower      Integer32,
        wellknown      DisplayString
    }

column

在row下的就是column,這部分寫法與scala大同小異,唯一差別就在於父節點是誰而已。

heroIndex      OBJECT-TYPE
	SYNTAX	    Integer32 (1..65535)
	MAX-ACCESS  not-accessible
	STATUS	    current
	DESCRIPTION
		"The unique value which identifies the hero."
	::= { heroEntry 1 }

heroName       OBJECT-TYPE
	SYNTAX	    DisplayString
	MAX-ACCESS  read-write
	STATUS	    current
	DESCRIPTION
		"A textual full name assigned to a hero."
	::= { heroEntry 2 }

部屬MIB

將寫好的MIB放到/usr/share/snmp/mibs/,接著執行export MIBS=ALL。只要透過snmpwalk -v 1 127.0.0.1 .1.3.6.1.4.1.135 -c public可以看到透過MIB翻譯後的結果。

但是不要天真的以為照做就能夠看到了! 你必須要有SNMP的Provider,否則執行snmpwalk系統哪知道這是誰家的裝置!

Summary

MIB的語法算是一種程式語言了。除了沒提及的type、notification、compliance、group外,其實還包含了許多細節。但我想如果之後有接觸再分享給大家。

Reference

延伸閱讀

留言

這個網誌中的熱門文章

解決RobotFramework從3.1.2升級到3.2.2之後,Choose File突然會整個Hand住的問題

考慮到自動測試環境的維護,我們很久以前就使用java去執行robot framework。前陣子開始處理從3.1.2升級到3.2.2的事情,主要先把明確的runtime語法錯誤與deprecate item處理好,這部分內容可以參考: link 。 直到最近才發現,透過SeleniumLibrary執行Choose File去上傳檔案的動作,會導致測試案例timeout。本篇文章主要分享心路歷程與解決方法,我也送了一條issue給robot framework: link 。 我的環境如下: RobotFramework: 3.2.2 Selenium: 3.141.0 SeleniumLibrary: 3.3.1 Remote Selenium Version: selenium-server-standalone-3.141.59 首先並非所有Choose File的動作都會hang住,有些測試案例是可以執行的,但是上傳一個作業系統ISO檔案一定會發生問題。後來我透過wireshark去比對新舊版本的上傳動作,因為我使用 Remote Selenium ,所以Selenium會先把檔案透過REST API發送到Remote Selenium Server上。從下圖我們可以發現,在3.2.2的最後一個TCP封包,比3.1.2大概少了500個bytes。 於是就開始了我trace code之路。包含SeleniumLibrary產生要送給Remote Selenium Server的request內容,還有HTTP Content-Length的計算,我都確認過沒有問題。 最後發現問題是出在socket API的使用上,就是下圖的這支code: 最後發現可能因為開始使用nio的方式送資料,但沒處理到尚未送完的資料內容,而導致發生問題。加一個loop去做計算就可以解決了。 最後我有把解法提供給robot framework官方,在他們出新的版本之前,我是將改完的_socket.py放在我們自己的Lib底下,好讓我們測試可以正常進行。(shutil.py應該也是為了解某個bug而產生的樣子..)

Windows DLL - 32-bit dll with 64-bit driver

前言 在64-bit作業系統上所使用的驅動程式,一定是64-bit,然而應用程式卻可能是32或64-bit。當32-bit應用程式傳值給驅動程式時是有可能會發生溢位的。主要原因是32與64-bit指標所佔用記憶體長度的不同。接下來我將透過Reference 1中的程式PhyMem,來告訴大家問題在哪與如何修改。(最後改完的程式碼恕我不提供) PhyMem介紹 這是一個中國人寫的程式。作用與WinIO相同,可以存取windows的io port與physical memory。這個程式包含pmdll、driver與test三個專案,分別產生dll、sys與exe。作者僅提供32-bit的版本,但只要修改編譯設定就可以讓它產生出64-bit的artifact。但如同我前言所說,如果你是32-bit的dll要存取64的sys該怎麼辦? 可以規定User在64-bit的OS用64-bit的應用程式就好了阿! 但是將一個32-bit應用程式改為64-bit的有這麼簡單嗎? 除此之外,中間傳遞的資料型態也會影響到正常功能。 設定driver專案 我開發環境是VC2008與DDK6000,下載Reference1的專案是無法直接編譯的,可以參考我的設定去修改編譯、連結參數。輸出檔可以看個人需求,根據32或64命名,或者是用同一個檔案名稱。 32-bit C/C++ > 一般 > 其它Include目錄($(DDKROOT)為設定於環境變數的DDK安裝目錄): $(DDKROOT)\inc\ddk";"$(DDKROOT)\inc\api";"$(DDKROOT)\inc\crt";"$(DDKROOT)\inc\crt\gl";"$(DDKROOT)\inc\crt\sys" 連結器 > 一般 > 其它程式庫目錄: $(DDKROOT)\lib\wnet\i386。 連結器 > 資訊清單檔: 將產生資訊清單與UAC選擇否,因為這不適用於driver。 連結器 > 進階 > 隨機化的基底位置: 選擇預設。 64-bit Reference1僅提供32-bit設定。64-bit可在建置>組態管理員中,新增x64平台,而設定檔可從win32複製過來修...