跳到主要內容

第一次寫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

延伸閱讀

標籤：

留言

張貼留言

這個網誌中的熱門文章

Show NIC selection when setting the network command with the device option

 Problem  在answer file中設定網卡名稱後，安裝時會停在以下畫面: 所使用的command參數如下: network --onboot = yes --bootproto =dhcp --ipv6 =auto --device =eth1 Diagnostic Result 這樣的參數，以前試驗過是可以安裝完成的。因此在發生這個問題後，我檢查了它的debug console: 從console得知，eth1可能是沒有連接網路線或者是網路太慢而導致的問題。後來和Ivy再三確認，有問題的是有接網路線的網卡，且問題是發生在activate階段: Solution 我想既然有retry應該就有次數或者timeout限制，因此發現在Anaconda的說明文件中( link )，有提到dhcptimeout這個boot參數。看了一些人的使用範例，應該是可以直接串在isolinux.cfg中，如下: default linux ksdevice = link ip =dhcp ks =cdrom: / ks.cfg dhcptimeout = 90 然而我在RHEL/CentOS 6.7與6.8試驗後都無效。 因此我就拿了顯示的錯誤字串，問問Google大師，想找一下Anaconda source code來看一下。最後找到別人根據Anaconda code修改的版本: link ，關鍵在於setupIfaceStruct函式中的setupIfaceStruct與readNetConfig: setupIfaceStruct: 會在dhcp時設定dhcptimeout。 readNetConfig: 在writeEnabledNetInfo將timeout寫入dhclient config中；在wait_for_iface_activation內會根據timeout做retry。 再來從log與code可以得知，它讀取的檔案是answer file而不是boot command line。因此我接下來的測試，就是在answer file的network command上加入dhcptimeout: network --onboot = yes --bootproto =dhcp --ipv6 =auto --device =eth1 --dhcptimeo
張貼留言
閱讀完整內容

解決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而產生的樣子..)
張貼留言
閱讀完整內容

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中，不可或缺的東西就是Unattended installation。以Unattended installation來說，我們可以選擇透過Installer的silent mode安裝，也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法，教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數，除了可以直接上官網搜尋Installation User Guide以外，也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多，以我們需求來說，我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =
張貼留言
閱讀完整內容